قد يكون من الصعب إعداد "أنشطة الويب الموثوق بها"، خاصةً إذا كان كل ما تريده هو عرض موقعك الإلكتروني. سيرشدك هذا الدليل إلى إنشاء مشروع أساسي يستخدم "أنشطة الويب الموثوق بها"، ويتناول كل المشاكل المحتملة.
بنهاية هذا الدليل، ستتمكّن من:
- استخدام Bubblewrap لإنشاء تطبيق يستخدم "نشاط موثوق به على الويب" وعملية التحقق من البطاقات.
- معرفة متى يتم استخدام مفاتيح التوقيع
- كن قادرًا على تحديد التوقيع الذي يتم استخدامه في إنشاء تطبيق Android.
- تعرَّف على كيفية إنشاء ملف روابط مواد العرض الرقمية أساسي.
اتّباع هذا الدليل يتطلّب ما يلي:
- تثبيت الإصدار 10 من Node.js أو إصدار أحدث على جهاز الكمبيوتر المخصّص للتطوير
- هاتف Android أو مُحاكي تم توصيله وإعداده للتطوير (يمكنك تفعيل تصحيح أخطاء USB إذا كنت تستخدم هاتفًا فعليًا).
- متصفح متوافق مع "النشاط الموثوق به على الويب" على هاتف التطوير. يمكنك استخدام الإصدار 72 من Chrome أو الإصدارات الأحدث. وسيتم توفيرها في المتصفّحات الأخرى قريبًا.
- موقع إلكتروني تريد عرضه في "النشاط الموثوق به على الويب"
يتيح "نشاط الويب الموثوق" لتطبيق Android تشغيل علامة تبويب متصفح بملء الشاشة بدون أي واجهة مستخدم للمتصفح. تقتصر هذه الميزة على المواقع الإلكترونية التي تملكها، ويمكنك إثبات ذلك من خلال إعداد روابط مواد العرض الرقمية. سنتحدث أكثر عن هذه الميزات لاحقًا.
عند إطلاق نشاط ويب موثوق، سيتحقّق المتصفّح من أنّ عملية التحقّق من روابط التنقل إلى مواد العرض الرقمية قد اكتملت، ويُطلق على هذه العملية اسم التحقّق. إذا تعذَّر إثبات الملكية، يعود المتصفّح إلى عرض موقعك الإلكتروني كعلامة تبويب مخصّصة.
تثبيت أداة فقاعة المحادثة وضبطها
Bubblewrap هي مجموعة من المكتبات وأداة سطر برمجي (CLI) لـ Node.js تساعد المطوّرين في إنشاء تطبيقات الويب التقدّمية وبنائها وتشغيلها داخل تطبيقات Android باستخدام ميزة "النشاط الموثوق به على الويب".
يمكن تثبيت واجهة برمجة التطبيقات باستخدام الأمر التالي:
npm i -g @bubblewrap/cli
إعداد البيئة
عند تشغيل Bubblewrap لأول مرة، سيُعرض عليك تنزيل التبعيات الخارجية المطلوبة وتثبيتها تلقائيًا. ننصحك بالسماح للأداة بتنفيذ ذلك، لأنّها تضمن ضبط التبعيات بشكل صحيح. اطّلِع على مستندات Bubblewrap لاستخدام JDK (مجموعة تطوير Java) أو تثبيت أدوات سطر أوامر Android حالية.
بدء المشروع وإنشاؤه
يتم بدء مشروع Android الذي يُغلِّف تطبيقًا متوافقًا مع الأجهزة الجوّالة من خلال تشغيل الأمر init:
bubblewrap init --manifest=https://my-twa.com/manifest.json
ستقرأ أداة Bubblewrap بيان الويب، وستطلب من المطوّرين تأكيد القيم التي سيتم استخدامها في مشروع Android، وإنشاء المشروع باستخدام هذه القيم. بعد إنشاء المشروع، يمكنك إنشاء حزمة APK من خلال تشغيل:
bubblewrap build
تشغيل
ستؤدي خطوة الإنشاء إلى إنشاء ملف باسم app-release-signed.apk. يمكن تثبيت هذا الملف على جهاز تطوير للاختبار أو تحميله إلى "متجر Play" لإصداره.
يوفّر Bubblewrap أمرًا لتثبيت التطبيق واختباره على جهاز محلي. مع توصيله بجهاز الكمبيوتر، يمكنك تنفيذ ما يلي:
bubblewrap install
بدلاً من ذلك، يمكن استخدام أداة adb.
adb install app-release-signed.apk
من المفترض أن يكون التطبيق متوفّرًا الآن في مشغّل التطبيقات على الجهاز. عند فتح التطبيق، ستلاحظ أنّه يتم إطلاق موقعك الإلكتروني كعلامة تبويب مخصّصة، وليس كنشاط موثوق على الويب، ويعود سبب ذلك إلى أنّنا لم نُعدّ عملية التحقّق من روابط مواد العرض الرقمية بعد، ولكن أولاً...
بدائل واجهة المستخدم الرسومية (GUI) لأداة فقاعة تفسيرية
يوفّر PWA Builder واجهة مستخدم تصويرية تستخدِم مكتبة Bubblewrap لإنشاء مشاريع "نشاط موثوق به على الويب". يمكنك الاطّلاع على مزيد من التعليمات حول كيفية استخدام أداة إنشاء تطبيقات الويب التقدّمية لإنشاء تطبيق Android يفتح تطبيق الويب التقدّمي في مشاركة المدونة هذه.
ملاحظة حول مفاتيح التوقيع
تأخذ روابط التنقل إلى مواد العرض الرقمية في الاعتبار المفتاح الذي تم توقيع حزمة 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".