إضافة روابط تطبيقات Android

"روابط تطبيقات Android" هي عناوين URL لبروتوكول HTTP تنقل المستخدمين مباشرةً إلى محتوى محدّد في تطبيق Android. ويمكن لهذه الروابط جذب المزيد من الزيارات إلى تطبيقك، ومساعدتك في اكتشاف محتوى التطبيق الأكثر استخدامًا، وتسهيل عثور المستخدمين على المحتوى ومشاركته في تطبيق مثبّت.

لإتاحة استخدام Android App Links:

  1. إنشاء فلاتر الأهداف في البيان
  2. عليك إضافة رمز إلى أنشطة تطبيقك للتعامل مع الروابط الواردة.
  3. اربط تطبيقك بموقعك الإلكتروني بروابط مواد العرض الرقمية.

يعمل "مساعد روابط التطبيقات" في "استوديو Android" على تبسيط هذه العملية من خلال الاستعانة بمعالج مفصّلة على النحو الموضَّح أدناه.

لمزيد من المعلومات عن آلية عمل روابط التطبيقات والمزايا التي تقدّمها، يمكنك الاطّلاع على التعامل مع روابط تطبيقات Android.

إضافة فلاتر الأهداف

يمكن أن يساعدك "مساعد روابط التطبيقات" في "استوديو Android" في إنشاء فلاتر نية الشراء في ملف البيان وربط عناوين URL الحالية من موقعك الإلكتروني بالأنشطة في تطبيقك. يضيف "مساعد Google" أيضًا رمز نموذج في كل نشاط مطابق لمعالجة الهدف.

لإضافة فلاتر أهداف ومعالجة عناوين URL، اتّبِع الخطوات التالية:

  1. انقر على الأدوات > مساعد روابط التطبيقات.
  2. انقر على فتح محرّر تعيين عناوين URL ثمّ انقر على إضافة في أسفل قائمة تعيين عناوين URL لإضافة تعيين جديد لعنوان URL.
  3. أضِف تفاصيل حول عملية ربط عناوين URL الجديدة:

    يوجِّهك "مساعد روابط التطبيقات" خلال عملية ربط عناوين URL الأساسية.

    الشكل 1. أضِف تفاصيل أساسية عن بنية روابط موقعك الإلكتروني لربط عناوين URL بالأنشطة في تطبيقك.

    1. أدخِل عنوان URL لموقعك الإلكتروني في حقل Host (المضيف).
    2. أضِف path أو pathPrefix أو pathPattern لعناوين URL التي تريد ربطها.

      على سبيل المثال، إذا كان لديك تطبيق لمشاركة وصفات الطعام يتضمّن جميع وصفات الطعام المتوفرة في النشاط نفسه، وكانت جميع وصفات موقعك الإلكتروني المقابلة في الدليل /recipe نفسه، استخدِم pathPrefix وأدخِل /recipe. بهذه الطريقة، يرتبط عنوان URL http://www.recipe-app.com/recipe/grilled-بوتato-salad بالنشاط الذي تختاره في الخطوة التالية.

    3. اختَر النشاط الذي يجب أن تنقل عناوين URL المستخدمين إليه.
    4. انقُر على موافق.

    تظهر نافذة محرر تعيين عنوان URL. يضيف مساعد روابط التطبيقات فلاتر الأهداف استنادًا إلى ربط عناوين URL إلى ملف AndroidManifest.xml، ويسلّط الضوء على التغييرات في الحقل معاينة. وإذا كنت تريد إجراء أي تغييرات، انقر على Open AndroidManifest.xml لتعديل فلتر الأهداف. لمعرفة المزيد من المعلومات، يمكنك الاطّلاع على فلاتر النية للروابط الواردة.

    تعرض نافذة أداة مساعد روابط التطبيقات الرئيسية أيضًا جميع الروابط الحالية لصفحات معيّنة في ملف AndroidManifest.xml وتتيح لك إصلاح أي أخطاء في الضبط بسرعة عن طريق النقر على إصلاح جميع المشاكل في البيان.

    يتيح لك "مساعد روابط التطبيقات" إصلاح الإعدادات الخاطئة في البيان.

    ملاحظة: لإتاحة الروابط المستقبلية بدون تحديث تطبيقك، حدِّد عملية ربط لعناوين URL متوافقة مع عناوين URL التي تخطّط لإضافتها. ويمكنك أيضًا تضمين عنوان URL للشاشة الرئيسية لتطبيقك حتى يتم تضمينه في نتائج البحث.

  4. للتحقّق من عمل ربط عناوين URL بشكلٍ سليم، أدخِل عنوان URL في الحقل التحقّق من ربط عناوين URL.

    وإذا كانت رسالة النجاح تعمل بشكل صحيح، توضّح رسالة النجاح أنّ عنوان URL الذي أدخلته مرتبط بالنشاط الذي اخترته.

التعامل مع الروابط الواردة

بعد التأكّد من أنّ عملية ربط عناوين URL تعمل بشكلٍ صحيح، أضِف منطقًا للتعامل مع الغرض الذي أنشأته:

  1. انقر على اختيار نشاط من "مساعد روابط التطبيقات".
  2. اختَر نشاطًا من القائمة وانقر على إدراج رمز.

يضيف "مساعد روابط التطبيقات" رمزًا إلى نشاطك على غرار ما يلي:

Kotlin

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    ...
    // ATTENTION: This was auto-generated to handle app links.
    val appLinkIntent: Intent = intent
    val appLinkAction: String? = appLinkIntent.action
    val appLinkData: Uri? = appLinkIntent.data
    ...
}

Java

@Override
void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    ...
    // ATTENTION: This was auto-generated to handle app links.
    Intent appLinkIntent = getIntent();
    String appLinkAction = appLinkIntent.getAction();
    Uri appLinkData = appLinkIntent.getData();
    ...
}

هذا الرمز غير كامل من تلقاء نفسه. يجب الآن اتخاذ إجراء استنادًا إلى معرّف الموارد المنتظم (URI) في appLinkData، مثل عرض المحتوى المقابل. على سبيل المثال، بالنسبة إلى تطبيق مشاركة وصفات الطعام، قد يظهر الرمز البرمجي على النحو التالي:

Kotlin

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    ...
    handleIntent(intent)
}

override fun onNewIntent(intent: Intent) {
    super.onNewIntent(intent)
    handleIntent(intent)
}

private fun handleIntent(intent: Intent) {
    val appLinkAction = intent.action
    val appLinkData: Uri? = intent.data
    if (Intent.ACTION_VIEW == appLinkAction) {
        appLinkData?.lastPathSegment?.also { recipeId ->
            Uri.parse("content://com.recipe_app/recipe/")
                    .buildUpon()
                    .appendPath(recipeId)
                    .build().also { appData ->
                        showRecipe(appData)
                    }
        }
    }
}

Java

protected void onCreate(Bundle savedInstanceState) {
  super.onCreate(savedInstanceState);
  ...
  handleIntent(getIntent());
}

protected void onNewIntent(Intent intent) {
  super.onNewIntent(intent);
  handleIntent(intent);
}

private void handleIntent(Intent intent) {
    String appLinkAction = intent.getAction();
    Uri appLinkData = intent.getData();
    if (Intent.ACTION_VIEW.equals(appLinkAction) && appLinkData != null){
        String recipeId = appLinkData.getLastPathSegment();
        Uri appData = Uri.parse("content://com.recipe_app/recipe/").buildUpon()
            .appendPath(recipeId).build();
        showRecipe(appData);
    }
}

ربط تطبيقك بموقعك الإلكتروني

بعد إعداد ميزة دعم عناوين URL لتطبيقك، ينشئ "مساعد روابط التطبيقات" ملف روابط مواد العرض الرقمية الذي يمكنك استخدامه لربط موقعك الإلكتروني بتطبيقك.

بدلاً من استخدام ملف "روابط مواد العرض الرقمية"، يمكنك ربط موقعك الإلكتروني وتطبيقك في Search Console.

إذا كنت تستخدم ميزة توقيع التطبيق من Play لتطبيقك، لن يتطابق عادةً الملف المرجعي للشهادة الذي أنشأه "مساعد روابط التطبيقات" مع الملف المرجعي للشهادة على أجهزة المستخدمين. في هذه الحالة، يمكنك العثور على مقتطف JSON الصحيح لتطبيقك في Play Console حساب المطوّر ضمن Release > Setup > App signing.

لربط تطبيقك بموقعك الإلكتروني باستخدام "مساعد روابط التطبيقات"، انقر على فتح أداة إنشاء ملفات روابط التنقل إلى مواد العرض الرقمية من "مساعد روابط التطبيقات" واتّبِع الخطوات التالية:

يوجِّهك "مساعد روابط التطبيقات" خلال عملية ربط عناوين URL الأساسية.

الشكل 2. أدخِل تفاصيل عن موقعك الإلكتروني وتطبيقك لإنشاء ملف روابط تنقل إلى مواد عرض رقمية.

  1. أدخِل نطاق الموقع الإلكتروني ورقم تعريف الطلب.
  2. لتضمين الدعم في ملف روابط التنقل إلى مواد العرض الرقمية لتسجيل الدخول بنقرة واحدة، اختَر إتاحة مشاركة بيانات الاعتماد بين التطبيق والموقع الإلكتروني وأدخِل عنوان URL لتسجيل الدخول إلى موقعك الإلكتروني.يؤدي هذا الإجراء إلى إضافة السلسلة التالية إلى ملف "روابط إلى مواد العرض الرقمية" للإشارة إلى أنّ التطبيق والموقع الإلكتروني يتشاركان بيانات اعتماد تسجيل الدخول: delegate_permission/common.get_login_creds.

  3. حدِّد إعدادات التوقيع أو اختَر ملف تخزين مفاتيح.

    تأكَّد من اختيار ملف إعدادات الإصدار أو ملف تخزين المفاتيح المناسب لإصدار الإصدار أو ملف إعدادات تصحيح الأخطاء أو ملف تخزين المفاتيح لإصدار تصحيح الأخطاء في تطبيقك. إذا كنت تريد إعداد إصدار الإنتاج، يمكنك استخدام ملف إعدادات الإصدار. إذا كنت تريد اختبار إصدارك، استخدِم إعدادات تصحيح الأخطاء.

  4. انقر على إنشاء ملف روابط تنقل إلى مواد عرض رقمية.
  5. بعد أن ينشئ "استوديو Android" الملف، انقر على حفظ الملف لتنزيله.
  6. يمكنك تحميل ملف assetlinks.json إلى موقعك الإلكتروني، مع منحه الإذن بالقراءة للجميع، وذلك من خلال https://yoursite/.well-known/assetlinks.json.

    ملاحظة مهمة: يتحقّق النظام من ملف "روابط مواد العرض الرقمية" من خلال بروتوكول HTTPS المشفّر. تأكّد من إمكانية الوصول إلى ملف assetlinks.json من خلال اتصال HTTPS، بغض النظر عما إذا كان فلتر أهداف تطبيقك يتضمّن https أم لا.

  7. انقر على الربط وإثبات الملكية للتأكّد من أنّك حمّلت ملف "روابط مواد العرض الرقمية" الصحيح إلى الموقع الصحيح.

اطّلِع على مزيد من المعلومات حول ربط موقعك الإلكتروني بتطبيقك من خلال ملف "روابط مواد العرض الرقمية" في بيان روابط المواقع الإلكترونية.

اختبار "روابط تطبيقات Android"

للتأكّد من أنّ الروابط تفتح النشاط الصحيح، اتّبِع الخطوات التالية:

  1. في مساعد روابط التطبيقات، انقر على اختبار روابط التطبيقات.
  2. أدخِل عنوان URL الذي تريد اختباره في حقل عنوان URL، على سبيل المثال، http://recipe-app.com/recipe/grilled-بوتato-salad.
  3. الشكل 3. مربّع حوار اختبار روابط التطبيقات يعرض عنوان URL يتم اختباره ورسالة نجاح.

  4. انقر على إجراء اختبار.

إذا لم يتم إعداد عملية ربط عناوين URL بشكلٍ سليم أو لم يتم إعدادها، ستظهر رسالة خطأ أسفل عنوان URL في مربّع الحوار اختبار روابط التطبيقات. وبخلاف ذلك، يشغِّل "استوديو Android" تطبيقك في الجهاز أو المحاكي في النشاط المحدّد بدون إظهار مربع حوار التوضيح ("أداة اختيار التطبيق") ويعرض رسالة نجاح في مربّع حوار اختبار روابط التطبيقات، كما هو موضّح في الشكل 3.

إذا لم يستطع "استوديو Android" تشغيل التطبيق، ستظهر رسالة خطأ في النافذة تشغيل ضمن "استوديو Android".

لاختبار روابط تطبيقات Android من خلال "مساعد روابط التطبيقات"، يجب أن يكون لديك جهاز متصل أو جهاز افتراضي متوفّر يعمل بالإصدار 6.0 من نظام التشغيل Android (المستوى 23 من واجهة برمجة التطبيقات) أو إصدار أحدث. لمزيد من المعلومات، يمكنك الاطّلاع على طريقة ربط جهاز أو إنشاء نظام AVD.