Intent Filter匹配规则,以及使用注意点

客官°小女子只卖身不卖艺 2022-01-14 21:05 213阅读 0赞

[2019独角兽企业重金招聘Python工程师标准>>> ][2019_Python_] ![hot3.png][]

## Intent 类别 ##

*  显式Intent  
    直接指定要启动的组件的完全限定名的`Intent`被称为显式`Intent`.在启动显式`Intent`的时候,系统将忽略`Intent Filter`,直接启动相应的组件(**当然,如果目标组件设定了权限,还需要验证调用者是否获得相应权限**)
 *  隐式Intent  
    没有指定组件完全限定名的`Intent`被称为隐式`Intent`.通常使用`<intent-filter>`标签配合`<action>`,`<data>`以及`<category>`来定义一个`Intent`的过滤规则

通常我们应该优先使用显式Intent,这样不仅性能会好一些,而且被启动的组件是确定的(就是你通过类名所指定的那个)

\*\*注意:\*\*如果`targetSdkVersion`>=21的话,`startService`,`bindService`不能使用隐式`Intent`,否则会抛出`IllegalArgumentException`

ContextImpl.java
    private void validateServiceIntent(Intent service) {
    	if (service.getComponent() == null && service.getPackage() == null) {
    		if (getApplicationInfo().targetSdkVersion >= Build.VERSION_CODES.LOLLIPOP) {
    			IllegalArgumentException ex = new IllegalArgumentException("Service Intent must be explicit: " + service);
    			throw ex;
    		} else {
    			Log.w(TAG, "Implicit intents with startService are not safe: " + service
                            + " " + Debug.getCallers(2, 3));
    		}
    	}
    }

## 隐式Intent的匹配 ##

*  action  
    `<intent-filter>`中可以定义0个或多个`<action>`
    
     *  只要`Intent`中的`action(Intent.getAction)`包含在`<intent-filter>`之中,那么`action`匹配环节就通过了
     *  如果`Intent`没有设置`action`,那么只要`<intent-filter>`定义了`<action>`,那么`action`匹配环节也会通过

\*\*需要注意的是:\*\*如果`<intent-filter>`中没有定义任何`<action>`,那么无论你发送的`Intent`是否设置了`action`,这个`<intent-filter>`都不会匹配

*  category  
    `<intent-filter>`中可以定义0个或者多个`<category>`
    
     *  只有当`Intent`中设置的`category`是`<intent-filter>`中所定义的`category`的子集时,`category`匹配环节才会通过(对于没有设置`category`的`Intent`,这个环节始终通过)

\*\*需要注意的是:\*\*如果隐式`Intent`配合`startActivity`或者`startActivityForResult`使用,那么要想匹配,`<intent-filter>`中需要加入`android.intent.category.DEFAULT`,原因是Android framework会加上`PackageManager.MATCH_DEFAULT_ONLY`

可以参考Intent.java
    public ComponentName resolveActivity(PackageManager pm) {
    	if (mComponent != null) {
    		return mComponent;
    	}
    	ResolveInfo info = pm.resolveActivity(this, PackageManager.MATCH_DEFAULT_ONLY); // 这儿
    	if (info != null) {
    		return new ComponentName(info.activityInfo.applicationInfo.packageName,info.activityInfo.name);
    	}
    	return null;
    }

*  data  
    `<intent-filter>`可以定义0个或多个`<data>`标签  
    data包括2部分类容:URI, mimeType
    
     *  URI的匹配  
        URI包括`schema`,`host`,`port`,`path`. \* 如果没有指定`schema`,那么`host`将被忽略 \* 如果没有指定`host`,那么`port`将被忽略 \* 如果`schema`和`host`都没有指定,那么`path`将被忽略 \* 若`<data>`中没有定义URI相关信息,那么只有`Intent`也没有定义URI信息,URI匹配才会通过 \* 若`Intent`中的URI的相应部分匹配`<data>`中定义的URI的有效部分,那么URI匹配通过(例如: `<data>`中只定义了`schema`,那么只要`Intent`中的URI的`schema`和其匹配,那么URI匹配通过) \* 若`Intent`中的URI的schema为`content`或者`file`,且`<data>`中没有指定URI,那么URI匹配通过
        
         *  mimeType的匹配
            
             *  \*/\*匹配所有mimeType
             *  image/\*匹配所有主类型为image的mimeType
             *  text/html匹配text/html
             *  只有当`<data>`没有指定mimeType且`Intent`也没有指定mimeType,或者`<data>`和`Intent`都指定了mimeType,且匹配时,mimeType匹配才通过
         *  只有URI和mimeType都匹配通过时,data匹配才通过  
            \*\*注意:\*\*当定义了多个`<data>`标签时,相当于定义了一组`mimeType`和一组`URI`,只有和这一组`mimeType`中的一个`mimeType`匹配以及这一组`URI`中的`URI`匹配时,`<data>`匹配才通过
        
            例如
            <intent-filter>
            	<action android:name="com.yyter.intentfilter.ignored"/>
            	<data android:mimeType="vnd.android.cursor.item/vnd.com.yyter.intentfilter.action.target"/>
            	<data android:scheme="yyter"/>
            	<data android:mimeType="image/*" android:scheme="http" android:host="android.com"/>
            	<data android:scheme="http" android:host="www.baidu.com"/>
            	<category android:name="android.intent.category.DEFAULT"/>
            </intent-filter>
            
            1.intent.setType("image/jpeg");//不匹配
            2.intent.setDataAndType(Uri.parse("yyter://"), "image/jpeg");//不匹配
            3.intent.setDataAndType(Uri.parse("yyter://www.baidu.com"), "image/jpeg");//匹配
            4.intent.setDataAndType(Uri.parse("yyter://android.com"), "image/jpeg");//匹配
            5.intent.setDataAndType(Uri.parse("http://android.com"), "vnd.android.cursor.item/vnd.com.yyter.intentfilter.action.target");//匹配
            ...
        
        \*\*建议:\*\*一个`<data>`标签要么只定义`mimeType`, 要么只定义`URI`,不要混在一起
 *  只有`action`,`category`和`data`都匹配通过时,`<intent-filter>`才匹配,一个组件可以定义多个`<intent-filter>`,只要其中一个`<intent-filter>`匹配,那么这个组件就通过匹配.

\*\*注意:\*\*对于定义了`<intent-filter>`的组件,那么它将是对外可见的,如果只是app内部使用,可以在组件标签中加上`android:exported="false"`

## 0个或多个组件匹配的情况 ##

*  Broadcast  
    无论0个还是多个`BroadcastReceiver`匹配,发送者都没有感知
 *  Service
    
     *  targetSdkVersion >= 21时,使用隐式Intent启动Service,会抛出`IllegalArgumentException`
     *  targetSdkVersion <= 20时,
        
         *  0个service匹配时,`startService`返回`null`
         *  多个service可以匹配时,只有第一个匹配的service被启动,并返回那个service的`ComponentName`(Android,找到一个匹配的service后,就不会接着寻找了)
 *  ContentProvider (`ContentProvider`是通过`ContentResolver`来使用的,并不使用`Intent`来启动,也不能定义`<intent-filter>`)
 *  Activity
    
     *  0个Activity匹配时,抛出`ActivityNotFoundException`
     *  多个Activity匹配时
        
         *  如果有设定的默认应用,那么启动那个应用的Activity
         *  如果没有设定的默认应用,那么弹出应用选择框,由用户选择

## 备注(通过隐式Intent启动Activity) ##

*  强制显示应用选择框

Intent sendIntent = new Intent(Intent.ACTION_SEND);
    ...
    
    if (sendIntent.resolveActivity(getPackageManager()) != null) {
    	String title = getResources().getString(R.string.chooser_title);
    	Intent chooser = Intent.createChooser(sendIntent, title);
        startActivity(chooser);
    }

如果只有一个应用匹配时,将直接启动对应的Activity,不会弹出选择框

*  也可以使用`PackageManager`的`queryIntentActivities`方法,找出匹配的所有Activity,然后使用自定义UI来展示

转载于:https://my.oschina.net/fengheju/blog/649398

[2019_Python_]: https://my.oschina.net/u/2663968/blog/3061697
[hot3.png]: /images/20220114/778cf3206f1f44b2b43f7a8e5d4d716d.png