قد يكون إعداد أنشطة الويب الموثوقة أمرًا صعبًا، خاصةً إذا كنت تريد لعرض موقع الويب الخاص بك. سيرشدك هذا الدليل خلال عملية إنشاء مشروع أساسي يستخدم أنشطة الويب الموثوق بها، لتغطية جميع المشكلات.
بنهاية هذا الدليل، عليك:
- تم استخدام Bubblewrap لإنشاء تطبيق يستخدم "نشاط موثوقًا به على الويب" ويجتاز عملية إثبات الهوية.
- معرفة متى يتم استخدام مفاتيح التوقيع
- القدرة على تحديد التوقيع الذي يتم استخدامه في إنشاء تطبيق Android.
- تعرَّف على كيفية إنشاء ملف روابط مواد العرض الرقمية الأساسي.
لاتباع هذا الدليل، ستحتاج إلى:
- تثبيت Node.js 10 أو الإصدارات الأحدث على كمبيوتر التطوير.
- ربط هاتف Android أو محاكٍ به وإعداده لعملية التطوير (يمكنك تفعيل تصحيح أخطاء الجهاز عبر USB إذا استخدامك لهاتف فعلي).
- متصفح متوافق مع "النشاط الموثوق به على الويب" على هاتف التطوير. سيعمل الإصدار 72 من Chrome أو الإصدارات الأحدث. سيتم توفير الدعم في المتصفحات الأخرى قريبًا.
- موقع ويب تريد عرضه في نشاط الويب الموثوق به.
يتيح "نشاط الويب الموثوق به" لتطبيق Android تشغيل علامة تبويب متصفّح بملء الشاشة بدون أي واجهة مستخدم متصفح. تقتصر هذه الإمكانية على المواقع الإلكترونية التي تملكها، ويمكنك إثبات ذلك من خلال "روابط الأصول الرقمية" سنتحدث عنها بشكل أكبر لاحقًا.
عند تفعيل "نشاط موثوق به على الويب"، سيتحقّق المتصفّح من عملية فحص روابط مواد العرض الرقمية. هذه العملية تُسمّى إثبات الملكية. إذا تعذَّر إثبات الملكية، يعود المتصفح إلى عرض موقعك الإلكتروني علامة تبويب مخصّصة:
تثبيت أداة فقاعة المحادثة وضبطها
Bubblewrap عبارة عن مجموعة من المكتبات وأمر سطر الأوامر (CLI) لـ Node.js التي تساعد المطورين على إنشاء تطبيقات الويب التقدمية وإنشاؤها وتشغيلها داخل تطبيقات Android، باستخدام نشاط الويب الموثوق به.
يمكن تثبيت واجهة سطر الأوامر باستخدام الأمر التالي:
npm i -g @bubblewrap/cli
إعداد البيئة
عند تشغيل أداة فقاعة تفسيرية لأول مرة، ستعرض الأداة تنزيل وتثبيت التبعيات الخارجية المطلوبة. ننصح بالسماح للأداة بتنفيذ ذلك، لأنّ ذلك يضمن تهيئة التبعيات بشكل صحيح. راجِع مستندات فقاعة المحادثة لاستخدام تثبيت أدوات سطر أوامر Java (JDK) الحالية أو Android.
تهيئة وبناء المشروع
يتم تنفيذ عملية إعداد مشروع Android الذي يتضمّن تطبيق ويب تقدّمي (PWA) من خلال تشغيل الأمر init:
bubblewrap init --manifest=https://my-twa.com/manifest.json
ستقرأ أداة فقاعة تفسيرية بيان الويب، أن تطلب من المطوّرين تأكيد القيم التي سيتم استخدامها في مشروع Android وإنشاء المشروع باستخدام تلك القيم. بعد إنشاء المشروع، يمكنك إنشاء حزمة APK عن طريق تنفيذ ما يلي:
bubblewrap build
تشغيل
ستؤدي خطوة التصميم إلى إخراج ملف باسم app-release-signed.apk. يمكن تثبيت هذا الملف على
لجهاز التطوير لاختباره أو تحميله إلى "متجر Play" لإصداره.
توفّر أداة Bubblewrap أمرًا لتثبيت التطبيق واختباره على جهاز محلي. مع جهاز تطوير متصل بتشغيل الكمبيوتر:
bubblewrap install
بدلاً من ذلك، يمكن استخدام أداة adb استخدام البيانات المختلفة.
adb install app-release-signed.apk
يُفترض أن يكون التطبيق متاحًا الآن على مشغّل الجهاز. عند فتح التطبيق، ستفتح أنّ موقعك الإلكتروني تمّ إطلاقه كعلامة تبويب مخصَّصة، وليس كنشاط موثوق به على الويب، لأنّنا لم نُعدّ بعد عملية التحقّق من صحة روابط مواد العرض الرقمية، ولكن أولاً...
بدائل واجهة المستخدم الرسومية (GUI) لأداة فقاعات المحادثات
توفّر أداة إنشاء PWA واجهة مستخدم تصويرية تستخدم أداة فقاعة تفسيرية لتعزيز عملية إنشاء مشاريع "النشاط الموثوق به على الويب". اطّلِع على مزيد من التعليمات حول كيفية استخدام أداة إنشاء PWA لإنشاء تطبيق Android يفتح تطبيق PWA في مشاركة المدونة هذه.
ملاحظة حول مفاتيح التوقيع
تضع روابط مواد العرض الرقمية في الاعتبار المفتاح الذي تم توقيع حزمة APK باستخدامه، والسبب الشائع لتعذُّر إثبات الملكية هو استخدام توقيع خاطئ. (تذكّر أنّ عدم نجاح عملية إثبات الملكية سيؤدي إلى إطلاق موقعك الإلكتروني كعلامة تبويب مخصّصة مع عرض واجهة مستخدم المتصفّح في أعلى الصفحة). عندما تنشئ Bubblewrap التطبيق، سيتم إنشاء حزمة APK تتضمن إعداد مفتاح خلال خطوة init. ومع ذلك، عند نشر تطبيقك على Google Play، قد يتم إنشاء مفتاح آخر لك، وذلك استنادًا إلى الطريقة التي تختارها للتعامل مع مفاتيح التوقيع. تعرَّف على مزيد من المعلومات حول مفاتيح التوقيع وعلاقتها بتطبيق Bubblewrap وGoogle Play.
إعداد ملف رابط مواد العرض
تتألف روابط الأصول الرقمية في الأساس من ملف على موقعك الإلكتروني يشير إلى تطبيقك وبعض البيانات الوصفية في تطبيقك والتي تشير إلى موقعك الإلكتروني.
بعد إنشاء ملف assetlinks.json، يجب تحميله إلى موقعك الإلكتروني على .well-known/assetlinks.json نسبةً إلى الجذر) حتى يتمكّن المتصفّح من التحقّق من تطبيقك بشكل صحيح. يمكنك الاطّلاع على مقالة مراجعة تفصيلية حول روابط مواد العرض الرقمية للحصول على مزيد من المعلومات حول مدى ارتباطها بمفتاح التوقيع.
التحقق من المتصفح
سيحاول نشاط الويب الموثوق به الالتزام بالاختيار الافتراضي للمستخدم للمتصفح. إذا كان المتصفح الافتراضي للمستخدم يدعم أنشطة الويب الموثوقة، فسيتم تشغيله. وإذا تعذّر ذلك، سيتم اختياره إذا كان أي متصفّح مثبَّت متوافقًا مع أنشطة الويب الموثوق بها. أخيرًا، يكون السلوك الافتراضي هو الرجوع إلى وضع "علامات التبويب المخصصة".
وهذا يعني أنه إذا كنت تصحح شيئًا متعلقًا بأنشطة الويب الموثوق بها، فيجب عليك فتأكد من استخدام المتصفح الذي تعتقد أنك تستخدمه. يمكنك استخدام الأمر التالي لمعرفة المتصفِّح الذي يتم استخدامه:
> adb logcat -v brief | grep -e TWAProviderPicker
D/TWAProviderPicker(17168): Found TWA provider, finishing search: com.google.android.apps.chrome
الخطوات التالية
ونأمل، إذا كنت قد اتبعت هذا الدليل، فستحصل على نشاط موثوق به على الويب ولديك ما يكفي من معرفة لتصحيح ما يحدث عند إخفاق التحقق. إذا لم يكن كذلك، يمكنك الاطّلاع على المزيد من مفاهيم Android لمطوّري البرامج على الويب أو الإبلاغ عن مشكلة في GitHub بشأن هذه المستندات
بالنسبة للخطوات التالية، أوصيك بالبدء إنشاء رمز لتطبيقك. وبعد ذلك، يمكنك نشر تطبيقك في "متجر Play".