После того, как вы предоставили ресурс в вашем приложении (см. раздел Предоставление ресурсов), этот ресурс можно применить. Для этого необходимо создать ссылку на идентификатор ресурса. Для задания всех таких идентификаторов в вашем проекте используется класс {@code R}, который автоматически создается инструментом {@code aapt}.
Во время компиляции приложения инструмент {@code aapt} создает класс {@code R}, в котором находятся идентификаторы для всех ресурсов в каталоге {@code res/}. Для каждого типа ресурсов предусмотрен подкласс {@code R} (например, класс {@code R.drawable} для элементов дизайна), а для каждого ресурса указанного типа существует статическая целочисленная переменная (например, {@code R.drawable.icon}). Эта переменная как раз и служит идентификатором ресурса, которую можно использовать для его получения.
Несмотря на то, что в классе {@code R} находятся идентификаторы ресурсов, никогда не обращайтесь к нему для поиска идентификатора ресурса. Последний состоит из следующих компонентов:
Существует два способа доступа к ресурсу.
R.string.hello
{@code string} — это тип ресурса, а {@code hello} — это его имя. Существует множество API-интерфейсов Android, которые могут получать доступ к ресурсам, идентификаторы которых указаны в этом формате. См. раздел Доступ к ресурсам из кода.
@string/hello
{@code string} — это тип ресурса, а {@code hello} — это его имя. Этот синтаксис можно использовать в любом фрагменте ресурса XML, где ожидается значение, указанное вами в ресурсе. См. раздел Доступ к ресурсам из XML
Чтобы использовать ресурс в коде, можно передать идентификатор ресурса в виде параметра метода. Например, с помощью метода {@link android.widget.ImageView#setImageResource(int) setImageResource()} можно указать использование виджетом {@link android.widget.ImageView} ресурса {@code res/drawable/myimage.png}:
ImageView imageView = (ImageView) findViewById(R.id.myimageview); imageView.setImageResource(R.drawable.myimage);
Отдельные ресурсы также можно получать с помощью методов в классе {@link android.content.res.Resources}, экземпляр которого можно получить с помощью метода {@link android.content.Context#getResources()}.
В редких случаях может потребоваться получить доступ к исходным файлам и каталогам. В этом случае просто сохранить файлы в каталоге {@code res/} будет недостаточно, поскольку обратиться к ресурсу из папки {@code res/} можно только по его идентификатору. Вместо этого ресурсы можно сохранить в каталоге {@code assets/}.
Файлам, которые сохранены в каталоге {@code assets/}, не присваиваются идентификаторы ресурсов, поэтому вам не удастся сослаться на них с помощью класса {@code R} или из ресурсов XML. Вместо этого можно запросить файлы из каталога {@code assets/}, как в обычной файловой системе, и считать необработанные данные с помощью {@link android.content.res.AssetManager}.
Однако, если вам требуется всего лишь возможность считать необработанные данные (например, видео- или аудиофайл), сохраните требуемый файл в каталоге {@code res/raw/} и считайте поток байтов с помощью метода {@link android.content.res.Resources#openRawResource(int) openRawResource()}.
Ниже представлен синтаксис ссылки на ресурс из кода.
[<package_name>.]R.<resource_type>.<resource_name>
Дополнительные сведения о каждом типе ресурсов и порядке создания ссылок на них см. в разделе Типы ресурсов.
Существует множество методов, которые могут принимать идентификатор ресурса в виде параметра. Для получения ресурсов можно использовать методы, представленные в классе {@link android.content.res.Resources}. Можно получить экземпляр {@link android.content.res.Resources} с помощью {@link android.content.Context#getResources Context.getResources()}.
Вот некоторые примеры доступа к ресурсам из кода:
// Load a background for the current screen from a drawable resource
{@link android.app.Activity#getWindow()}.{@link
android.view.Window#setBackgroundDrawableResource(int)
setBackgroundDrawableResource}(R.drawable.my_background_image) ;
// Set the Activity title by getting a string from the Resources object, because
// this method requires a CharSequence rather than a resource ID
{@link android.app.Activity#getWindow()}.{@link android.view.Window#setTitle(CharSequence)
setTitle}(getResources().{@link android.content.res.Resources#getText(int)
getText}(R.string.main_title));
// Load a custom layout for the current screen
{@link android.app.Activity#setContentView(int)
setContentView}(R.layout.main_screen);
// Set a slide in animation by getting an Animation from the Resources object
mFlipper.{@link android.widget.ViewAnimator#setInAnimation(Animation)
setInAnimation}(AnimationUtils.loadAnimation(this,
R.anim.hyperspace_in));
// Set the text on a TextView object using a resource ID
TextView msgTextView = (TextView) findViewById(R.id.msg);
msgTextView.{@link android.widget.TextView#setText(int)
setText}(R.string.hello_message);
Внимание! Никогда не изменяйте файл {@code R.java} вручную — этот файл создается инструментом {@code aapt} во время компиляции вашего проекта. Любые внесенные в него изменения перезаписываются после следующей компиляции.
Для задания значений для некоторых атрибутов и элементов XML можно использовать ссылку на существующий ресурс. Это зачастую требуется при создании файлов макета при указании строк и изображений для виджетов.
Например, при добавлении в макет элемента {@link android.widget.Button} необходимо использовать строковый ресурс для надписи на кнопке:
<Button
android:layout_width="fill_parent"
android:layout_height="wrap_content"
android:text="@string/submit" />
Ниже представлен синтаксис ссылки на ресурс из ресурса XML.
@[<package_name>:]<resource_type>/<resource_name>
Дополнительные сведения о каждом типе ресурсов и порядке создания ссылок на них см. в разделе Типы ресурсов.
В некоторых случаях ресурс необходимо использовать в качестве значения в элементе XML (например, чтобы применить графическое изображение к виджету), однако вы также можете использовать ресурс в любом фрагменте XML, где ожидается простое значение. Например, если имеется следующий файл ресурса, включающий цветовой ресурс и строковый ресурс:
<?xml version="1.0" encoding="utf-8"?> <resources> <color name="opaque_red">#f00</color> <string name="hello">Hello!</string> </resources>
Эти ресурсы можно использовать в следующем файле макета для задания цвета текста и надписи:
<?xml version="1.0" encoding="utf-8"?>
<EditText xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="fill_parent"
android:layout_height="fill_parent"
android:textColor="@color/opaque_red"
android:text="@string/hello" />
В этом случае в ссылке на ресурс не нужно указывать имя пакета, поскольку ресурсы находятся в вашем собственном пакете. Однако для создания ссылки на системный ресурс вам потребуется указать имя пакета. Например:
<?xml version="1.0" encoding="utf-8"?>
<EditText xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="fill_parent"
android:layout_height="fill_parent"
android:textColor="@android:color/secondary_text_dark"
android:text="@string/hello" />
Примечание. Всегда используйте строковые ресурсы, поскольку ваше приложение может потребоваться перевести на другие языки. Сведения о создании альтернативных ресурсов (например, локализованных строк) представлены в разделе Предоставление альтернативных ресурсов. В разделе Локализация приведено полное руководство по локализации приложения.
Вы даже можете использовать ресурсы в XML для создания псевдонимов. Например, можно создать элемент дизайна, который будет служить псевдонимом для другого элемента дизайна:
<?xml version="1.0" encoding="utf-8"?>
<bitmap xmlns:android="http://schemas.android.com/apk/res/android"
android:src="@drawable/other_drawable" />
Это может показаться излишним, однако такой подход очень полезен при использовании альтернативных ресурсов. Узнайте подробнее о создании псевдонимов ресурсов.
С помощью ресурса атрибута стиля можно создать ссылку на значение атрибута в текущей примененной теме. Таким образом можно настраивать внешний вид элементов пользовательского интерфейса, подстраивая их под стандартные варианты элементов оформления текущей темы, вместо указания жестко заданных значений. Создание ссылки на атрибут стиля представляет собой своеобразную инструкцию «использовать стиль, заданный этим атрибутом в текущей теме».
Синтаксис для создания ссылки на атрибут стиля практически идентичен обычному формату ресурса, только в этом случае вместо символа{@code @} необходимо указать вопросительный знак ({@code ?}), а тип ресурса вообще необязательно указывать. Например:
?[<package_name>:][<resource_type>/]<resource_name>
Ниже представлен пример создания ссылки на атрибут для задания цвета текста в соответствии с «основным» цветом текста системной темы оформления:
<EditText id="text"
android:layout_width="fill_parent"
android:layout_height="wrap_content"
android:textColor="?android:textColorSecondary"
android:text="@string/hello_world" />
Здесь атрибут {@code android:textColor} служит для задания имени атрибута стиля
в текущей теме. Теперь в Android используется значение, примененное к атрибуту стиля{@code android:textColorSecondary}
в качестве значения для {@code android:textColor} в этом виджете. Поскольку инструменту для работы с системными
ресурсами известно, что в этом контексте ожидается ресурс атрибута,
вам не нужно явно указывать его тип (который должен быть
?android:attr/textColorSecondary) — тип {@code attr} можно исключить.
В Android предусмотрен ряд стандартных ресурсов, например, стилей, тем и макетов. Для
доступа к этим ресурсам укажите в ссылке на ресурс имя пакета
android. Например, в Android имеется ресурс макета, который можно использовать для
элементов списка в виджете {@link android.widget.ListAdapter}:
{@link android.app.ListActivity#setListAdapter(ListAdapter)
setListAdapter}(new {@link
android.widget.ArrayAdapter}<String>(this, android.R.layout.simple_list_item_1, myarray));
В этом примере {@link android.R.layout#simple_list_item_1} представляет собой ресурс макета, определенный платформой для элементов в виджете {@link android.widget.ListView}. Вы можете использовать его вместо создания собственных макетов для элементов списка. Дополнительные сведения представлены в руководстве для разработчиков, посвященном представлению в виде списка.