الاستعداد والجلب المسبق: استخدام "خدمة علامات التبويب المخصَّصة"

Sebastian Benz

يركّز الجزء الثالث من هذا الدليل على تسريع عملية بدء تشغيل المتصفِّح من خلال warmup() والجلب المسبق لصفحات الويب من خلال mayLaunchUrl(). ويمكن أن توفّر عملية تدفئة المتصفِّح ما يصل إلى 700 ملي ثانية عند فتح رابط. يؤدي عرض المحتوى مسبقًا عبر mayLaunchUrl إلى فتح المحتوى الخارجي على الفور. ويمكن أن تؤدي واجهتا برمجة التطبيقات معًا إلى تحسين تجربة المستخدم لدمج علامات التبويب المخصَّصة ويُنصح بهما بشدة.

الخطوات المطلوبة هي:

1. تحقّق من خلال CustomTabsClient.getPackageName(...) إذا كان المتصفِّح التلقائي يتوافق مع "علامات التبويب المخصَّصة". إذا كانت الإجابة بنعم، يمكنك الربط بخدمة CustomTabsService من خلال CustomTabsClient.bindCustomTabsService().

2. بعد الربط بـ CustomTabsService، يمكنك تنفيذ ما يلي في معاودة الاتصال CustomTabsServiceConnection.onCustomTabsServiceConnected():

   a. يمكنك تحسين عملية المتصفِّح من خلال CustomTabsClient.warmup(). b. إنشاء CustomTabsSession جديد عبر CustomTabsClient.newSession().

3. يمكنك اختياريًا جلب صفحات الويب التي من المرجَّح أن يزورها المستخدم عبر CustomTabsSession.mayLaunchUrl().

4. عند تشغيل علامة تبويب مخصَّصة جديدة، مرِّر CustomTabsSession إلى CustomTabsIntent.Builder عبر الدالة الإنشائية new CustomTabsIntent.Builder(session).

إذا كان تطبيقك يستهدف المستوى 30 لواجهة برمجة تطبيقات Android، تطلب منك 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. عند الاتصال سريعًا بـ CustomTabsService أثناء onCreate()، يُرجى إعادة الاتصال بالخدمة إذا انقطع اتصال نشاطك واستدعاء معاودة الاتصال بـ onServiceDisconnected().
2. انتظِر حتى يشغّل المستخدم علامة تبويب مخصَّصة، ثم أنشئ اتصال الخدمة وشغِّل علامة التبويب المخصَّصة.

فتح صفحات الويب في التطبيقات الأصلية

على Android، يمكن التعامل مع عناوين URL بواسطة التطبيقات الأصلية. على سبيل المثال، إذا كان المستخدم قد ثبَّت تطبيق Facebook ونقر على رابط يؤدي إلى مشاركة على Facebook، سيفضّل عادةً فتح الرابط في تطبيق Facebook بدلاً من فتحه في المتصفح.

تفتح "علامات التبويب المخصصة" تلقائيًا الروابط في التطبيق الأصلي المعني إذا كان مثبتًا. ومع ذلك، بعد إنشاء CustomTabsServiceConnection، يتوقف هذا السلوك عن العمل ويتم فتح جميع عناوين URL في "علامات التبويب المخصَّصة" بدلاً من ذلك. لتحسين تجربة المستخدم، ننصحك بإعادة تفعيل هذا السلوك باستخدام الرمز التالي:

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

التالي: تعرَّف على كيفية تغيير حجم تجربة "علامات التبويب المخصَّصة".