Android 外部喚起應用跳轉指定頁面

通常有這么一個場景,就是分享內容到微信朋友圈等,然后點擊內容中的某個按鈕就可以喚起自家應用。

這里要講的也是使用 scheme 的方式去實現跳轉,先捋一捋思路,首先如果要外部能喚醒 App ,那么 App 肯定要先注冊一個全局的事件監聽吧。然后,應該有一個頁面來處理接受事件然后解析出具體的參數然后跳轉具體的頁面。就是這么簡單。

思路捋好來,那么就來一一實現吧。

注冊事件監聽

這里需要使用到 Android Activity中的 <intent-filter> ,現在可以創建一個解析跳轉的 Activity,名字隨便取了,然后需要在 Manifest 文件中配置具體的 <intent-filter>。

<intent-filter>
    <data
        android:scheme="test"
        android:host="lovejjfg.com"
        />
    <action android:name="android.intent.action.VIEW"/>

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

</intent-filter>

如上配置,現在這個 Activity 就具備外部喚醒的能力了,注意下 <data> 中的相關配置,如上配置,外部的鏈接形式應該就是這樣的了:test://lovejjfg.com/xxx 。<data> 里面還可以定義其他內容,這里就不展開說了。

頁面跳轉

咳咳,這里要注意下了,比如說你有一個啟動頁 A,主頁是 B,現在要跳到指定的 C 頁面。那么外部喚起 App 的時候,其實有幾種情況,這都是需要我們去考慮的。

先決考慮,這個看產品的需求了,那就是打開具體的頁面,是僅啟動該頁面,回退直接返回瀏覽器,還是需要啟動 App。如果就是僅僅打開頁面就行,那么很簡單,直接跳轉頁面就好,不用考慮新建任務棧什么情況。如果回退要啟動目標App,不然用戶直接回到瀏覽器,這里就要再區分幾種情況了。

第一種情況,就是當前手機中并沒有啟動過目標 App。
簡單說就是瀏覽器要直接跳到 C 頁面,然后回退的時候,是顯示 A 頁面,然后進入 B 頁面。這里就是需要我們自己去創建一個堆棧,把 A、C 按順序都放進去,所以 C 回退到 A,A 然后可以啟動 B。知識點就是 TaskStackBuilder ,配合它的就是在 Manifest 中可以指定 Parent 的屬性。

Activity 邏輯父項的類名稱。此處的名稱必須與為相應 <activity>元素的 android:name 屬性指定的類名稱一致。系統會讀取該屬性,以確定當用戶按下操作欄中的“向上”按鈕時應該啟動哪一個 Activity。 系統還可以利用這些信息通過 TaskStackBuilder 合成 Activity 的返回棧。
要支持 API 級別 4 - 16,您還可以使用為 "android.support.PARENT_ACTIVITY"
指定值的 <meta-data>元素來聲明父 Activity。

所以這里就看你的適配情況了。接下來看看這個 TaskStackBuilder 的使用,其實并不難,抄抄就會了。哈哈。詳細的參照 官方文檔 只是這里說的是 PendingIntent 的開啟方式,我們這里其實是直接 startActivity() 的方法,這個要怎么操作呢?

TaskStackBuilder stackBuilder = TaskStackBuilder.create(this);
stackBuilder.addParentStack(resultIntent.getComponent());
stackBuilder.addNextIntent(resultIntent);
stackBuilder.startActivities();

其實我一開始是不知道直接開啟 Activity 需要怎么操作,因為抄的那里沒有這么寫,沒有抄的就自己去看看方法咯。一開始我是看到了 stackBuilder.getIntents() 的方法,然后機智的我趕緊試了下,調用context.startActivities() 果然有效果,后面才發現人家 builder 直接就有開啟Activity 的方法,沒錯就是上面的寫法。

等等,Builder 怎么被我寫成這樣了?這不是在侮辱Builder模式嗎?

TaskStackBuilder.create(this)
        .addParentStack(resultIntent.getComponent())
        .addNextIntent(resultIntent)
        .startActivities();

這才是最正確的操作嘛。接下來說第二種情況,目標 App 已經啟動,在后臺運行著,并且指定的 C 頁面并沒有打開。上面的方式,不管你App啟動沒,它都是會重新啟動的,這個讓人也有點兒不爽啊,那么為什么會每次都重新啟動呢?看看啟動的方法就知道咯。

public void startActivities(Bundle options) {
    if (mIntents.isEmpty()) {
        throw new IllegalStateException(
                "No intents added to TaskStackBuilder; cannot startActivities");
    }

    Intent[] intents = mIntents.toArray(new Intent[mIntents.size()]);
    intents[0] = new Intent(intents[0]).addFlags(Intent.FLAG_ACTIVITY_NEW_TASK |
            IntentCompat.FLAG_ACTIVITY_CLEAR_TASK |
            IntentCompat.FLAG_ACTIVITY_TASK_ON_HOME);
    if (!ContextCompat.startActivities(mSourceContext, intents, options)) {
        Intent topIntent = new Intent(intents[intents.length - 1]);
        topIntent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
        mSourceContext.startActivity(topIntent);
    }
}

看重點,這個方法每次都會給第一個Intent添加了
Intent.FLAG_ACTIVITY_NEW_TASK | IntentCompat.FLAG_ACTIVITY_CLEAR_TASK | IntentCompat.FLAG_ACTIVITY_TASK_ON_HOME 這三個Flag,因為有IntentCompat.FLAG_ACTIVITY_CLEAR_TASK 所以就成這個樣子咯,那么怎么解決呢?其實很簡單的,我們在跳轉的時候先判斷下當前App是否已經開啟過了嘛,,沒有的話,那就直接上面的代碼,有的話,那就不用再去創建堆棧了,直接開啟就好了。直接開啟的時候記得要加上Intent.FLAG_ACTIVITY_NEW_TASK的Flag,不然就在瀏覽器所在的堆棧里面了。

if (ViewUtils.isLaunchedActivity(this, HomeActivity.class)) {
    resultIntent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
    startActivity(resultIntent);
} else {
    TaskStackBuilder.create(this)
            .addParentStack(resultIntent.getComponent())
            .addNextIntent(resultIntent)
            .startActivities();
}

public static boolean isLaunchedActivity(@NonNull Context context, Class<?> clazz) {
    Intent intent = new Intent(context, clazz);
    ComponentName cmpName = intent.resolveActivity(context.getPackageManager());
    boolean flag = false;
    if (cmpName != null) { 
        ActivityManager am = (ActivityManager) context.getSystemService(Context.ACTIVITY_SERVICE);
        List<ActivityManager.RunningTaskInfo> taskInfoList = am.getRunningTasks(10);
        for (ActivityManager.RunningTaskInfo taskInfo : taskInfoList) {
            if (taskInfo.baseActivity.equals(cmpName)) { 
                flag = true;
                break;
            }
        }
    }
    return flag;
}

第三種情況,目標 App 已經啟動,在后臺運行這,指定的 C 頁面打開著的。

這個其實就是啟動模式的問題,C 已經打開,又一次打開,如果是正經的啟動模式,這里肯定重復出現多個 C 頁面的,所以呢,設置一個 SingleTop 就是可以解決問題的。當然,如果設置了該模式,你需要去處理 onNewIntent() 的方法了。

參數解析

參數這一塊看自己怎么定義的,比如說我定義的就是 test://lovejjfg.com/C?10086

Uri data = getIntent().getData();
String host = data.getHost();
String path = data.getPath();
String id = data.getQueryParameter("id")
String scheme = data.getScheme();
Log.i(TAG, "host: " + host);//lovejjfg.com
Log.i(TAG, "path: " + path);//C
Log.i(TAG, "scheme: " + scheme);//test
Log.i(TAG, "id: " + id);//'10086'

上面的思路不局限于 scheme 跳轉應用的使用,Notification 的方式也是一樣的。另外 startActivities() 的姿勢是不是很帥?

PS:沒事就多看看官方文檔吧,很多都已經漢化了。

-2017 12 28 更新-

因為有很多小伙伴兒也有類似的需求,有些問題已經在評論回復中解決。增加測試 Demo 和 測試鏈接,新增通知跳轉,方便大家測試。

地址:https://github.com/lovejjfg/EasyJump

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市,隨后出現的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 228,030評論 6 531
  • 序言:濱河連續發生了三起死亡事件,死亡現場離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機,發現死者居然都...
    沈念sama閱讀 98,310評論 3 415
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人,你說我怎么就攤上這事?!?“怎么了?”我有些...
    開封第一講書人閱讀 175,951評論 0 373
  • 文/不壞的土叔 我叫張陵,是天一觀的道長。 經常有香客問我,道長,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 62,796評論 1 309
  • 正文 為了忘掉前任,我火速辦了婚禮,結果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當我...
    茶點故事閱讀 71,566評論 6 407
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發上,一...
    開封第一講書人閱讀 55,055評論 1 322
  • 那天,我揣著相機與錄音,去河邊找鬼。 笑死,一個胖子當著我的面吹牛,可吹牛的內容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 43,142評論 3 440
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側響起,我...
    開封第一講書人閱讀 42,303評論 0 288
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后,有當地人在樹林里發現了一具尸體,經...
    沈念sama閱讀 48,799評論 1 333
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 40,683評論 3 354
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發現自己被綠了。 大學時的朋友給我發了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 42,899評論 1 369
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 38,409評論 5 358
  • 正文 年R本政府宣布,位于F島的核電站,受9級特大地震影響,放射性物質發生泄漏。R本人自食惡果不足惜,卻給世界環境...
    茶點故事閱讀 44,135評論 3 347
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 34,520評論 0 26
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至,卻和暖如春,著一層夾襖步出監牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 35,757評論 1 282
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個月前我還...
    沈念sama閱讀 51,528評論 3 390
  • 正文 我出身青樓,卻偏偏與公主長得像,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當晚...
    茶點故事閱讀 47,844評論 2 372

推薦閱讀更多精彩內容