<alias-aktywności>
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
- składnia:
<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>- zawarte w:
<application>- mogą zawierać:
<intent-filter>
<meta-data>- description:
- Alias dla aktywności nazwanej przez
targetActivity
. Miejsce docelowe musi znajdować się w tej samej aplikacji co
i zadeklarowano przed aliasem w pliku manifestu.
Alias przedstawia działanie docelowe jako niezależny podmiot i może mieć własny zbiór intencji
filtry. To oni, a nie
filtry intencji na samą aktywność docelową, określić, które intencje
możesz aktywować element docelowy za pomocą aliasu,
traktuje alias.
Na przykład filtry intencji w aliasie mogą
podaj "android.intent.action.MAIN"
i "android.intent.category.LAUNCHER"” i sprawia, że
może być widoczna w programie uruchamiającym aplikacje, mimo że żaden z
same filtry docelowej aktywności ustawiają te flagi.
Z wyjątkiem: targetActivity, <activity-alias>
są podzbiorem atrybutów <activity>.
W przypadku atrybutów w podzbiorze żadna z wartości ustawionych dla elementu docelowego nie jest przenoszona
do aliasu. Jeśli jednak atrybuty nie należą do tego podzbioru, wartości ustawione dla
działanie docelowe ma również zastosowanie do aliasu.
- atrybuty:
android:enabled- Czy system może utworzyć wystąpienie działania docelowego za pomocą
ten alias.
"true", jeśli może być, lub "false", jeśli może być.
Wartością domyślną jest "true".
Element <application> ma swój własny element
Atrybut enabled, który ma zastosowanie do wszystkich
komponenty aplikacji, w tym aliasy aktywności.
<application> i <activity-alias>
aby system mógł utworzyć instancję, oba atrybuty muszą mieć wartość "true"
docelowej aktywności za pomocą aliasu. Jeśli jeden z tych elementów to "false", alias
nie działa.
android:exported- Czy komponenty innych aplikacji mogą uruchamiać docelowe działanie
za pomocą tego aliasu.
"true", jeśli może, lub "false", jeśli nie.
Jeśli "false", docelowe działanie może zostać uruchomione za pomocą aliasu tylko przez
komponentów tej samej aplikacji co alias lub aplikacji z tym samym identyfikatorem użytkownika.
Wartość domyślna zależy od tego, czy alias zawiera filtry intencji.
brak jakichkolwiek filtrów oznacza, że działanie może być wywoływane z użyciem aliasu;
podając dokładną nazwę aliasu. Oznacza to, że alias
jest przeznaczony wyłącznie do użytku wewnętrznego w aplikacji, ponieważ inni użytkownicy nie znają jego nazwy.
Dlatego wartość domyślna to "false".
Z drugiej strony, obecność co najmniej jednego 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 przez alias.
Więcej informacji znajdziesz w opisie elementu
<activity>
icon.
android:label- Czytelna dla użytkownika etykieta aliasu, gdy jest wyświetlana przez alias.
Więcej informacji znajdziesz w opisie elementu
<activity>
label.
android:name- Unikalna nazwa aliasu. Nazwa przypomina pełne
kwalifikowana nazwa zajęć. W przeciwieństwie do nazwy aktywności,
nazwa aliasu jest dowolna. Nie odnosi się on do rzeczywistych klas.
android:permission- Nazwa uprawnienia, które musi mieć klient, aby uruchomić działanie docelowe
lub używać aliasu. Jeśli rozmówca
startActivity() lub
startActivityForResult()
nie otrzymał określonego uprawnienia, docelowa aktywność nie została aktywowana.
Ten atrybut uzupełnia wszelkie uprawnienia ustawione dla samej aktywności docelowej. Jeśli
nie jest ustawiona, uprawnienia nie są potrzebne do aktywowania elementu docelowego za pomocą aliasu.
Więcej informacji o uprawnieniach:
Uprawnienia
w omówieniu pliku manifestu aplikacji.
android:targetActivity- Nazwa aktywności, którą można aktywować przy użyciu aliasu.
Ta nazwa musi być zgodna z atrybutem
name obiektu
<activity> element poprzedzający
alias w pliku manifestu.
- wprowadzone w:
- Poziom API 1
- zobacz też:
<activity>
Treść strony i umieszczone na niej fragmenty kodu podlegają licencjom opisanym w Licencji na treści. Java i OpenJDK są znakami towarowymi lub zastrzeżonymi znakami towarowymi należącymi do firmy Oracle lub jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-07-27 UTC.
[[["Łatwo zrozumieć","easyToUnderstand","thumb-up"],["Rozwiązało to mój problem","solvedMyProblem","thumb-up"],["Inne","otherUp","thumb-up"]],[["Brak potrzebnych mi informacji","missingTheInformationINeed","thumb-down"],["Zbyt skomplikowane / zbyt wiele czynności do wykonania","tooComplicatedTooManySteps","thumb-down"],["Nieaktualne treści","outOfDate","thumb-down"],["Problem z tłumaczeniem","translationIssue","thumb-down"],["Problem z przykładami/kodem","samplesCodeIssue","thumb-down"],["Inne","otherDown","thumb-down"]],["Ostatnia aktualizacja: 2025-07-27 UTC."],[],[],null,["# <activity-alias\u003e\n\nsyntax:\n:\n\n ```xml\n \u003cactivity-alias android:enabled=[\"true\" | \"false\"]\n android:exported=[\"true\" | \"false\"]\n android:icon=\"drawable resource\"\n android:label=\"string resource\"\n android:name=\"string\"\n android:permission=\"string\"\n android:targetActivity=\"string\" \u003e\n ...\n \u003c/activity-alias\u003e\n ```\n\ncontained in:\n: [\u003capplication\u003e](/guide/topics/manifest/application-element)\n\ncan contain:\n: [\u003cintent-filter\u003e](/guide/topics/manifest/intent-filter-element)\n\n [\u003cmeta-data\u003e](/guide/topics/manifest/meta-data-element)\n\ndescription:\n: An alias for an activity, named by the `targetActivity`\n attribute. The target must be in the same application as the\n alias and declared before the alias in the manifest.\n\n\n The alias presents the target activity as an independent entity, and can have its own set of intent\n filters. They, rather than the\n intent filters on the target activity itself, determine which intents\n can activate the target through the alias and how the system\n treats the alias.\n\n For example, the intent filters on the alias might\n specify the [\"android.intent.action.MAIN\"](/reference/android/content/Intent#ACTION_MAIN)\n and [\"android.intent.category.LAUNCHER\"](/reference/android/content/Intent#CATEGORY_LAUNCHER)\" flags, causing it to\n be represented in the application launcher, even though none of the\n filters on the target activity itself set these flags.\n\n\n With the exception of `targetActivity`, `\u003cactivity-alias\u003e`\n attributes are a subset of [\u003cactivity\u003e](/guide/topics/manifest/activity-element) attributes.\n For attributes in the subset, none of the values set for the target carry over\n to the alias. However, for attributes not in the subset, the values set for\n the target activity also apply to the alias.\n\nattributes:\n:\n\n `android:enabled`\n : Whether the target activity can be instantiated by the system through\n this alias. `\"true\"` if it can be, and `\"false\"` if not.\n The default value is `\"true\"`.\n\n\n The [\u003capplication\u003e](/guide/topics/manifest/application-element) element has its own\n [enabled](/guide/topics/manifest/application-element#enabled) attribute that applies to all\n application components, including activity aliases. The\n `\u003capplication\u003e` and `\u003cactivity-alias\u003e`\n attributes must both be `\"true\"` for the system to be able to instantiate\n the target activity through the alias. If either is `\"false\"`, the alias\n doesn't work.\n\n `android:exported`\n : Whether the components of other applications can launch the target activity\n through this alias. `\"true\"` if they can, and `\"false\"` if not.\n If `\"false\"`, the target activity can be launched through the alias only by\n components of the same application as the alias or applications with the same user ID.\n\n\n The default value depends on whether the alias contains intent filters. The\n absence of any filters means that the activity can be invoked through the alias\n only by specifying the exact name of the alias. This implies that the alias\n is intended only for application-internal use, since others don't know its name.\n So, the default value is `\"false\"`.\n On the other hand, the presence of at least one filter implies that the alias\n is intended for external use, so the default value is `\"true\"`.\n\n `android:icon`\n : An icon for the target activity when presented to users through the alias.\n For more information, see the [\u003cactivity\u003e](/guide/topics/manifest/activity-element) element's\n [icon](/guide/topics/manifest/activity-element#icon) attribute.\n\n `android:label`\n : A user-readable label for the alias when presented to users through the alias.\n For more information, see the [\u003cactivity\u003e](/guide/topics/manifest/activity-element) element's\n [label](/guide/topics/manifest/activity-element#label) attribute.\n\n \u003cbr /\u003e\n\n `android:name`\n\n : A unique name for the alias. The name resembles a fully qualified class name. But, unlike the name of the target activity, the alias name is arbitrary. It doesn't refer to an actual class. \u003cbr /\u003e\n\n `android:permission`\n : The name of a permission that clients must have to launch the target activity\n or get it to do something using the alias. If a caller of\n [startActivity()](/reference/android/content/Context#startActivity(android.content.Intent)) or\n [startActivityForResult()](/reference/android/app/Activity#startActivityForResult(android.content.Intent, int))\n isn't granted the specified permission, the target activity isn't activated.\n\n This attribute supplants any permission set for the target activity itself. If\n it isn't set, a permission isn't needed to activate the target through the alias.\n\n\n For more information about permissions, see the\n [Permissions](/guide/topics/manifest/manifest-intro#perms)\n section in the app manifest overview.\n\n `android:targetActivity`\n : The name of the activity that can be activated through the alias.\n This name must match the `name` attribute of an\n [\u003cactivity\u003e](/guide/topics/manifest/activity-element) element that precedes\n the alias in the manifest.\n\n \u003cbr /\u003e\n\nintroduced in:\n: API level 1\n\nsee also:\n: [\u003cactivity\u003e](/guide/topics/manifest/activity-element)"]]
