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

Sebastian Benz

يركّز الجزء الثالث من هذا الدليل على "خدمة علامات التبويب المخصّصة" والغرض من استخدامها في تطبيقك لتحسين تجربة المستخدم:

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

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

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

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

   أ. يمكنك إحماء عملية المتصفِّح باستخدام CustomTabsClient.warmup(). ب- إنشاء 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

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

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

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

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