<псевдоним активности>

синтаксис:

<activity-alias android:enabled=["true" | "false"]
                android:exported=["true" | "false"]
                android:icon="drawable resource"
                android:label="string resource"
                android:name="string"
                android:permission="string"
                android:targetActivity="string" >
    ...
</activity-alias>

содержится в:

<application>

может содержать:

<intent-filter>
<meta-data>

описание:

Псевдоним действия, названный атрибутом targetActivity . Цель должна находиться в том же приложении, что и псевдоним, и быть объявлена ​​перед псевдонимом в манифесте.

Псевдоним представляет целевое действие как независимую сущность и может иметь собственный набор фильтров намерений. Они, а не фильтры намерений самой целевой активности, определяют, какие намерения могут активировать цель через псевдоним и как система обрабатывает псевдоним.

Например, фильтры намерений псевдонима могут указывать флаги "android.intent.action.MAIN" и "android.intent.category.LAUNCHER" , в результате чего он будет представлен в средстве запуска приложений, даже если ни один из фильтров в самом целевом действии установите эти флаги.

За исключением targetActivity , атрибуты <activity-alias> являются подмножеством атрибутов <activity> . Для атрибутов в подмножестве ни одно из значений, установленных для цели, не переносится на псевдоним. Однако для атрибутов, не входящих в подмножество, значения, установленные для целевого действия, также применяются к псевдониму.

атрибуты:

android:enabled

Может ли система создать экземпляр целевого действия через этот псевдоним. "true" если это возможно, и "false" если нет. Значение по умолчанию — "true" .

Элемент <application> имеет собственный атрибут enabled , который применяется ко всем компонентам приложения, включая псевдонимы действий. Атрибуты <application> и <activity-alias> должны иметь значение "true" чтобы система могла создать экземпляр целевого действия через псевдоним. Если любой из них имеет значение "false" , псевдоним не работает.

android:exported

Могут ли компоненты других приложений запускать целевую активность через этот псевдоним. "true" если могут, и "false" если нет. Если "false" , целевая активность может быть запущена через псевдоним только компонентами того же приложения, что и псевдоним, или приложениями с тем же идентификатором пользователя.

Значение по умолчанию зависит от того, содержит ли псевдоним фильтры намерений. Отсутствие каких-либо фильтров означает, что активность можно вызвать через псевдоним, только указав точное имя псевдонима. Это означает, что псевдоним предназначен только для использования внутри приложения, поскольку другие не знают его имени. Итак, значение по умолчанию — "false" . С другой стороны, наличие хотя бы одного фильтра подразумевает, что псевдоним предназначен для внешнего использования, поэтому значение по умолчанию — "true" .

android:icon

Значок целевого действия, представленный пользователям через псевдоним. Дополнительную информацию см. в атрибуте icon элемента <activity> .

android:label

Читаемая пользователем метка псевдонима, представленная пользователям через псевдоним. Дополнительную информацию см. в атрибуте label элемента <activity> .

android:name

Уникальное имя псевдонима. Имя напоминает полное имя класса. Но, в отличие от названия целевой активности, псевдоним является произвольным. Это не относится к реальному классу.

android:permission

Имя разрешения, которое клиенты должны иметь для запуска целевого действия или получения от него каких-либо действий с использованием псевдонима. Если вызывающему объекту startActivity() или startActivityForResult() не предоставлено указанное разрешение, целевое действие не активируется.

Этот атрибут заменяет любой набор разрешений для самого целевого действия. Если оно не установлено, разрешение не требуется для активации цели через псевдоним.

Дополнительные сведения о разрешениях см. в разделе «Разрешения» в обзоре манифеста приложения.

android:targetActivity

Имя активности, которую можно активировать через псевдоним. Это имя должно соответствовать атрибуту name элемента <activity> , который предшествует псевдониму в манифесте.

представлено в:

API уровня 1

см. также:

<activity>