檢查 Android 裝置是否有支援自訂分頁的瀏覽器

下列各節說明如何確認 Android 裝置上的預設瀏覽器或任何瀏覽器是否支援自訂分頁。

檢查預設瀏覽器是否支援自訂分頁

如要確認預設瀏覽器是否支援自訂分頁，請在 CustomTabsClient 中使用 getPackageName 輔助程式方法：

String packageName = CustomTabsClient.getPackageName(
        context,
        Collections.emptyList()
);
if (packageName == null) {
    // Custom Tabs are not supported by the default browser
}

檢查裝置上的任何瀏覽器是否支援自訂分頁

如要確認裝置上安裝的瀏覽器是否支援自訂分頁，您必須查詢可處理 VIEW 意圖的應用程式、擷取其套件名稱，然後在 CustomTabsClient 中使用 getPackageName 輔助程式方法：

// Get all apps that can handle VIEW intents and Custom Tab service connections.
Intent activityIntent = new Intent(Intent.ACTION_VIEW, Uri.parse("http://www.example.com"));
PackageManager packageManager = context.getPackageManager();
List<ResolveInfo> resolveInfos = packageManager.queryIntentActivities(activityIntent, PackageManager.MATCH_ALL);

// Extract package names from ResolveInfo objects
List<String> packageNames = new ArrayList<>();
for (ResolveInfo info : resolveInfos) {
    packageNames.add(info.activityInfo.packageName);
}

// Get a package that supports Custom Tabs
String packageName = CustomTabsClient.getPackageName(
        context,
        packageNames,
        true /* ignore default */
);
if (packageName == null) {
    // Custom Tabs are not supported by any browser on the device
}

Android 11 套件瀏覽權限異動

Android 11 已推出套件瀏覽權限變更。如果 Android 應用程式指定 API 級別 30 以上版本，您必須在 AndroidManifest.xml 的查詢部分中加入以下宣告。

如果沒有這項宣告，queryIntentActivities 方法就不會傳回結果：

<queries>
    <intent>
        <action android:name=
            "android.support.customtabs.action.CustomTabsService" />
    </intent>
</queries>

裝置中沒有任何瀏覽器支援自訂分頁

如果裝置中沒有支援自訂分頁的瀏覽器，且您使用 customTabsIntent.launchUrl(context, url) 啟動網址，意圖可能會失敗，導致 ActivityNotFoundException。

請務必執行相容性檢查，確保提供更優質的使用者體驗。

您可以改用標準的 ACTION_VIEW 意圖，在任何可用的瀏覽器中開啟網址。