AndroidManifest.xml中的action和category

浏览数：138 / 时间：2015年06月11日

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

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

IntentFilter中具有和Intent对应的用于过滤Action，Data和Category的字段，一个隐式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>

</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