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

lovejjfg發表於2018-11-22
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 邏輯父項的類名稱。此處的名稱必須與為相應 元素的 android:name 屬性指定的類名稱一致。系統會讀取該屬性，以確定當使用者按下操作欄中的“向上”按鈕時應該啟動哪一個 Activity。 系統還可以利用這些資訊通過 TaskStackBuilder 合成 Activity 的返回棧。 要支援 API 級別 4 - 16，您還可以使用為 "android.support.PARENT_ACTIVITY"  指定值的 元素來宣告父 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 和 測試連結，新增通知跳轉，方便大家測試。

地址：github.com/lovejjfg/Ea…

相關文章