清单文件——activity-alias

activity-alias

语法(SYNTAX):

<activity-aliasAndroid: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>

被包含于(CONTAINED IN):

<application>

能够包含的元素(CAN CONTAIN):

  • <intent-filter>
  • <meta-data>

说明(DESCRIPTION):

这个元素用于给targetActivity属性所指定Activity设定一个别名,目标Activity必须跟别名Activity在同一个应用程序中,并且这个Activity必须在别名之前被声明。

别名会作为一个独立的实体来代表目标Activity。它能够有自己的Intent过滤器设置,而不是目标Activity自己的Intent过滤器,通过别名和系统处理别名的方式来判断哪个Intent对象能够激活目标。例如:别名中的Intent过滤器可以指定“android.intent.action.MAIN”和“android.intent.category.LAUNCHER”标记,这样即使在目标Activity的过滤器上没有指定这些标记,也会让它在应用的启动器窗口中表示。

除了targetActivity属性以外,<activity-alias>的其他属性是<activity>属性的一个子集。对于子集中的属性,不会把目标Activity中所设置的任何值转交给别名Activity。但是,对于子集中所没有的属性,则给目标Activity所设置的值也会应用到别名Activity。

属性(ATTRIBUTES)

  • android:enabled

    这个属性用于设定系统能否通过这个别名来实例化目标Activity,如果设置为true,则可以实例化,否则不能实例化。默认值是true。

    <application>元素有它自己的enabled属性,这个属性会应用给所有的应用程序组件,包括Activity别名。<application><activity-alias>属性都必须是true,这样系统才能够通过别名来实例化目标Activity。如果其中之一是false,那么别名就不会起作用。

  • android:exported

    这个属性用于设定其他的应用程序组件能否通过这个别名来启动目标Activity,如果设置为true,则能够启动,否则不能启动。如果设定为false,则目标Activity只能由与别名相同的应用程序组件或具有相同用户ID的应用程序通过别名来启动。

    它的默认值依赖与别名是否包含了Intent过滤器,如果没有过滤器,则意味着这个Activity只能通过确切的别名名称来调用别名Activity,隐含的意思是这个别名只能在应用程序的内部使用(因为其他人不知道它的名称)---因此默认值是false。在另外一方面,如果至少有一个过滤器,则意味着这个别名可以在外部使用---因此默认值是true。

  • android:icon

    当通过别名把目标Activity展示给用户时,使用这个属性给目标Activity设置一个图标。

  • android:label

    当通过别名把目标Activity展示给用户时,使用这个属性给目标Activity设置一个可读的标签。

  • android:name

    给别名设置一个唯一的名字。这个名字应该像一个完全限定的类名,但是不想目标Activity的名字那样,别名的名称是任意的,它不对应一个实际的类名。

  • android:permission

    设定权限的名称,客户端必须有这个权限才能启动目标Activity或通过别名来获取目标Activity以便做某些事情。如果startActivity()或startActivityForResult()方法的调用者没有被授予指定的权限,那么目标Activity就不会被激活。

    这个属性值会取代目标Activity自己所设置的任何权限。如果它没有设置,那么不需要权限就可以通过别名来激活目标Activity。

  • android:targetActivity

    这个属性用于设置通过别名所能够激活的那个Activity的名字。这个名字必须跟它前面的<activity>元素的name属性匹配。

被引入版本(INTRODUCED IN):

这个元素在API Level 1中被引入。

Copyright© 2020-2022 li-xyz 冀ICP备2022001112号-1