android-browser-helper، وهي مكتبة جديدة لإنشاء الأنشطة الموثوق بها على الويب.

لقد طرحنا الإصدار 1.0.0 من android-browser-helper، وهي مكتبة Android جديدة لميزة النشاط الموثوق على الويب، والتي تسهّل على المطوّرين استخدام ميزة "النشاط الموثوق على الويب" لإنشاء تطبيقات Android، بالإضافة إلى أنّها مبنية على مكتبات Android JetPack الحديثة.

أصبحت مكتبة android-browser-helper هي المكتبة المُقترَحة لإنشاء التطبيقات التي تستخدم Trusted Web Activity.

تتم استضافة المكتبة في مستودع Google Maven الرسمي، الذي يعمل بشكلٍ تلقائي فيمشاريع Android، وهو متوافق أيضًا مع AndroidX، الذي كان يمثّل مشكلة شائعة في المكتبة السابقة.

ستتم إضافة المزيد من الميزات والتحسينات على تجربة التطوير إلى هذه المكتبة. في ما يلي قائمة قصيرة بالمعلومات التي سبق أن تمت إضافتها:

  • تتعامل هذه الوظيفة مع فتح المحتوى في متصفّح متوافق مع ميزة "النشاطات الموثوق بها على الويب"، وإذا لم يكن المتصفّح مثبّتًا، تنفّذ استراتيجية احتياطية.
  • تتيح إمكانية تخصيص استراتيجية النسخ الاحتياطي، ما يتيح للمطوّرين تخصيص سلوك تطبيقهم في حال عدم تثبيت متصفّح متوافق مع ميزة "أنشطة الويب الموثوق بها". يوضّح العرض التوضيحي twa-webview-fallback كيفية استخدام استراتيجية احتياطية تستخدِم Android WebView، على سبيل المثال.
  • تسهّل عملية ضبط "أنشطة الويب الموثوق بها" التي تعمل مع مصادر متعددة، كما هو موضح في الإصدار التجريبي من twa-multi-domain]4.

يمكن إضافة المكتبة إلى تطبيق Android باستخدام التبعية التالية لتطبيق build.gradle:

dependencies {
    //...
    implementation 'com.google.androidbrowserhelper:androidbrowserhelper:2.2.0'
}

نقل البيانات من custom-tabs-client

على المطوّرين الذين كانوا يستخدمون الإصدار السابق من custom-tabs-client إجراء بعض التغييرات في تطبيقاتهم عند نقل البيانات إلى android-browser-helper.

لحسن الحظ، بالإضافة إلى استبدال استخدام المكتبة القديمة بالمكتبة الجديدة، تتضمن هذه التغييرات بشكل أساسي تغيير البحث واستبدال بعض السلاسل في AndroidManifest.xml.

في ما يلي ملخّص للأسماء التي تم تغييرها:

الاسم في custom-tabs-client (المكتبة القديمة) الاسم في android-browser-helper (المكتبة الجديدة)
android.support.customtabs.trusted.LauncherActivity com.google.androidbrowserhelper.trusted.LauncherActivity
android.support.v4.content.FileProvider androidx.core.content.FileProvider
android.support.customtabs.trusted.TrustedWebActivityService com.google.androidbrowserhelper.trusted.DelegationService

تم تعديل الإصدار التجريبي من svgomg-twa لاستخدام android-browser-helper. يعرض هذا الاختلاف كل التغييرات المطلوبة عند نقل مشروع حالي باستخدام custom-tabs-client إلى android-browser-helper.

هل فاتنا أي شيء؟

هدف برنامج android-browser-helper هو تبسيط عملية تطوير التطبيقات باستخدام أنشطة الويب الموثوق بها. وسنواصل تطوير المكتبة مع إضافة المزيد من الميزات إلى ميزة "النشاط الموثوق به على الويب".

إذا كانت هناك ميزة لا تتوفّر في "النشاطات الموثوق بها على الويب"، ننصحك بالتفكير في طرق يمكن أن تسهّل عملية التطوير باستخدام مكتبة android-browser-helper، أو إذا كان لديك سؤال حول كيفية استخدام المكتبة، يُرجى الانتقال إلى مستودع GitHub وتقديم مشكلة.

ملاحظات