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

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

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

للحصول على مزيد من المعلومات عن آلية عمل روابط التطبيقات والمزايا التي تقدّمها، يُرجى الاطّلاع على مقالة التعامل مع روابط التطبيقات المتوافقة مع Android.

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

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

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

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

3. أضِف تفاصيل إلى عملية ربط عناوين URL الجديدة:

   

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

   1. أدخِل عنوان URL لموقعك الإلكتروني في حقل المضيف.

   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، ويبرز التغييرات في الحقل معاينة. وإذا كنت تريد إجراء أي تغييرات، انقر على فتح AndroidManifest.xml لتعديل فلتر الأهداف. للمزيد من المعلومات، يمكنك الاطّلاع على فلاتر حسب النية بالشراء للروابط الواردة.

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

   

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

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

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

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

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

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

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

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
    ...
}

@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، مثل عرض المحتوى المقابل. على سبيل المثال، بالنسبة إلى تطبيق مشاركة وصفات الطعام، قد يبدو الرمز الخاص بك على النحو التالي:

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)
                    }
        }
    }
}

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.

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

الشكل 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. انقر على الربط وإثبات الملكية للتأكّد من أنّك حمَّلت ملف "روابط التنقل إلى مواد العرض الرقمية" الصحيح إلى الموقع الصحيح.

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

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

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

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

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


الشكل 3. مربّع الحوار اختبار روابط التطبيقات يعرض عنوان URL يتم اختباره ورسالة نجاح.

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

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

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

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