वॉर्म-अप और प्री-फ़ेच करना: कस्टम टैब सेवा का इस्तेमाल करना

Sebastian Benz

इस गाइड का तीसरा हिस्सा, warmup() के ज़रिए ब्राउज़र चालू होने की स्पीड बढ़ाने और mayLaunchUrl() के ज़रिए वेब पेजों को प्रीफ़ेच करने पर फ़ोकस करता है. लिंक खोलने पर, ब्राउज़र प्रोसेस को गर्म करने में 700 मि॰से॰ तक की बचत हो सकती है. mayLaunchUrl के ज़रिए कॉन्टेंट को पहले से रेंडर करने पर, बाहरी कॉन्टेंट तुरंत खुल जाता है. दोनों एपीआई को एक साथ इस्तेमाल करने से, कस्टम टैब के इंटिग्रेशन के उपयोगकर्ता अनुभव को बेहतर बनाया जा सकता है. हम इनका सुझाव देते हैं.

इसके लिए, यह तरीका ज़रूरी है:

1. अगर डिफ़ॉल्ट ब्राउज़र पर कस्टम टैब काम करते हैं, तो CustomTabsClient.getPackageName(...) पर जाएं. अगर हां, तो CustomTabsClient.bindCustomTabsService() के ज़रिए CustomTabsService से बाइंड करें.

2. CustomTabsService से कनेक्ट होने के बाद, CustomTabsServiceConnection.onCustomTabsServiceConnected() कॉलबैक में, यह करें:

   a. CustomTabsClient.warmup() की मदद से ब्राउज़र प्रोसेस को वॉर्मअप करें. b. CustomTabsClient.newSession() की मदद से नया CustomTabsSession बनाएं.

3. इसके अलावा, CustomTabsSession.mayLaunchUrl() के ज़रिए उन वेब पेजों को प्रीफ़ेच किया जा सकता है जिन पर उपयोगकर्ता जा सकता है.

4. नया कस्टम टैब लॉन्च करते समय, कंस्ट्रक्टर new CustomTabsIntent.Builder(session) के ज़रिए, CustomTabsSession को CustomTabsIntent.Builder पर पास करें.

अगर आपका ऐप्लिकेशन Android एपीआई लेवल 30 को टारगेट करता है, तो CustomTabsClient.getPackageName(...) के लिए आपको Android मेनिफ़ेस्ट में क्वेरी सेक्शन जोड़ना होगा. ऐसा करने के लिए, एक इंटेंट-फ़िल्टर का एलान करना होगा. यह उन ब्राउज़र से मेल खाता है जो कस्टम टैब की सुविधा वाले ब्राउज़र से मेल खाते हैं.

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools">
  …
   <queries>
        <intent>
            <action android:name="android.support.customtabs.action.CustomTabsService" />
        </intent>
    </queries>
</manifest>

यहां कस्टम टैब सेवा से कनेक्ट करने के तरीके का पूरा उदाहरण दिया गया है:

private CustomTabsClient mClient;
private CustomTabsSession mSession;

private CustomTabsServiceConnection mConnection = new CustomTabsServiceConnection() {
    @Override
    public void onCustomTabsServiceConnected(
            @NonNull ComponentName name,
            @NonNull CustomTabsClient client
    ) {
        mClient = client;
        // Warm up the browser process
        mClient.warmup(0 /* placeholder for future use */);
        // Create a new browser session
        mSession = mClient.newSession(new CustomTabsCallback());
        // Pre-render pages the user is likely to visit
        // you can do this any time while the service is connected
        mSession.mayLaunchUrl(Uri.parse("https://developers.android.com"), null, null);
    }

    @Override
    public void onServiceDisconnected(ComponentName name) {
        mClient = null;
        mSession = null;
    }
};

private void bindCustomTabService(Context context) {
    // Check for an existing connection
    if (mClient != null) {
        // Do nothing if there is an existing service connection
        return;
    }

    // Get the default browser package name, this will be null if
    // the default browser does not provide a CustomTabsService
    String packageName = CustomTabsClient.getPackageName(context, null);
    if (packageName == null) {
        // Do nothing as service connection is not supported
        return;
    }
    CustomTabsClient.bindCustomTabsService(context, packageName, mConnection);
}

@Override
protected void onCreate(Bundle savedInstanceState) {
…
    bindCustomTabService(this);
    findViewById(R.id.button).setOnClickListener(new View.OnClickListener() {
        @Override
        public void onClick(View view) {
            String url = "https://developers.android.com";
            CustomTabsIntent intent = new CustomTabsIntent.Builder(mSession)
                    .build();
            intent.launchUrl(MainActivity.this, Uri.parse(url));
        }
    });
}

चेतावनी: आपकी गतिविधि के दौरान, कस्टम टैब का सेवा कनेक्शन काम नहीं कर सकता. अगर आपके ऐप्लिकेशन को चालू सेवा कनेक्शन की ज़रूरत है, तो दो तरीकों से यह पक्का किया जा सकता है कि सही सेवा कनेक्शन काम कर रहा है या नहीं:

1. अगर आपकी गतिविधि डिसकनेक्ट हो जाती है और onServiceDisconnected() कॉलबैक शुरू हो जाता है, तो onCreate() के दौरान CustomTabsService से तुरंत कनेक्ट करें.
2. जब तक उपयोगकर्ता कस्टम टैब को ट्रिगर नहीं करता, तब तक इंतज़ार करें. इसके बाद, सेवा कनेक्शन स्थापित करें और कस्टम टैब लॉन्च करें.

वेबपेज को खास ऐप्लिकेशन में खोलें

Android पर, यूआरएल को नेटिव ऐप्लिकेशन की मदद से मैनेज किया जा सकता है. उदाहरण के लिए, अगर उपयोगकर्ता के पास Facebook ऐप्लिकेशन इंस्टॉल है और वह किसी Facebook पोस्ट के लिंक पर क्लिक करता है, तो आम तौर पर वह ब्राउज़र के बजाय Facebook ऐप्लिकेशन में खुलने वाले लिंक को पसंद करता है.

अगर इंस्टॉल किया गया हो, तो कस्टम टैब डिफ़ॉल्ट रूप से संबंधित नेटिव ऐप्लिकेशन में लिंक खोलता है. हालांकि, CustomTabsServiceConnection बन जाने के बाद, यह काम करना बंद कर देता है और सभी यूआरएल, कस्टम टैब में खुलते हैं. बेहतर उपयोगकर्ता अनुभव के लिए, हमारा सुझाव है कि इस व्यवहार को फिर से चालू करने के लिए, नीचे दिए गए कोड का इस्तेमाल करें:

CustomTabsIntent customTabsIntent = new CustomTabsIntent.Builder()
    .setSendToExternalDefaultHandlerEnabled(true)
    .build();

अगला लेख: कस्टम टैब के अनुभव का साइज़ बदलने का तरीका जानें.