دليل البدء السريع للأنشطة الموثوق بها على الويب

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

بنهاية هذا الدليل، ستتمكّن من:

  • استخدام Bubblewrap لإنشاء تطبيق يستخدم "نشاط ويب موثوق به" ويجتاز عملية التحقّق
  • معرفة متى يتم استخدام مفاتيح التوقيع
  • كن قادرًا على تحديد التوقيع الذي يتم استخدامه في إنشاء تطبيق Android.
  • تعرَّف على كيفية إنشاء ملف روابط مواد العرض الرقمية أساسي.

اتّباع هذا الدليل يتطلّب ما يلي:

  • تثبيت الإصدار 10 من Node.js أو إصدار أحدث على جهاز الكمبيوتر المخصّص للتطوير
  • هاتف Android أو محاكٍ متصل وإعداده للتطوير (تفعيل تصحيح أخطاء USB إذا كنت تستخدم هاتفًا فعليًا)
  • متصفّح متوافق مع ميزة "النشاط الموثوق به على الويب" على هاتف المطوّر
  • موقع إلكتروني تريد عرضه في "النشاط الموثوق به على الويب"

يتيح "نشاط الويب الموثوق به" لتطبيق Android تشغيل علامة تبويب متصفّح بملء الشاشة بدون أي واجهة مستخدم للمتصفّح. تقتصر هذه الميزة على المواقع الإلكترونية التي تملكها، ويمكنك إثبات ذلك من خلال إعداد روابط Digital Asset Links. سنتحدث أكثر عن هذه الميزات لاحقًا.

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

تثبيت Bubblewrap وضبطه

Bubblewrap هي مجموعة من المكتبات وأداة سطر الأوامر (CLI) لـ Node.js تساعد المطوّرين في إنشاء تطبيقات الويب التقدّمية وبنائها وتشغيلها داخل تطبيقات Android باستخدام ميزة "النشاط الموثوق به على الويب".

يمكن تثبيت واجهة سطر الأوامر باستخدام الأمر التالي:

إعداد البيئة

عند تشغيل Bubblewrap لأول مرة، سيُقدّم لك خيار تنزيل التبعيات الخارجية المطلوبة وتثبيتها تلقائيًا. ننصح بالسماح للأداة بتنفيذ ذلك، لأنّها تضمن ضبط التبعيات بشكل صحيح. اطّلِع على مستندات Bubblewrap لاستخدام حزمة Java Development Kit (JDK) أو تثبيت أدوات سطر أوامر Android الحالية.

بدء المشروع وإنشاؤه

يتم تنفيذ عملية إعداد مشروع Android الذي يتضمّن تطبيق ويب تقدّمي (PWA) من خلال تشغيل الأمر init:

ستقرأ أداة Bubblewrap بيان الويب، وتطلب من المطوّرين تأكيد القيم التي سيتم استخدامها في مشروع Android، وإنشاء المشروع باستخدام هذه القيم. بعد إنشاء المشروع، يمكنك إنشاء حزمة APK من خلال تشغيل:

تشغيل

ستؤدي خطوة الإنشاء إلى إنشاء ملف باسم app-release-signed.apk. يمكن تثبيت هذا الملف على جهاز تطوير لاختباره أو تحميله إلى "متجر Play" لإصداره.

يوفّر Bubblewrap أمرًا لتثبيت التطبيق واختباره على جهاز محلي. أثناء اتصال جهاز التطوير بالكمبيوتر، يمكنك تنفيذ ما يلي:

بدلاً من ذلك، يمكن استخدام أداة adb.

ملاحظة: توجد أداة سطر الأوامر **adb** داخل أدوات سطر الأوامر بنظام Android في التطبيق **android_sdk/platform-tools/**.

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

بدائل واجهة المستخدم الرسومية (GUI) لأداة فقاعة تفسيرية

يوفّر PWA Builder واجهة مستخدم تصويرية تستخدِم مكتبة Bubblewrap لإنشاء مشاريع "نشاط موثوق به على الويب". يمكنك العثور على مزيد من التعليمات حول كيفية استخدام أداة إنشاء تطبيقات الويب التقدّمية (PWA) لإنشاء تطبيق Android يفتح تطبيق الويب التقدّمي (PWA) في مشاركة المدوّنة هذه.

ملاحظة حول مفاتيح التوقيع

تأخذ روابط التنقل إلى مواد العرض الرقمية في الاعتبار المفتاح الذي تم توقيع حزمة APK به، ومن الأسباب الشائعة لتعذُّر إثبات الملكية استخدام توقيع غير صحيح. (تذكّر أنّ عدم نجاح عملية إثبات الملكية سيؤدي إلى إطلاق موقعك الإلكتروني كعلامة تبويب مخصّصة مع عرض واجهة مستخدم المتصفّح في أعلى الصفحة). عندما ينشئ Bubblewrap التطبيق، سيتم إنشاء حزمة APK مع إعداد مفتاح أثناء خطوة init. ومع ذلك، عند نشر تطبيقك على Google Play، قد يتم إنشاء مفتاح آخر لك، وذلك استنادًا إلى الطريقة التي تختارها للتعامل مع مفاتيح التوقيع. مزيد من المعلومات حول مفاتيح التوقيع وعلاقتها بـ Bubblewrap وGoogle Play

إعداد ملف رابط مادة العرض

تتألف روابط مواد العرض الرقمية في الأساس من ملف على موقعك الإلكتروني يشير إلى تطبيقك وبعض البيانات الوصفية في تطبيقك التي تشير إلى موقعك الإلكتروني.

بعد إنشاء ملف assetlinks.json، قم بتحميله إلى موقعك الإلكتروني على .well-known/assetlinks.json بالنسبة إلى الجذر) حتى يتمكّن المتصفّح من التحقّق من تطبيقك بشكل صحيح. اطّلِع على نظرة تفصيلية على روابط التنقل إلى مواد العرض الرقمية للحصول على مزيد من المعلومات عن كيفية ارتباطها بمفتاح التوقيع.

التحقّق من المتصفّح

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

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

الخطوات التالية

نأمل أنه إذا كنت قد اتّبعت هذا الدليل، سيكون لديك نشاط موثوق به على الويب ولديك معرفة كافية لتصحيح الأخطاء التي تحدث عند تعذُّر عملية إثبات الملكية. إذا لم يكن الأمر كذلك، يمكنك الاطّلاع على المزيد من مفاهيم Android لمطوّري الويب أو الإبلاغ عن مشكلة في GitHub بشأن هذه المستندات.

بالنسبة إلى الخطوات التالية، ننصحك بالبدء بإنشاء رمز لتطبيقك. وبعد ذلك، يمكنك نشر تطبيقك على "متجر Play".