<alias-aktywności>

<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>

Alias przedstawia docelową aktywność jako niezależną encję i może mieć własny zestaw filtrów intencji. To one, a nie filtry intencji dla samej docelowej aktywności, określają, które intencje mogą aktywować cel za pomocą aliasu i jak system ma go traktować.

Na przykład filtry intencji w aliasie mogą określać flagi "android.intent.action.MAIN" i "android.intent.category.LAUNCHER", przez co będą one reprezentowane w Menu z aplikacjami, mimo że żaden z filtrów aktywności docelowej nie ustawia tych flag.

Z wyjątkiem atrybutu targetActivity atrybuty <activity-alias> są podzbiorem atrybutów <activity>. W przypadku atrybutów w podzbiorze żadne wartości ustawione dla elementu docelowego nie są przenoszone do aliasu. Jednak w przypadku atrybutów, których nie ma w podzbiorze, wartości ustawione dla aktywności docelowej mają również zastosowanie do aliasu.

android:enabled

Czy system może utworzyć instancję docelowej aktywności za pomocą tego aliasu. "true", jeśli może, lub "false", jeśli nie. Wartością domyślną jest "true".

Element <application> ma własny atrybut enabled, który ma zastosowanie do wszystkich komponentów aplikacji, w tym aliasów aktywności. Aby system mógł utworzyć instancję docelowej aktywności za pomocą aliasu, zarówno atrybut <application>, jak i <activity-alias> muszą mieć wartość "true". Jeśli jedna z tych wartości ma wartość "false", alias nie będzie działać.

android:exported

Czy komponenty innych aplikacji mogą uruchamiać docelową aktywność za pomocą tego aliasu. "true", jeśli można, lub "false", jeśli nie. Jeśli "false", docelowa aktywność może zostać uruchomiona za pomocą aliasu tylko przez komponenty tej samej aplikacji co alias lub aplikacje z tym samym identyfikatorem użytkownika.

Wartość domyślna zależy od tego, czy alias zawiera filtry intencji. Brak filtrów oznacza, że działanie można wywołać tylko z poziomu aliasu przez podanie jego dokładnej nazwy. Oznacza to, że alias jest przeznaczony tylko do użytku wewnętrznego w aplikacji, ponieważ inni nie znają jego nazwy. Wartość domyślna to "false". Z drugiej strony obecność co najmniej 1 filtra oznacza, że alias jest przeznaczony do użytku zewnętrznego, więc wartość domyślna to "true".

android:icon

Ikona docelowej aktywności wyświetlanej użytkownikom za pomocą aliasu. Więcej informacji znajdziesz w atrybucie icon elementu <activity>.

android:label

Czytelna dla użytkownika etykieta aliasu wyświetlanej użytkownikom za pomocą aliasu. Więcej informacji znajdziesz w atrybucie label elementu <activity>.

android:name

Unikalna nazwa aliasu. Nazwa przypomina pełną i jednoznaczną nazwę klasy. W przeciwieństwie do docelowej aktywności nazwa aliasu jest jednak dowolna. Nie odnosi się on do żadnej klasy.

android:permission

Nazwa uprawnienia, które klient musi mieć do uruchomienia docelowej aktywności lub uzyskania do niej wykonania przy użyciu aliasu. Jeśli element wywołujący startActivity() lub startActivityForResult() nie otrzyma określonego uprawnienia, docelowa aktywność nie zostanie aktywowana.

Ten atrybut uzupełnia wszystkie uprawnienia ustawione dla aktywności docelowej. Jeśli nie jest ustawiona, uprawnienie nie jest potrzebne do aktywowania środowiska docelowego za pomocą aliasu.

Więcej informacji o uprawnieniach znajdziesz w sekcji Uprawnienia w omówieniu pliku manifestu aplikacji.

android:targetActivity

Nazwa aktywności, którą można aktywować za pomocą aliasu. Ta nazwa musi pasować do atrybutu name elementu <activity>, który poprzedza alias w pliku manifestu.