清单文件——intent-filter

语法(SYNTAX):

<intent-filterAndroid:icon="drawable resource"
               android:label="string resource"
               android:priority="integer">
    . . .
</intent-filter>

被包含于(CONTAINED IN):

  • <activity>
  • <activity-alias>
  • <service>
  • <receiver>

必须要包含的元素(MUST CONTAIN):

  • <action>

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

  • <category>
  • <data>

说明(DESCRIPTION):

这个元素用于指定Activity、Service或Broadcast Receiver能够响应的Intent对象的类型。Intent过滤器声明了它的父组件的能力---Activity或Service所能做的事情和Broadcast Receiver所能够处理的广播类型。它会打开组件来接收它所声明类型的Intent对象,过滤掉那些对组件没有意义的Intent对象请求。
过滤器的大多数内容是通过<action><category><data>子元素来描述的。

属性(ATTRIBUTES):

  • android:icon

    当组件要把过滤器所具有的能力展示给用户时,会使用这个属性所设置的图标来表示它的父组件(Activity、Service或Broadcast Receiver)。

    这个属性必须要引用一个包含图片定义的可绘制资源。默认值是由父组件的icon属性设置的。如果父组件没有指定一个图标,那么默认值就会使用<application>元素所设置的icon。

  • android:label

    这个属性用于给其父组件设置一个用户可读的标签。这个标签不是有其父组件设置的那个,在组件要把过滤器所具有的能力展示给用户的时候,要使用这个属性值。

    这个属性值应该引用一个字符串资源,以便它能够像用户界面中的其他字符串一样,能够被本地化。但是,为了开发应用程序的便利,也可以使用原生的字符串。

    这个属性的默认值是有它的父组件提供的。如果父组件没有指定一个标签,那么默认值就会使用由<application>元素的所设置的标签。

  • android:priority

    这个属性用于给过滤器设置一个优先级。其父组件能够通过优先级来依次处理过滤器所描述类型的Intent对象。这个属性对Activity和Broadcast Receiver对象有意义:

    • 它提供了Activity能够如何响应跟过滤器匹配的Intent对象请求的信息(相对与其他的也能响应这个Intent请求的Activity)。当一个Intent对象请求能够被多个带有不同优先级的Activity处理时,Android系统只考虑把高优先级的Intent过滤器作为潜在的Intent对象请求目标。

    • 它控制了Broadcast Receiver执行接收广播消息的顺序。高优先级的过滤器会优先调用。(这个顺序只应用与同步消息,对于异步消息会忽略优先级的设置。)

只有真正想要给接收广播消息的过滤器施加一个特定顺序,或者要强制Android来应用另外一个Activity,才会使用这个属性。

这个属性值必须是一个整数,如:100,数字越大,优先级越高。

被引入的版本(INTRODUCED IN):

API Level 1

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