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

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

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

لمزيد من المعلومات عن طريقة عمل روابط التطبيقات والمزايا التي تقدّمها، يُرجى قراءة مقالة معالجة روابط Android App Links.

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

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

لإضافة فلاتر الأهداف ومعالجة عناوين 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-potato-salad بالنشاط الذي تختاره في الخطوة التالية.

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

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

   تعرض نافذة الأداة الرئيسية في "مساعِد روابط التطبيقات" أيضًا جميع الروابط الحالية لصفحات معيّنة في الـ 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. انقر على ربط وتأكيد للتأكّد من أنّك حمّلت ملف روابط التنقل إلى مواد العرض الرقمية الصحيح إلى الموقع الإلكتروني الصحيح.

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

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

اختبار روابط Android App Links

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

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


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

3. انقر على تشغيل الاختبار.

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

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

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