android browser支持支持Intent Scheme URL語法的可以在wrap頁面加載或點擊時,通過特定的intent uri鏈接可以打開對應app頁面,例如
<a href="intent://whatsapp/#Intent;scheme=myapp;package=com.xiaoyu.myapp;S.help_url=http://Fzxing.org;end">what can I do</a>
通過android系統解析查找符合規則的Activity后啟動對應activity,如果未找到匹配Activity則browser進行處理。
配置
<a href="intent://whatsapp/#Intent;scheme=myapp;package=com.xiaoyu.myapp;S.help_url=http://Fzxing.org;end">what can I do</a>
//這樣如果沒有對應應用,該鏈接就會跳轉到S.help_url指定的url上
<intent-filter>
<action android:name="android.intent.action.VIEW" />
<category android:name="android.intent.category.DEFAULT" />
<category android:name="android.intent.category.BROWSABLE" /><!-- 定義瀏覽器類型,有URL需要處理時會過濾 -->
<data android:scheme="myapp" android:host="whatsapp" android:path="/" /><!-- 打開以whatsapp協議的URL,這個自己定義 -->
</intent-filter>
URI的解析與生成:
在Intent 類內部有個parseUri(String uri, int flags)方法用來解析Uri生成Intent返回,下面主要分析該方法:
在分析該解析方法時候,首先我們需要理解intent uri規則,在intent類里規則串如下,
android-app://com.example.app/<br />#Intent;action=com.example.MY_ACTION;<br />i.some_int=100;S.some_str=hello;end
根據此規則,看出主要分為三個部分:
Header: android-app://android app為判斷是否是android 應用
Action: com.example.MY_ACTION //組件的action內容
Package: com.example.app //包名啟動組件使用
Extra: some_int=(int)100,some_str=(String)hello //傳遞的數據,i代表int,S代表String ,c代表char等基本類型
除了這幾部分內容也包含intent內的其它內容,如categry,type,component,selector等
在簡單分析理解Uri規則串后,再來分析parseUri就很好理解了,下面看一下主要代碼
public static Intent parseUri(String uri, int flags) throws URISyntaxException {
int i = 0;
try {
final boolean androidApp = uri.startsWith("android-app:");//判斷開頭是否為android,
// Validate intent scheme if requested.
if ((flags&(URI_INTENT_SCHEME|URI_ANDROID_APP_SCHEME)) != 0) {
if (!uri.startsWith("intent:") && !androidApp) {//是否為intent Uri
Intent intent = new Intent(ACTION_VIEW);
try {
intent.setData(Uri.parse(uri));
} catch (IllegalArgumentException e) {
throw new URISyntaxException(uri, e.getMessage());
}
return intent;
}
}
i = uri.lastIndexOf("#");//查找標記位,開始解析
// simple case
if (i == -1) {
if (!androidApp) {
return new Intent(ACTION_VIEW, Uri.parse(uri));
}
// old format Intent URI
} else if (!uri.startsWith("#Intent;", i)) {
if (!androidApp) {
return getIntentOld(uri, flags);
} else {
i = -1;
}
}
// new format
Intent intent = new Intent(ACTION_VIEW);
Intent baseIntent = intent;
boolean explicitAction = false;
boolean inSelector = false;
// fetch data part, if present
String scheme = null;
String data;
if (i >= 0) {
data = uri.substring(0, i);
i += 8; // length of "#Intent;"
} else {
data = uri;
}
// loop over contents of Intent, all name=value;
while (i >= 0 && !uri.startsWith("end", i)) {//按類別分離循環處理(解析action,categry,type,extra data)
int eq = uri.indexOf('=', i);
if (eq < 0) eq = i-1;
int semi = uri.indexOf(';', i);
String value = eq < semi ? Uri.decode(uri.substring(eq + 1, semi)) : "";
// action
if (uri.startsWith("action=", i)) {
intent.setAction(value);
if (!inSelector) {
explicitAction = true;
}
}
// categories
else if (uri.startsWith("category=", i)) {
intent.addCategory(value);
}
// type
else if (uri.startsWith("type=", i)) {
intent.mType = value;
}
// launch flags
else if (uri.startsWith("launchFlags=", i)) {
intent.mFlags = Integer.decode(value).intValue();
if ((flags& URI_ALLOW_UNSAFE) == 0) {
intent.mFlags &= ~IMMUTABLE_FLAGS;
}
}
// package
else if (uri.startsWith("package=", i)) {
intent.mPackage = value;
}
// component
else if (uri.startsWith("component=", i)) {
intent.mComponent = ComponentName.unflattenFromString(value);
}
// scheme
else if (uri.startsWith("scheme=", i)) {
if (inSelector) {
intent.mData = Uri.parse(value + ":");
} else {
scheme = value;
}
}
// source bounds
else if (uri.startsWith("sourceBounds=", i)) {
intent.mSourceBounds = Rect.unflattenFromString(value);
}
// selector
else if (semi == (i+3) && uri.startsWith("SEL", i)) {
intent = new Intent();
inSelector = true;
}
// extra data parse
else {
String key = Uri.decode(uri.substring(i + 2, eq));
// create Bundle if it doesn't already exist
if (intent.mExtras == null) intent.mExtras = new Bundle();
Bundle b = intent.mExtras;
// add EXTRA,這里巧妙的對基本數據類型進行處理,(字母.var)值得學習借鑒
if (uri.startsWith("S.", i)) b.putString(key, value);
else if (uri.startsWith("B.", i)) b.putBoolean(key, Boolean.parseBoolean(value));
else if (uri.startsWith("b.", i)) b.putByte(key, Byte.parseByte(value));
else if (uri.startsWith("c.", i)) b.putChar(key, value.charAt(0));
else if (uri.startsWith("d.", i)) b.putDouble(key, Double.parseDouble(value));
else if (uri.startsWith("f.", i)) b.putFloat(key, Float.parseFloat(value));
else if (uri.startsWith("i.", i)) b.putInt(key, Integer.parseInt(value));
else if (uri.startsWith("l.", i)) b.putLong(key, Long.parseLong(value));
else if (uri.startsWith("s.", i)) b.putShort(key, Short.parseShort(value));
else throw new URISyntaxException(uri, "unknown EXTRA type", i);
}
// move to the next item
i = semi + 1;
}
if (inSelector) {
// The Intent had a selector; fix it up.
if (baseIntent.mPackage == null) {
baseIntent.setSelector(intent);
}
intent = baseIntent;
}
......
return intent;//解析生產內容,對應到生產的intent,返回處理
} catch (IndexOutOfBoundsException e) {
throw new URISyntaxException(uri, "illegal Intent URI format", i);
}
}
經過上面簡要分析,我們了解Uri intent生成過程,這種設計非常巧妙可以達到很好的解耦處理,相比於顯示與隱士啟動方式,這種方式更加靈活。
例如,我們可以由Server端動態下發,本地通過解析后在進行跳轉頁面,即可達到動態控制頁面功能,其實不僅可以應用到頁面跳轉中,如果進一步擴展,可以應用到更多功能中,
比如我們可以擴展自定義規則,如header改為:http,https,代表頁面跳轉到webActivity,header改為:tipe時為toast提示,改為dialog時為彈框顯示等。
我們還可以更為細致的控制,如可加入版本號指定對應的版本的app執行這規則,其余版本默認行為,適用於修復部分bug。由此可見我們可以通過修改parseUri方法即可以擴展到更多功能中,下面看一下我的修改,
static final String TAG="PageJump";
static final String SCHEME_INTENT = "page";
static final String SCHEME_ANDROIDAPP = "android-app:";
static final String SCHEME_HTTP = "http";
static final String SCHEME_HTTPS = "https";
static final String SCHEME_TIPS_DIALOG = "tips_dialog";
static final String SCHEME_TIPS_TOAST = "tips_toast";
//動態解析實現對頁面行為控制
public static void jumpPageUri(Context context, String strUri) throws URISyntaxException{
//{(2,5][8,12)}android-app://com.example.app/<br />#Intent;action=com.example.MY_ACTION;
if (TextUtils.isEmpty(strUri)) {
throw new NullPointerException("parser uri content is empty");
}
String data = strUri.trim();
//uri是否在版本內
final int curVer = Utils.getVerCode(context);
if(isInRangeVersion(data,curVer)){
return;
}
//remove command version part
if(data.startsWith("{")) {
int verEnd = data.indexOf('}', 1);
data = data.substring(verEnd+1);
}
String uriData = data;
if(uriData.startsWith(SCHEME_ANDROIDAPP)){
Intent intent = Intent.parseUri(uriData, Intent.URI_INTENT_SCHEME);
String appPackage = context.getPackageName();
ComponentName componentName = intent.getComponent();
//out intent
if (componentName == null || !appPackage.contains(componentName.getPackageName())){
intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
context.startActivity(intent);
}
}
else if (uriData.startsWith(SCHEME_INTENT)) {
Intent sendIntent = UriProcessor.parseIntentUri(data, Intent.URI_INTENT_SCHEME);
// Verify that the intent will resolve to an activity
// if (null == sendIntent.resolveActivity(context.getPackageManager())) {
// throw new URISyntaxException(data, "not found match page");
// }
sendIntent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
context.startActivity(sendIntent);
}
else if (uriData.startsWith(SCHEME_HTTP) || uriData.startsWith(SCHEME_HTTPS)) {
// WebViewActivity.launch(context, uri);
}
else if(uriData.startsWith(SCHEME_TIPS_DIALOG)){
// DialogUtil.showNormal("test");
}
else if(uriData.startsWith(SCHEME_TIPS_TOAST)){
// ToastUtils.showShortMessage("");
}
}
規則串前面增加了應用版本范圍,{(2,5][8,12)},這里我使用開閉區間的方式來指定及范圍,這種方式更精簡使用,版本解析處理
/**
* current command version whether contain current app version
* @param data
* @param curVer
* @return
*/
public static boolean isInRangeVersion(String data,final int curVer){
if(data.startsWith("{")){
int verEnd = data.indexOf('}', 1);
if(verEnd>0) {
String verStr = data.substring(0, verEnd+1);
boolean in_range=true;
int pos=1;
try {
while (pos >= 0 && !verStr.startsWith("}")) {
in_range=true;
char ch = verStr.charAt(pos);
if (ch == '[' || ch == '(') {
boolean[] border=new boolean[2];
int semi = verStr.indexOf(',', pos);
int startVer = Integer.valueOf(verStr.substring(pos + 1, semi));
border[0]= (ch=='[');
int toVer = 0, flagVer = 0;
if ((flagVer = verStr.indexOf(']', semi)) >= 0 || (flagVer = verStr.indexOf(')', semi)) >= 0) {
toVer = Integer.valueOf(verStr.substring(semi + 1, flagVer));
border[1]= (verStr.charAt(flagVer)==']');
}
// judge current version code not inside range
// jude min version code < <=
if((border[0] && curVer<startVer) ||(!border[0] && curVer<=startVer)){
in_range=false;
}
// judge max version code > >=
if((border[1] && curVer>toVer) ||(!border[1] && curVer>=toVer)){
in_range=false;
}
pos = flagVer + 1;
if (pos + 1 >= verStr.length())
break;
}
}
return in_range;
}catch (NumberFormatException ex){
Log.e(TAG,"parse regular expression version error!");
}
}
return true;
}
return true;
}
測試使用:
// String jumpUri1="{(2,5][8,12)}android-app://com.example.app/#Intent;action=com.example.MY_ACTION;i.some_int=100;S.some_str=hello;end";
String jumpUri2="{(0,3][6,12)}android-app://com.example.app/#Intent;action=com.example.MY_ACTION;i.some_int=100;end";
String jumpUri3="{(0,6]}android-app://com.example.app/#Intent;action=com.example.MY_ACTION;i.some_int=100;end";
String jumpUriPage="{(2,6]}android-app://com.example.myapp/#Intent;action=com.example.myapp.SecondActivity;package=com.example.myapp;category=android.intent.category.DEFAULT;S.some=systemFrom;end";
String jumpUriPage2="{[1,8]}page#Intent;action=com.example.myaction;package=com.example.myapp;category=android.intent.category.DEFAULT;S.some=innerFrom;end";
try {
// PageJump.jumpPageUri(getApplicationContext(),jumpUri1);
PageJump.jumpPageUri(getApplicationContext(),jumpUri2);
PageJump.jumpPageUri(getApplicationContext(),jumpUri3);
} catch (URISyntaxException e) {
e.printStackTrace();
}
分析intent的代碼設計后,真是覺得源碼設計的十分巧妙,值得仔細認真琢磨。
