android intentfilter 理解

隐式启动Activity的intent到底发给哪个activity，需要进行三个匹配，一个是action，一个是category，一个是data，可以是全部或部分匹配

同样适用于Service和BroadcastReceiver,下面是以Activity为例


MainActivity.java --主Activity

TestActivity.java --需要隐式启动的Activity


(1) 根据Action和Category来进行匹配

<activity android:name=".TestActivity" android:label="TestActivity">

<intent-filter >

<action android:name="cc.android/myaction.leo"/>

<category android:name="android.intent.category.DEFAULT"/>

</intent-filter>

</activity>



在MainActivity.java里启动它:

intent.setAction( "cc.android/myaction.leo");

//不加下面这行也行，因为intent的这个属性默认值即系Intent.CATEGORY_DEFAULT

intent.addCategory(Intent.CATEGORY_DEFAULT);

startActivity( intent );

总结:

a.在某个Activity里用startActivity()方法发送一个intent，这个intent设定了一些条件，比如用方法setAction(),addCategory()设定了两个属性,

发送了这个intent之后，android会去系统里保存的MainManifest.xml清单（假设这个系统存放全部apk清单的文件为MainManifest.xml）里查找符合这两个属性的activity，然后启动它。

查找过程是怎样的呢？

我猜测:在安装某个apk的时候，android系统会把这个apk的清单文件里内容复制一份至系统的某个清单文件里（假如这个系统存放全部apk清单的文件为MainManifest.xml）

当某个Activity用startActivity(intentOther)方法向系统发送了一个intent(假如为intentOther)，那么android系统会去查找这个MainManifest.xml里注册的<intent-filter >属性，

查找到符合这个 intentOther 的就启动这个Activity，如果有多个这样的Activity符合条件的话，就跳出一个对话框让用户选择究竟要启动哪一个



上面那个自定义的Action字符串("cc.android/myaction.leo",当然也可以写成这样"cc.android.myaction.leo",同时AndroidManifest.xml里也要写成这样)是系统唯一的，

所以系统很容易就能匹配到。

b.任何一个需要隐式启动的Activity都必须要有这项:<category android:name="android.intent.category.DEFAULT"/>

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

c.假如有两个Activity，它们的在AndroidManifest.xml里配置如下:

<activity android:name="MyActivityOne" android:label="@string/activityOne">

<intent-filter>

<action android:name="hello.leo.liao" />

<action android:name="hello.leo.leo" />

<category android:name="android.intent.category.DEFAULT" />

</intent-filter>

</activity>



<activity android:name=".MyActivityTwo" android:label="@string/activityTwo">

<intent-filter>

<action android:name="hello.leo.liao" />

<category android:name="android.intent.category.DEFAULT" />

</intent-filter>

</activity>



在MainActivity.java里发送一个intent:

intent.setAction( "hello.leo.liao");

//不加下面这行也行，因为intent的这个属性默认值即系Intent.CATEGORY_DEFAULT

intent.addCategory(Intent.CATEGORY_DEFAULT);

startActivity( intent );



这样的话，android系统会跳出一个对话框让你选择启动哪一个Activity（MyActivityOne还是MyActivityTwo）

如果把上面的intent.setAction( "hello.leo.liao");改为intent.setAction( "hello.leo.leo");的话，就自动匹配到MyActivityOne

就是说如果category和action都相同的话，会跳出一个对话框让用户选择要启动哪一个activity;

如果category相同，而action不相同，就可以匹配到相应的activity

d.单单靠添加addCategory属性不能匹配，如:

Intent intent = new Intent();

intent.addCategory(Intent.CATEGORY_DEFAULT);

intent.addCategory("android.intent.category.hello");

startActivity(intent);


<activity android:name=".MyActivityTwo" android:label="@string/activityTwo">

<intent-filter>

<category android:name="android.intent.category.DEFAULT" />

<category android:name="android.intent.category.hello"></category>

</intent-filter>

</activity>

e.当匹配不上任何Activity的话，会发生异常，跳出对话框:很抱歉...某某应用程序意外停止，请重试。

f.Service和BroadcastReceiver 同理

(2) 根据Action和Data匹配

<activity android:name=".MyActivityTwo" android:label="@string/activityTwo">

<intent-filter>

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

<category android:name="android.intent.category.DEFAULT"></category>

<data android:scheme="x-id"></data>

</intent-filter>

</activity>



//Uri uri = Uri.parse("x-id://www.google.com/getDetails?id=123");//这个也可以

//Uri uri = Uri.parse("x-id");//这个不行

//Uri uri = Uri.parse("x-id://");这个可以

Uri uri = Uri.parse("x-id:");//这个可以

Intent in = new Intent();

in.setAction("android.intent.action.leo");//去掉这行不行,单靠data不能匹配

in.addCategory(Intent.CATEGORY_DEFAULT);//可以去掉这行，因为intent的默认category值即系Intent.CATEGORY_DEFAULT

in.setData(uri);//去掉这行不行

startActivity(in);



总结：如果在AndroidManifest.xml里面指定了<data>这行，那么，需要匹配到它的话，在代码里必须要设置intent的data，如上面的in.setData(uri)

Data的语法:

<data android:host="string"

android:mimeType="string"

android:path="string"

android:pathPattern="string"

android:pathPrefix="string"

android:port="string"

android:scheme="string" />



Uri的格式:scheme://host:port/path or pathPrefix or pathPattern



如果scheme没有指定，那其它的属性均无效；

如果host没有指定，那么port,path,pathPrefix,pathPattern均无效;

如果在manifest里这样写:<data android:scheme="something" android:host="project.example.com" />

那么Uri uri = Uri.parse("something://project.example.com"); 才可以匹配

再如:

<data android:scheme="something" android:host="project.example.com" android:port="80"/>

等同于这样写:

<data android:scheme="something"/>

<data android:host="project.example.com"/>

<data android:port="80"/>

那么Uri uri = Uri.parse("something://project.example.com:80"); 才可以匹配

不知为何，下面这个不行:

<data android:scheme="content" android:host="com.example.project" android:port="200" android:path="folder/subfolder/etc"/>

Uri uri = Uri.parse("content://com.example.project:200/folder/subfolder/etc")

下面这样也不行

<data android:scheme="content" android:host="com.example.project" android:port="200" android:path="folder"/>

Uri uri = Uri.parse("content://com.example.project:200/folder")

可以有多个data,只需匹配其中一个即可

<activity android:name=".MyActivityTwo" android:label="@string/activityTwo">

<intent-filter>

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

<category android:name="android.intent.category.DEFAULT"></category>

<data android:scheme="x-id"/>

<data android:scheme="something"/>

</intent-filter>

</activity>


Intent in = new Intent();

in.setAction("android.intent.action.leo");

in.addCategory(Intent.CATEGORY_DEFAULT);

in.setData(Uri.parse("something:"));//或者用这个亦可in.setData(Uri.parse("x-id:"));

startActivity(in);

(3) 根据action和data的mimeType属性匹配

<activity android:name=".MyActivityTwo" android:label="@string/activityTwo">

<intent-filter>

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

<data android:mimeType="vnd.android.cursor.dir/vnd.google.note" />

<category android:name="android.intent.category.DEFAULT"></category>

</intent-filter>

</activity>

在java代码里这样写就可以匹配到这个activity:

Intent in = new Intent();

in.setAction("android.intent.action.VIEW");

in.addCategory(Intent.CATEGORY_DEFAULT);//可去掉,因为Category默认值即系Intent.CATEGORY_DEFAULT

in.setType("vnd.android.cursor.dir/vnd.google.note");

startActivity(in);


单靠data的mimeType属性不能匹配，就算这个mimeType是唯一的也不行(比如in.setType("leo.android.cursor.dir/vnd.google.leo");),需要有一个action配合

可以有多个mimeType,在java代码里只需匹配其中一个即可:

<activity android:name=".MyActivityTwo" android:label="@string/activityTwo">

<intent-filter>

<intent-filter>

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

<data android:mimeType="leo.android.cursor.dir/vnd.google.leo" />

<data android:mimeType="leo.android.cursor.dir/vnd.google.liao" />

<category android:name="android.intent.category.DEFAULT"></category>

</intent-filter>

</activity>

这样可以启动MyActivityTwo这个Activity:

Intent in = new Intent();

in.setAction("android.intent.action.VIEW");

in.addCategory(Intent.CATEGORY_DEFAULT);//可去掉,因为Category默认值即系Intent.CATEGORY_DEFAULT

in.setType("leo.android.cursor.dir/vnd.google.liao");

startActivity(in);

或者这样也可以启动MyActivityTwo这个Activity:

Intent in = new Intent();

in.setAction("android.intent.action.VIEW");

in.addCategory(Intent.CATEGORY_DEFAULT);//可去掉,因为Category默认值即系Intent.CATEGORY_DEFAULT

in.setType("leo.android.cursor.dir/vnd.google.leo");

startActivity(in);


scheme和mimeType只能有其中一个,下面这样通不过

AndroidManifest.xml里:

<data android:scheme="something" android:host="project.example.com"

android:port="80"

android:mimeType="leo.android.cursor.dir/vnd.google.leo" />


或

<data android:scheme="something" android:host="project.example.com"

android:port="80" />

<data android:mimeType="leo.android.cursor.dir/vnd.google.leo" />

java代码里:

匹配不上:

Intent in = new Intent();

in.setAction("android.intent.action.VIEW");

Uri uri = Uri.parse("something://project.example.com:80");

in.setData(uri);

in.setType("leo.android.cursor.dir/vnd.google.leo");

startActivity(in);



这样还是匹配不上:

Intent in = new Intent();

in.setAction("android.intent.action.VIEW");

// Uri uri = Uri.parse("something://project.example.com:80");

// in.setData(uri);

in.setType("leo.android.cursor.dir/vnd.google.leo");

startActivity(in);


这样还是匹配不上:

Intent in = new Intent();

in.setAction("android.intent.action.VIEW");

Uri uri = Uri.parse("something://project.example.com:80");

in.setData(uri);

// in.setType("leo.android.cursor.dir/vnd.google.leo");

startActivity(in);


(4) 一个Activity里可以有多对<intent-filter></intent-filter> 只要匹配其中一对，即可启动这个Activity

<activity android:name=".MyActivityTwo" android:label="@string/activityTwo">

<intent-filter>

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

<data android:scheme="something" android:host="project.example.com"

android:port="80" />

<category android:name="android.intent.category.DEFAULT"></category>

</intent-filter>


<intent-filter>

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

<data android:mimeType="leo.android.cursor.dir/vnd.google.leo" />

<category android:name="android.intent.category.DEFAULT"></category>

</intent-filter>


<intent-filter>

<action android:name="hello.hi.liao"></action>

<category android:name="android.intent.category.DEFAULT"></category>

</intent-filter>


</activity>


java代码里:

匹配第一对<intent-filter> 可以启动MyActivityTwo这个Activity:

Intent in = new Intent();

in.setAction("android.intent.action.VIEW");

in.addCategory(Intent.CATEGORY_DEFAULT);//可去掉,因为Category默认值即系Intent.CATEGORY_DEFAULT

Uri uri = Uri.parse("something://project.example.com:80");

in.setData(uri);

startActivity(in);

匹配第二对<intent-filter> 也可以启动MyActivityTwo这个Activity:

Intent in = new Intent();

in.addCategory(Intent.CATEGORY_DEFAULT);//可去掉,因为Category默认值即系Intent.CATEGORY_DEFAULT

in.setAction("android.intent.action.VIEW");

in.setType("leo.android.cursor.dir/vnd.google.leo");

startActivity(in);


匹配第三对<intent-filter> 也可以启动MyActivityTwo这个Activity:

Intent in = new Intent();

in.setAction("hello.hi.liao");

in.addCategory(Intent.CATEGORY_DEFAULT);//可去掉,因为Category默认值即系Intent.CATEGORY_DEFAULT

startActivity(in);


全部总结:

1. <action/>包含在 <intent-filter></intent-filter> 标签对里，而且是必不可少的！不管以哪一种方式来匹配，都不可缺少这个<action/> ,可以有多个，至少要有一个。

如有多个的，话只需要匹配其中一个即可找到这个activity

<action>里的属性值大多数是在Intent里定义的，比如<action android:name="android.intent.action.VIEW"/>里的属性值就等于 Intent.ACTION_VIEW,

在这个Intent类里以ACTION开头定义的常量都是。当然，也可以自定义。


2. 任何一个需要隐式启动的Activity都必须要有这项:<category android:name="android.intent.category.DEFAULT"/>

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

<category>里的属性值大多数是在Intent里定义的，比如 <category android:name="android.intent.category.DEFAULT"/>里的属性值就等于 Intent.CATEGORY_DEFAULT,

在这个Intent类里以CATEGORY开头定义的常量都是。当然，也可以自定义。


3.一个Activity里可以有多对<intent-filter></intent-filter> 只要匹配其中一对，即可启动这个Activity


4.在<intent-filter></intent-filter>里可以有多个<data android:mimeType="xxxx"/>，只需匹配其中一个即可.注意:不可以同时出现第5点的标签对，即下面这条。

5.在<intent-filter></intent-filter>里可以有多个<data android:scheme="xxxx" android:host="yyyy" android:port="uuu"/>，只需匹配其中一个即可。

语法:

<data android:host="string"

android:mimeType="string"

android:path="string"

android:pathPattern="string"

android:pathPrefix="string"

android:port="string"

android:scheme="string" />

可以分开写，如:

<data android:scheme="something" android:host="project.example.com" android:port="80"/>

等同于这样写:

<data android:scheme="something"/>

<data android:host="project.example.com"/>

<data android:port="80"/>


在java代码里,Uri的格式:scheme://host:port/path or pathPrefix or pathPattern

注意:不可以同时出现第4点的标签对，即上面那条。






6.在<intent-filter></intent-filter>里可以有多个<action android:name="xxxx"> ,只需匹配其中一个即可。







7.当匹配不上任何Activity的话，会发生异常，跳出对话框:很抱歉...某某应用程序意外停止，请重试。







8.上面所说的全部适用于Service和BroadcastReceiver，只需把<activity ...></activity>换成<service ...></service>或<receiver ...></receiver>即可。



9.刚参考了一下packages\apps\HTMLViewer\AndroidManifest.xml,第４和第５条应该是不冲突才对，但是实际测试中却是冲突，暂时未到找原因。匹配方式请看:用于打开HTML文件的intent






在被启动的Activity(本例为MyActivityTwo)里接收数据:

Intent intent = getIntent();

String intentCategories = intent.getCategories()

String intentType = intent.getType();

Uri uri = intent.getData();

String uriScheme = uri.getScheme();

String uriPath = uri.getPath();

String uriHost = uri.getHost();

String uriEncodedPath = uri.getEncodedPath();