API Guides (Android 7.1.1) Manifest元素详解 activity-alias



Develop > API Guides > App Manifest

<activity-alias>

 

包含它的元素：

<application>

 

可包含的元素：

<intent-filter>

<meta-data>

 

说明：

activity的别名，由targetActivity属性命名。目标必须与别名在同一个应用程序中，并且必须在清单中的别名之前声明。

 

别名将目标活动呈现为独立实体。它可以有自己的一组意图过滤器，它们，而不是目标活动本身上的意图过滤器，确定哪些意图可以通过别名激活目标，以及系统如何处理别名。例如，别名上的意图过滤器可以指定“android.intent.action.MAIN”和“android.intent.category.LAUNCHER”标志，使其在应用程序启动程序中表示，即使没有任何过滤器目标活动本身设置这些标志。

 

除了targetActivity之外，<activity-alias>属性是<activity>属性的子集。对于子集中的属性，不会为目标设置的值继承到别名。但是，对于不在子集中的属性，为目标活动设置的值也适用于别名。

 

属性：

android：enabled

boolean值。是否可以由系统通过此别名实例化目标活动 - “true”（如果可以）和“false”（如果没有）。默认值为“true”。

<application>元素有自己的enabled属性，适用于所有应用程序组件，包括活动别名。 <application>和<activity-alias>属性必须都为“true”，系统才能通过别名实例化目标活动。如果其中一个为“false”，则别名不起作用。

 

 

android：exported

boolean值。其他应用程序的组件是否可以通过此别名启动目标活动 - 如果可以，则为“true”，否则为“false”。如果为“false”，则目标活动可以仅通过与具有相同用户ID的别名或应用程序相同的应用程序的组件通过别名启动。

默认值取决于别名是否包含意图过滤器。没有任何过滤器意味着只有通过指定别名的确切名称，才能通过别名调用活动。这意味着别名仅用于应用程序内部使用（因为其他人不知道其名称），因此默认值为“false”。另一方面，至少存在一个过滤器意味着别名是供外部使用的 - 因此默认值为“true”。

 

 

android：icon

drawable资源。通过别名呈现给用户时目标活动的图标。有关详细信息，请参阅<activity>元素的图标属性。

 

 

android：label

string资源。通过别名向用户提供的别名的用户可读标签。有关详细信息，请参阅<activity>元素的label属性。

 

 

android：name

string值。别名的唯一名称。名称应类似于完全限定类名。但是，与目标活动的名称不同，别名是任意的;它不指向一个实际的类。

 

 

android：permission

string值。客户端必须具有启动目标活动或通过别名使其执行某项操作的权限的名称。如果未授予startActivity（）或startActivityForResult（）的调用者指定的权限，则不会激活目标活动。

此属性替换了目标活动本身的任何权限集。如果未设置，则不需要通过别名激活目标的权限。

 

有关权限的详细信息，请参阅简介中的权限部分。

 

android：targetActivity

string值。可以通过别名激活的活动的名称。此名称必须与清单中别名前面的<activity>元素的name属性相匹配。

 

引入的版本：

API级别1

 

另请参阅：

<activity>