تطبيقات اندرويد

الإعلانات

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

 

 

 

روابط تطبيقات اندرويد عبارة عن عناوين HTTP URL، التي تنقل المستخدمين مباشرة إلى محتوى معين في تطبيقك.

يمكن لروابط تطبيقات اندرويد أن تزيد من زيارات تطبيقك، وتساعدك على اكتشاف أكثر محتويات التطبيق إستخداماً، وتسهل على المستخدمين..

المشاركة والعثور على محتويات في تطبيق مثبت. 

لإضافة دعم لروابط تطبيق اندرويد:

  1. إنشاء مرشحات غرض في ملف الإيضاح
  2. إضافة كود إلى أنشطة تطبيقك للتعامل مع الروابط الواردة
  3. ربط تطبيقك و موقعك بروابط الأصول الرقمية Digital Asset Links

يعمل مساعد روابط التطبيق في اندرويد ستوديو 2.3 والإصدارات الأحدث على تبسيط العملية في معالج خطوة بخطوة، كما هو موضح أدناه.

 

لمزيد من المعلومات حول كيفية عمل روابط التطبيق، والفوائد التي تقدمها، اقرأ التعامل مع روابط تطبيق اندرويد.

 

 

إضافة مرشحات غرض


مساعد روابط تطبيقات اندرويد، في اندرويد ستوديو، يمكنه أن يساعدك في إنشاء مرشحات غرض، في ملف إيضاحك، وتحديد عناوين URL..

الحاليه من موقعك، إلى الأنشطة في تطبيقك. يقوم مساعد روابط التطبيقات أيضاً، بإضافة قوالب كود جافا، إلى كل نشاط مطابق للتعامل مع الغرض.

لإضافة مرشحات غرض ومعالجة عناوين URL، اتبع الخطوات التالية:

  1. اختار Tools > App Links Assistant.
  2. اضغط على Open URL Mapping Editor، ثم اضغط Add في أسفل قائمة URL Mapping لإضافة عنوان URL جديد.
  3. إضافة تفاصيل لتعيين عنوان URL جديد:

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

 

1- ادخل عنوان URL الخاص بموقعك في حقل المضيف Host.

2- اضف مسار، بادئة مسار، أو نمط مسار، لعناوين URL التي تريد تعيينها. مثال، لو كان لديك تطبيق لمشاركة وصفات الطبخ

مع كافة الوصفات المتاحة في نفس النشاط، و وصفات الطبخ في موقعك كلها في نفس الدليل المسمى /recipe، إستخدم بادئة المسار pathPrefix، ثم أدخل /recipe.

يكون العنوان بهذه الطريقه:  http://www.recipe-app.com/recipe/grilled-potato-salad يشير إلى النشاط الذي تحدده في الخطوة التاليه.

3- حدد النشاط Activity الذي يجب على عناوين URL أن تأخذ المستخدمين إليه.

4- أضغط OK موافق.

 

  • 4. يقوم مساعد روابط التطبيق، بإضافة مرشحات الغرض بناءً على تعيين عنوان URL في ملف AndroidManifest.xml، و يسلط الضوء عليها في حقل المعاينه Preview.

إذا رغبت في إجراء أية تغييرات، اضغط على Open AndroidManifest.xml لتحرير مرشح الغرض. (تعلم المزيد عن مرشحات الغرض في اندرويد).

ملاحظه: لدعم المزيد من الروابط دون الحاجة إلى تحديث تطبيقك، يجب عليك تعريف عناوين URL mapping التي تدعم عناوين URL التي ستضيفها في المستقبل.

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

  • 5. للتحقق من أن تعيين عنوان URL يعمل بشكلٍ صحيح، أدخل عنوان URL في الحقل Check URL Mapping ثم اضغط Check Mapping.

إذا كان يعمل بشكلٍ صحيح، فسوف تظهر رسالة نجاح بأن عنوان URL المُدخل، يشير إلى النشاط الذي حددته.

 

 

 

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


بمجرد تحققك من أن إشارة عنوان URL تعمل بشكلٍ صحيح، قم بإضافة منطق للتعامل مع الغرض الذي أنشأته.

  1. اضغط Select Activity من مساعد روابط التطبيق App Links Assistant.
  2. اختر نشاطاً activity من القائمة ثم اضغط إدراج كود Insert Code.

يقوم مساعد روابط التطبيق بإضافة كود إلى ملف الجافا الخاص بنشاطك، بشكلٍ مشابه لما يلي

(يرجى ملاحظة: أن مساعد روابط التطبيق لا يدعم حالياً لغة كوتلن، لذا سوف تحتاج لإضافة هذا الكود يدوياً):

KOTLIN

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

    val appLinkIntent = intent
    val appLinkAction = appLinkIntent.action
    val appLinkData = appLinkIntent.data

}

JAVA

// 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 لتطبيقك، يقوم مساعد روابط التطبيق، بإنشاء ملف Digital Asset Links “روابط الأصول الرقمية”والتي يمكنك إستخدامها لربط موقعك بتطبيقك.

كبديل لإستخدام ملف Digital Asset Links، يمكنك ربط موقعك بتطبيقك في Search Console.

لربط تطبيقك بموقعك بإستخدام App Links Assistant، اضغط Open Digital Asset Links File Generator من..

مساعد روابط التطبيق App Links Assistant ثم اتبع الخطوات التاليه:

 

 

 


 

 

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

 

1- ادخل نطاق موقعك Site domain و معرّف تطبيقك Application ID.

2- لتضمين الدعم في ملف روابط الأصول الرقمية، للقفل الذكي لكلمات المرور Smart Lock for Passwords..

اختار دعم مشاركة بيانات الإعتماد بين التطبيق والموقع ” Support sharing credentials between the app and the website”

ثم ادخل رابط URL لصفحة تسجيل الدخول إلى موقعك. وهذا يؤدي إلى إضافة السلسلة التاليه إلى ملف

روابط الأصول الرقمية للإعلان بأن تطبيقك و موقعك يتشاركان بيانات إعتماد تسجيل الدخول ذاتها:

delegate_permission/common.get_login_creds

تعلم المزيد عن دعم القفل الذكي لكلمات المرور في تطبيقك.

3- اختر تكوين التوقيع signing config أو اختار keystore file. تأكد من اختيار التكوين أو ملف keystore الصحيحه، لكلٍ من إصدار الإطلاق أو إصدار تصحيح الأخطاء لتطبيقك. 

إذا كنت ترغب في إعداد إصدار الإنتاج، إستخدم تكوين الإطلاق release config. إذا كنت ترغب في إختبار بنيتك..

إستخدم تكوين تصحيح الأخطاء debug config. 

4- اضغط Generate Digital Asset Links file.

5- حالما يقوم اندرويد ستوديو بإنشاء الملف، اضغط على حفظ الملف Save file لتنزيله.

6- قم بتحميل ملف assetlinks.json إلى موقعك، مع قابلية القراءة read-access للجميع، على https://<yoursite>/.well-known/assetlinks.json.

هام: يتحقق النظام من ملف روابط الأصول الرقمية عبر بروتوكول HTTPS المُشفر. يتأكد من أن ملف assetlinks.json ..

قابل للوصول عبر إتصال HTTPS، بغض النظر عما إذا كان مرشح غرض تطبيقك يحتوي على https أو لا.

7- اضغط على Link and Verify لتأكيد قيامك بتحميل ملف روابط الأصول الرقمية الصحيح، إلى الموقع الصحيح.

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

 

 

 

 

اختبار روابط تطبيقك


للتحقق من أن روابطك تفتح النشاط الصحيح، اتبع الخطوات التاليه:

  1. اضغط على Test App Links في App Links Assistant.
  2. ادخل عنوان URL الذي ترغب في اختباره في حقل URL، مثال: http://recipe-app.com/recipe/grilled-potato-salad.
  3. اضغط تشغيل الاختبار Run Test.
  4. إذا لم يتم تعيين عنوان URL بشكلٍ صحيح، أو لم يكن موجوداً، ستظهر رسالة خطأ تحت عنوان URL في نافذة اختبار روابط التطبيق Test App Links. 

 

الشكل 3. مساعد روابط التطبيق يعرض رسالة نجاح و يفتح تطبيقك على المحتوى المحدد، عندما يقوم عنوان URL قيد الإختبار ينجح في الإشارة إلى نشاط في تطبيقك.

 

في حالة وجود تعيين لعنوان URL، سيقوم اندرويد ستوديو بتشغيل تطبيقك على الجهاز أو المحاكي في النشاط المحدد..

من دون إظهار مربع حوار التوضيح (منتقي التطبيق)، ويعرض رسالة نجاح في نافذة App Link Testing. أما إذا تعذر على اندرويد ستوديو..

تشغيل التطبيق بنجاح، ستظهر رسالة خطأ في نافذة التشغيل Run الخاصة بأندرويد ستوديو.

لإختبار روابط تطبيق اندرويد من خلال مساعد روابط التطبيق، يجب أن يكون لديك جهاز متصل أو محاكي متاح يعملان على..

إصدار اندرويد 6.0 (المستوى 23) أو أحدث. لمزيد من المعلومات، راجع كيفية توصيل جهاز أو إنشاء محاكي AVD.

 

 

 

 

إضافة فهرسة تطبيق Firebase


بعد إضافة روابط تطبيقات اندرويد إلى تطبيقك، يمكنك إضافة كود “فهرسة تطبيق فايربيس” Firebase App Indexing..

إلى نشاط للحصول على إعادة إرتباط بتطبيقك، من ميزات بحث قوقل الإضافية، بما في ذلك، إقتراحات الإكمال التلقائي و البحث بداخل التطبيق.

تعلم المزيد عن Firebase App Indexing في وثائق فهرسة تطبيق Firebaseلإضافة Firebase App Indexing إلى تطبيقك..

إستخدام مساعد Firebase Assistant في اندرويد ستوديو و قم بتوسيع قسم فهرسة التطبيق App Indexing، للحصول على إرشادات خطوة بخطوة.


للإطلاع على المقال باللغة الإنجليزية أضغط هنا.

الإعلانات

اترك رد