首页 > 代码库 > AndroidManifest.xml中的action和category

AndroidManifest.xml中的action和category

当Intent在组件间传递时,组件如果想告知Android系统自己能够响应和处理哪些Intent,那么就需要用到IntentFilter对象。

IntentFilter对象负责过滤掉组件无法响应和处理的Intent,只将自己关心的Intent接收进来进行处理。 IntentFilter实行“白名单”管理,即只列出组件乐意接受的Intent,但IntentFilter只会过滤隐式Intent,显式的Intent会直接传送到目标组件。 Android组件可以有一个或多个IntentFilter,每个IntentFilter之间相互独立,只需要其中一个验证通过则可。除了用于过滤广播的IntentFilter可以在代码中创建外其他的IntentFilter必须在AndroidManifest.xml文件中进行声明。

 IntentFilter中具有和Intent对应的用于过滤ActionDataCategory的字段,一个隐式Intent要想被一个组件处理,必须通过这三个环节的检查。

:检查 Action (动作测试)

一条<intent-filter>元素至少应该包含一个<action>,否则任何Intent请求都不能和该<intent-filter>匹配。

如果Intent请求的Action和<intent-filter>中个某一条<action>匹配,那么该Intent就通
过了这条<intent-filter>的动作测试。

如果Intent请求或<intent-filter>中没有说明具体的Action类型,那么会出现下面两种情况。

(1) 如果<intent-filter>中没有包含任何Action类型,那么无论什么Intent请求都无法和这条<intent-filter>匹配。

(2) 反之,如果Intent请求中没有设定Action类型,那么只要<intent-filter>中包含有Action类型,这个Intent请求就将顺利地通过<intent-filter>的行为测试。

 

一个应用程序可以有多个Activity,每个Activity是同级别的,那么在启动程序时,最先启动哪个Activity呢?有些程序可能需要显示在程序列表里,有些不需要。怎么定义呢?只要xml配置文件中有这么一个intent-filter,而且里面有这个launcher,android.intent.action.MAIN决定应用程序最先启动的Activity ,android.intent.category.LAUNCHER决定应用程序是否显示在程序列表里。Main和LAUNCHER同时设定才有意义。

如果只有一个Activity,没有这两句也可以。

 

String  ADD_SHORTCUT_ACTION  动作:在系统中添加一个快捷方式。
String ALL_APPS_ACTION 动作:列举所有可用的应用。输入:无。
String ALTERNATIVE_CATEGORY 类别:说明 activity 是用户正在浏览的数据的一个可选操作。
String ANSWER_ACTION 动作:处理拨入的电话。
String BATTERY_CHANGED_ACTION 广播:充电状态,或者电池的电量发生变化。
String BOOT_COMPLETED_ACTION 广播:在系统启动后,这个动作被广播一次(只有一次)。
String BROWSABLE_CATEGORY 类别:能够被浏览器安全使用的 activities 必须支持这个类别。
String BUG_REPORT_ACTION 动作:显示 activity 报告错误。
String CALL_ACTION 动作:拨打电话,被呼叫的联系人在数据中指定。
String CALL_FORWARDING_STATE_CHANGED_ACTION 广播:语音电话的呼叫转移状态已经改变。
String CLEAR_CREDENTIALS_ACTION 动作:清除登陆凭证 (credential)。
String CONFIGURATION_CHANGED_ACTION 广播:设备的配置信息已经改变,参见 Resources.Configuration.
Creator CREATOR 无 无
String DATA_ACTIVITY_STATE_CHANGED_ACTION 广播:电话的数据活动(data activity)状态(即收发数据的状态)已经改变。
String DATA_CONNECTION_STATE_CHANGED_ACTION 广播:电话的数据连接状态已经改变。
String DATE_CHANGED_ACTION 广播:日期被改变。
String DEFAULT_ACTION 动作:和 VIEW_ACTION 相同,是在数据上执行的标准动作。
String DEFAULT_CATEGORY 类别:如果 activity 是对数据执行确省动作(点击, center press)的一个选项,需要设置这个类别。
String DELETE_ACTION 动作:从容器中删除给定的数据。
String DEVELOPMENT_PREFERENCE_CATEGORY 类别:说明 activity 是一个设置面板 (development preference panel).
String DIAL_ACTION 动作:拨打数据中指定的电话号码。
String EDIT_ACTION 动作:为制定的数据显示可编辑界面。
String EMBED_CATEGORY 类别:能够在上级(父)activity 中运行。
String EMERGENCY_DIAL_ACTION 动作:拨打紧急电话号码。
int FORWARD_RESULT_LAUNCH 启动标记:如果这个标记被设置,而且被一个已经存在的 activity 用来启动新的 activity,已有 activity 的回复目标 (reply target) 会被转移给新的 activity。
String FOTA_CANCEL_ACTION 广播:取消所有被挂起的 (pending) 更新下载。
String FOTA_INSTALL_ACTION 广播:更新已经被确认,马上就要开始安装。
String FOTA_READY_ACTION 广播:更新已经被下载,可以开始安装。
String FOTA_RESTART_ACTION 广播:恢复已经停止的更新下载。
String FOTA_UPDATE_ACTION 广播:通过 OTA 下载并安装操作系统更新。
String FRAMEWORK_INSTRUMENTATION_TEST_CATEGORY 类别:To be used as code under test for framework instrumentation tests.
String GADGET_CATEGORY 类别:这个 activity 可以被嵌入宿主 activity (activity that is hosting gadgets)。
String GET_CONTENT_ACTION 动作:让用户选择数据并返回。
String HOME_CATEGORY 类别:主屏幕 (activity),设备启动后显示的第一个 activity。
String INSERT_ACTION 动作:在容器中插入一个空项 (item)。
String INTENT_EXTRA 附加数据:和 PICK_ACTIVITY_ACTION 一起使用时,说明用户选择的用来显示的 activity;和 ADD_SHORTCUT_ACTION 一起使用的时候,描述要添加的快捷方式。
String LABEL_EXTRA 附加数据:大写字母开头的字符标签,和 ADD_SHORTCUT_ACTION 一起使用。
String LAUNCHER_CATEGORY 类别:Activity 应该被显示在顶级的 launcher 中。
String LOGIN_ACTION 动作:获取登录凭证。
String MAIN_ACTION 动作:作为主入口点启动,不需要数据。
String MEDIABUTTON_ACTION 广播:用户按下了“Media Button”。
String MEDIA_BAD_REMOVAL_ACTION 广播:扩展介质(扩展卡)已经从 SD 卡插槽拔出,但是挂载点(mount point) 还没解除 (unmount)。
String MEDIA_EJECT_ACTION 广播:用户想要移除扩展介质(拔掉扩展卡)。
String MEDIA_MOUNTED_ACTION 广播:扩展介质被插入,而且已经被挂载。
String MEDIA_REMOVED_ACTION 广播:扩展介质被移除。
String MEDIA_SCANNER_FINISHED_ACTION 广播:已经扫描完介质的一个目录。
String MEDIA_SCANNER_STARTED_ACTION 广播:开始扫描介质的一个目录。
String MEDIA_SHARED_ACTION 广播:扩展介质的挂载被解除 (unmount),因为它已经作为 USB 大容量存储被共享。
String MEDIA_UNMOUNTED_ACTION 广播:扩展介质存在,但是还没有被挂载 (mount)。
String MESSAGE_WAITING_STATE_CHANGED_ACTION 广播:电话的消息等待(语音邮件)状态已经改变。
int MULTIPLE_TASK_LAUNCH 启动标记:和 NEW_TASK_LAUNCH 联合使用,禁止将已有的任务改变为前景任务 (foreground)。
String NETWORK_TICKLE_RECEIVED_ACTION 广播:设备收到了新的网络 "tickle" 通知。
int NEW_TASK_LAUNCH 启动标记:设置以后,activity 将成为历史堆栈中的第一个新任务(栈顶)。
int NO_HISTORY_LAUNCH 启动标记:设置以后,新的 activity 不会被保存在历史堆栈中。
String PACKAGE_ADDED_ACTION 广播:设备上新安装了一个应用程序包。
String PACKAGE_REMOVED_ACTION 广播:设备上删除了一个应用程序包。
String PHONE_STATE_CHANGED_ACTION 广播:电话状态已经改变。
String PICK_ACTION 动作:从数据中选择一个项目 (item),将被选中的项目返回。
String PICK_ACTIVITY_ACTION 动作:选择一个 activity,返回被选择的 activity 的类(名)。
String PREFERENCE_CATEGORY 类别:activity是一个设置面板 (preference panel)。
String PROVIDER_CHANGED_ACTION 广播:更新将要(真正)被安装。
String PROVISIONING_CHECK_ACTION 广播:要求 polling of provisioning service 下载最新的设置。
String RUN_ACTION 动作:运行数据(指定的应用),无论它(应用)是什么。
String SAMPLE_CODE_CATEGORY 类别:To be used as an sample code example (not part of the normal user experience).
String SCREEN_OFF_ACTION 广播:屏幕被关闭。
String SCREEN_ON_ACTION 广播:屏幕已经被打开。
String SELECTED_ALTERNATIVE_CATEGORY 类别:对于被用户选中的数据,activity 是它的一个可选操作。
String SENDTO_ACTION 动作:向 data 指定的接收者发送一个消息。
String SERVICE_STATE_CHANGED_ACTION 广播:电话服务的状态已经改变。
String SETTINGS_ACTION 动作:显示系统设置。输入:无。
String SIGNAL_STRENGTH_CHANGED_ACTION 广播:电话的信号强度已经改变。
int SINGLE_TOP_LAUNCH 启动标记:设置以后,如果 activity 已经启动,而且位于历史堆栈的顶端,将不再启动(不重新启动) activity。
String STATISTICS_REPORT_ACTION 广播:要求 receivers 报告自己的统计信息。
String STATISTICS_STATE_CHANGED_ACTION 广播:统计信息服务的状态已经改变。
String SYNC_ACTION 动作:执行数据同步。
String TAB_CATEGORY 类别:这个 activity 应该在 TabActivity 中作为一个 tab 使用。
String TEMPLATE_EXTRA 附加数据:新记录的初始化模板。
String TEST_CATEGORY 类别:作为测试目的使用,不是正常的用户体验的一部分。
String TIMEZONE_CHANGED_ACTION 广播:时区已经改变。
String TIME_CHANGED_ACTION 广播:时间已经改变(重新设置)。
String TIME_TICK_ACTION 广播:当前时间已经变化(正常的时间流逝)。
String UMS_CONNECTED_ACTION 广播:设备进入 USB 大容量存储模式。
String UMS_DISCONNECTED_ACTION 广播:设备从 USB 大容量存储模式退出。
String UNIT_TEST_CATEGORY 类别:应该被用作单元测试(通过 test harness 运行)。
String VIEW_ACTION 动作:向用户显示数据。
String WALLPAPER_CATEGORY 类别:这个 activity 能过为设备设置墙纸。
String WALLPAPER_CHANGED_ACTION 广播:系统的墙纸已经改变。
String WALLPAPER_SETTINGS_ACTION 动作:显示选择墙纸的设置界面。输入:无。
String WEB_SEARCH_ACTION 动作:执行 web 搜索。
String XMPP_CONNECTED_ACTION 广播:XMPP 连接已经被建立。
String XMPP_DISCONNECTED_ACTION 广播:XMPP 连接已经被断开。

注:在 activity定义要如下应用过滤

<intent-filter>

    <action android:name="android.intent.action.MAIN" />

</intent-filter> 

二:检查 Data(数据测试)

同Action一样,Intentfilter中的Data部分也可以是一个或者多个,而且可以没有。每个Data包含的内容为URL和数据类型,进行Data检查时主要也是对这两点进行比较,比较规则: 如果一个Intent对象没有设置Data,只有Intentfilter也没有设置Data时才可通过检查。 如果一个Intent对象包含URI,但不包含数据类型:仅当Intentfilter也不指定数据类型,同时它们的URI匹配,才能通过检测。 如果一个Intent对象包含数据类型,但不包含URI:仅当Intentfilter也没指定URL,而只包含数据类型且与Intent相同,才通过检测。 如果一个Intent对象既包含URI,也包含数据类型(或数据类型能够从URI推断出),只有当其数据类型匹配Intentfilter中的数据类型,并且通过了URL检查时,该Intent对象才能通过检查。

   其中URL由四部分组成它有四个属性scheme、host、port、path对应于URI的每个部分。

       例如:content://com.wjr.example1:121/files

       scheme部分:content

       host部分:com.wjr.example1

       port部分:121

       path部分:files

    host和port部分一起构成URI的凭据(authority),如果host没有指定,那port也会被忽略。

    这四个属性是可选的,但他们之间并不是完全独立的。要让authority有意义,scheme必须要指定。要让path有意思,scheme和authority必须指定。 Intentfilter中的path可以使用通配符来匹配path字段,Intent和Intentfilter都可以用通配符来指定MIME类型。

 三:检查 Category Intentfilter(类别测试)

可以设置多个Category,Intent中也可以含有多个Category,只有Intent中的所有Category都能匹配到Intentfilter中的Category,Intent才能通过检查。也就是说,如果Intent中的Category集合是Intentfilter中Category的集合的子集时,Intent才能通过检查。如果Intent中没有设置Category,则它能通过所有Intentfilter的Category检查。 如果一个Intent能够通过不止一个组件的Intentfilter,用户可能会被问那个组件被激活。如果没有目标找到,会产生一个异常。

CATEGORY_ALTERNATIVE 设置这个activity是否可以被认为是用户正在浏览的数据的一个可选择的action
CATEGORY_APP_BROWSER 和ACTION_MAIN一起使用,用来启动浏览器应用程序
CATEGORY_APP_CALCULATOR 和ACTION_MAIN一起使用,用来启动计算器应用程序
CATEGORY_APP_CALENDAR 和ACTION_MAIN一起使用,用来启动日历应用程序
CATEGORY_APP_CONTACTS 和ACTION_MAIN一起使用,用来启动联系人应用程序
CATEGORY_APP_EMAIL 和ACTION_MAIN一起使用,用来启动邮件应用程序
CATEGORY_APP_GALLERY 和ACTION_MAIN一起使用,用来启动图库应用程序
CATEGORY_APP_MAPS 和ACTION_MAIN一起使用,用来启动地图应用程序
CATEGORY_APP_MARKET 这个activity允许用户浏览和下载新的应用程序
CATEGORY_APP_MESSAGING 和ACTION_MAIN一起使用,用来启动短信应用程序
CATEGORY_APP_MUSIC 和ACTION_MAIN一起使用,用来启动音乐应用程序
CATEGORY_BROWSABLE 能够被浏览器安全调用的activity必须支持这个category
CATEGORY_DEFAULT 设置这个activity对于默认的action是否是一个可选的
CATEGORY_EMBED 可以运行在父activity容器内
CATEGORY_HOME 主activity,当应用程序启动时,它是第一个显示的activity
CATEGORY_LAUNCHER 应该在上层的启动列表里显示
CATEGORY_MONKEY 这个activity可能被monkey或者其他的自动测试工具执行
CATEGORY_OPENABLE 用来指示一个GET_CONTENT意图只希望ContentResolver.openInputStream能够打开URI
CATEGORY_PREFERENCE 这个activity是一个选项卡
CATEGORY_SAMPLE_CODE 作为一个简单的代码示例使用(一般情况下不使用)
CATEGORY_SELECTED_ALTERNATIVE 设置这个activity是否可以被认为是用户当前选择的数据的一个可选择的action
CATEGORY_TAB 想要在已有的TabActivity内部作为一个Tab使用
CATEGORY_TEST 供测试使用(一般情况不使用)
CATEGORY_UNIT_TEST 联合测试使用

“android.intent.category.DEFAULT”的目的是什么?

要弄清楚这个问题,首先需要弄明白什么是implicit(隐藏) intent什么是explicit(明确) intent。

Explicit Intent明确的指定了要启动的Acitivity ,比如以下Java代码:
Intent intent= new Intent(this, B.class)

Implicit Intent没有明确的指定要启动哪个Activity ,而是通过设置一些Intent Filter来让系统去筛选合适的Acitivity去启动。

intent到底发给哪个activity,需要进行三个匹配,一个是action,一个是category,一个是data。

理论上来说,如果intent不指定category,那么无论intent filter的内容是什么都应该是匹配的。但是,如果是implicit intent,android默认给加上一个CATEGORY_DEFAULT,这样的话如果intent filter中没有android.intent.category.DEFAULT这个category的话,匹配测试就会失败。所以,如果你的 activity支持接收implicit intent的话就一定要在intent filter中加入android.intent.category.DEFAULT。

例外情况是:android.intent.category.MAIN和android.intent.category.LAUNCHER的filter中没有必要加入android.intent.category.DEFAULT,当然加入也没有问题。

我们定义的activity如果接受implicit intent的话,intent filer就一定要加上android.intent.category.DEFAULT这个category。


来自另一篇文章的解释:

在写 AndroidManifest.xml 的时候,一直没有搞明白,什么时候要给 Activityandroid.intent.category.DEFAULT 过滤器,现在才明白。

--------------------------------------------------------------------------------
Android treats all implicit intents passed to startActivity() as if they contained at least one category: "android.intent.category.DEFAULT" (the CATEGORY_DEFAULT constant). Therefore, activities that are willing to receive implicit intents must include "android.intent.category.DEFAULT" in their intent filters
--------------------------------------------------------------------------------

意思是说,每一个通过 startActivity() 方法发出的隐式 Intent 都至少有一个 category,就是 "android.intent.category.DEFAULT",所以只要是想接收一个隐式 Intent 的 Activity 都应该包括 "android.intent.category.DEFAULT" category,不然将导致 Intent 匹配失败。

从上面的论述还可以获得以下信息:
1、一个 Intent 可以有多个 category,但至少会有一个,也是默认的一个 category。
2、只有 Intent 的所有 category 都匹配上,Activity 才会接收这个 Intent。

Android中的category大全
Api Level 3(SDK 1.5)和Api Level 4(SDK 1.6):
Xml代码
android.intent.category.ALTERNATIVE
android.intent.category.BROWSABLE
android.intent.category.DEFAULT
android.intent.category.DEVELOPMENT_PREFERENCE
android.intent.category.EMBED
android.intent.category.HOME
android.intent.category.INFO
android.intent.category.LAUNCHER
android.intent.category.MONKEY
android.intent.category.OPENABLE
android.intent.category.PREFERENCE
android.intent.category.SELECTED_ALTERNATIVE
android.intent.category.TAB

Api Level 5(SDK 2.0)增加的:
Xml代码
android.intent.category.CAR_DOCK
android.intent.category.DESK_DOCK
Api Level 6和7没有变化。
Api Level 8(SDK 2.2)增加的:
Xml代码
android.intent.category.CAR_MODE