لتمكين الروابط الشاملة (Universal Links) على نظام iOS وروابط التطبيقات (App Links) على نظام Android، تحتاج إلى استضافة ملفي JSON محددين على خادم الويب الخاص بك:

1. apple-app-site-association (AASA) لنظام iOS: يخبر هذا الملف نظام iOS بالمسارات الموجودة على موقعك التي يجب أن يتعامل معها تطبيق iOS الخاص بك.
2. assetlinks.json لنظام Android: يخبر هذا الملف نظام Android بالمسارات الموجودة على موقعك التي يجب أن يتعامل معها تطبيق Android الخاص بك.

يعد تقديم هذه الملفات بشكل صحيح أمرًا بالغ الأهمية لكي تعمل الروابط العميقة بسلاسة.

1. استضافة ملف apple-app-site-association (AASA) لنظام iOS

• محتوى الملف: ملف AASA هو ملف JSON يقوم بتعيين مسارات موقعك إلى تطبيقك. يبدو الهيكل الشائع كما يلي:

  json { "applinks": { "apps": [], "details": [ { "appID": "TEAM_ID.com.yourcompany.yourapp", "paths": [ "/app/*", "/links/to/content/*", "*" ] } ] } } * استبدل TEAM_ID.com.yourcompany.yourapp بمعرف التطبيق الفريد الخاص بك (معرف الفريق متبوعًا بمعرف حزمة التطبيق الخاص بك). * يحدد مصفوفة paths مسارات URL الموجودة على موقعك والتي يجب أن يتعامل معها التطبيق. "*" يعني جميع المسارات.

• متطلبات الاستضافة:

  • الموقع: يجب استضافة الملف في جذر النطاق الخاص بك أو في الدليل .well-known. على سبيل المثال:
    • https://yourdomain.com/.well-known/apple-app-site-association
    • https://yourdomain.com/apple-app-site-association (أقل شيوعًا الآن)
  • HTTPS: يجب تقديم الملف عبر HTTPS.
  • نوع MIME: يجب أن يكون رأس Content-Type هو application/json أو application/json; charset=utf-8.
  • لا توجد عمليات إعادة توجيه: يجب ألا تتم إعادة توجيه ملف AASA نفسه.

• التحقق: تقوم أجهزة iOS بتنزيل هذا الملف عند تثبيت تطبيقك. يمكنك اختبار إمكانية الوصول إليه باستخدام أداة التحقق من Apple أو ببساطة عن طريق محاولة الوصول إلى عنوان URL في Safari.

2. استضافة ملف assetlinks.json لنظام Android

• محتوى الملف: يحتوي ملف assetlinks.json على معلومات حول تطبيقك والموقع المرتبط به.

  json [ { "relation": [ "delegate_permission/common.handle_all_urls" ], "target": { "namespace": "android.app", "package_name": "com.yourcompany.yourapp", "sha256_cert_fingerprints": [ "YOUR_APP_SHA256_FINGERPRINT" ] } } ] * استبدل com.yourcompany.yourapp باسم حزمة تطبيقك. * استبدل YOUR_APP_SHA256_FINGERPRINT ببصمة SHA256 لشهادة توقيع تطبيقك (يمكنك الحصول عليها من مخزن المفاتيح أو أدوات البناء الخاصة بك).

• متطلبات الاستضافة:

  • الموقع: يجب استضافة الملف على https://yourdomain.com/.well-known/assetlinks.json. المسار .well-known إلزامي.
  • HTTPS: يجب تقديم الملف عبر HTTPS.
  • نوع MIME: يجب أن يكون رأس Content-Type هو application/json أو application/json; charset=utf-8.

• التحقق: تتحقق أجهزة Android من هذا الملف للتحقق من الارتباط. يمكنك استخدام مدقق واجهة برمجة تطبيقات Google Asset Link للتحقق من ملف assetlinks.json الخاص بك.

3. أفضل ممارسات تكوين الخادم

• تقديم الملفات الثابتة: قم بتكوين خادم الويب الخاص بك (على سبيل المثال، Nginx أو Apache أو خدمة الاستضافة الثابتة لموفر السحابة الخاص بك) لتقديم ملفات JSON هذه مباشرة.
• التخزين المؤقت (Caching): كن حذرًا عند تخزين هذه الملفات مؤقتًا. في حين أن التخزين المؤقت يمكن أن يحسن الأداء، إلا أنه يمكن أن يؤخر أيضًا نشر التغييرات إذا قمت بتحديث تطبيقك أو ارتباط موقعك. غالبًا ما يُنصح بتعيين مدة تخزين مؤقت قصيرة أو تعطيل التخزين المؤقت لهذه الملفات المحددة.
• نوع المحتوى: تأكد من تعيين رأس Content-Type الصحيح.
• إمكانية الوصول: تأكد من أن هذه الملفات يمكن الوصول إليها بشكل عام دون الحاجة إلى المصادقة.

من خلال استضافة ملفات الارتباط هذه بشكل صحيح، يمكنك تمكين الروابط الشاملة وروابط التطبيقات، مما يوفر تجربة أكثر سلاسة وتكاملاً لمستخدميك.