توزيع إصدارات حِزم التطبيق على المختبِرين - درس تطبيقي حول الترميز

1- نظرة عامة

في هذا الدرس التطبيقي، ستتعرّف على كيفية توزيع إصدارات "مجموعة حزمات تطبيق Android" على المختبِرين باستخدام ميزة "توزيع التطبيقات من Firebase" ومكوّن Gradle الإضافي الخاص بها. توفّر ميزة App Distribution مركزًا رئيسيًا يتيح لك إدارة الإصدارات التجريبية من تطبيقك والمختبِرين الذين تدعوهم للانضمام إلى كل إصدار.

المعلومات التي ستطّلع عليها

• كيفية ربط تطبيقك على Firebase بمنصّة Google Play
• كيفية تجميع تطبيقك وإنشائه كحِزمة تطبيق
• كيفية إنشاء إصدار ومشاركته مع المختبِرين مباشرةً
• كيفية تنزيل الإصدارات الجديدة واختبارها بصفتك مختبِرًا

المتطلبات

• أحدث إصدار من استوديو Android
• ملف حزمة موقَّع أنشأته من "استوديو Android"
• حساب مطوِّر على Google Play تملك حقوق ملكيته أو المشرف عليه
• تم إعداد تطبيقك في Google Play على لوحة بيانات تطبيق Google Play، ولديه الحالة التالية:
  • يتم توزيع التطبيق على إحدى قنوات Google Play (الاختبار الداخلي أو الاختبار المغلق أو الاختبار المفتوح أو الإصدار العلني).
  • اكتملت مراجعة التطبيق في Google Play وتم نشره. يتم نشر تطبيقك إذا كان عمود حالة التطبيق يعرض إحدى الحالات التالية: الاختبار الداخلي (ليس اختبارًا داخليًا) أو الاختبار المغلق أو الاختبار المفتوح أو الإصدار العلني.
• عنوان بريد إلكتروني يمكنك استخدامه كمختبِر لتلقّي دعوات الإصدارات الجديدة من Firebase

2- إنشاء مشروع على Firebase

1. سجِّل الدخول إلى Firebase.
2. في "وحدة تحكُّم Firebase"، انقر على إضافة مشروع، ثم أدخِل اسمًا لمشروعك "AppBundlesCodelab". تذكّر رقم تعريف المشروع لمشروعك على Firebase. إذا لم تعدّل رقم تعريف المشروع، يعيّن Firebase تلقائيًا رقم تعريف فريدًا لمشروعك.
   
   
3. (اختياري) فعِّل "إحصاءات Google" عندما يُطلب منك ذلك.
4. أكمِل الخطوات المتبقية، ثم انقر على إنشاء مشروع.

إضافة حِزمة تطبيقك إلى المشروع

1. في "وحدة تحكُّم Firebase"، انقر على إضافة تطبيق.
   
   
2. عند تسجيل تطبيقك، احرص على استخدام اسم الحزمة نفسه كالتطبيق الذي تم تحميله إلى حساب المطوِّر الخاص بك على Google Play.

   ملاحظة: يجب استخدام اسم الحزمة نفسه لربط تطبيقك على Firebase بحساب المطوِّر على Google Play، وهو ما ستنفِّذه في القسم التالي.

   أخيرًا، انقر على تسجيل التطبيق.
3. أكمِل الخطوات المتبقية لإضافة ملف إعداد Firebase لتطبيقك (google-services.json) إلى تطبيقك. تجدر الإشارة إلى أنّه بالنسبة إلى نظام التشغيل Android، لا تتوفّر في ميزة App Distribution حزمة تطوير البرامج (SDK) لمنصّة Firebase لإضافتها إلى تطبيقك.
4. انقر على متابعة إلى وحدة التحكّم.

الربط بـ Google Play

1. في "وحدة تحكُّم Firebase"، انتقِل إلى إعدادات المشروع.
   
   
2. في علامة التبويب عمليات الدمج، انقر على ربط على بطاقة Google Play.
3. اتّبِع التعليمات الظاهرة على الشاشة لتفعيل دمج App Distribution، ثم اختَر تطبيق Firebase الذي تم إنشاؤه حديثًا للربط بمنصّة Google Play.

والآن بعد أن أكملت هذه الخطوات، سيتم ربط تطبيقك في Firebase بتطبيقك في حساب مطوّر برامج Google Play ما دامت أسماء الحزم متطابقة.

3- إضافة App Distribution إلى مشروعك

إضافة المكوّن الإضافي لنظام Gradle الخاص بتوزيع التطبيقات

ستستخدم الآن "استوديو Android" لإضافة App Distribution ومكون Gradle الإضافي الخاص به إلى تطبيقك.

1. في ملف Gradle على مستوى المشروع (android/build.gradle.kts)، أضِف المكوّن الإضافي App Distribution Gradle إلى الجزء plugins.

   plugins {
        //...
   
        // Add the App Distribution Gradle plugin
        id("com.google.firebase.appdistribution") version "4.0.0" apply false
   }
   

2. في ملف Settings Gradle على مستوى المشروع (android/settings.gradle.kts)، أضِف مستودع Maven من Google إلى مجموعة pluginManagement.

    pluginManagement {
        // Check that you have Google's Maven repository (if not, add it).
        repositories {
            google()
            mavenCentral()
        }
    }
   

3. في ملف Gradle على مستوى التطبيق (android/app/build.gradle.kts)، أضِف المكوّن الإضافي App Distribution إلى الجزء plugins.

   plugins {
        //...
   
        // Add the App Distribution plugin
        id("com.google.firebase.appdistribution")
   }
   

4. إذا كان لديك خادم وكيل لشركة أو جدار حماية، أضِف موقع نظام Java التالي الذي يمكِّن ميزة "توزيع التطبيقات" من تحميل توزيعاتك إلى Firebase:

   -Djavax.net.ssl.trustStore=/path/to/truststore -Djavax.net.ssl.trustStorePassword=password
   

مصادقة مشروع Firebase

ستحتاج إلى مصادقة مشروع Firebase قبل أن تتمكّن من استخدام مكوّن Gradle الإضافي. في هذا الدرس التطبيقي، ستسجِّل الدخول إلى حسابك على Google باستخدام واجهة سطر الأوامر في Firebase.

شغِّل الأمر التالي في جذر مشروع Android:

~/your-android-project$ firebase login

يمكنك الاطّلاع على المزيد من التفاصيل في المستندات المرجعية.

4. ضبط خصائص الحِزم في "استوديو Android"

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

في app/build.gradle.kts، أضِف قسم firebaseAppDistribution وأدرِج المَعلمات التالية:

• appID: رقم تعريف تطبيق Firebase لتطبيقك يمكنك العثور عليه في علامة التبويب الإعدادات العامة في إعدادات المشروع.
• artifactType: نوع ملف التطبيق (AAB)
• testers: للمختبِرين . في هذا الدرس التطبيقي حول الترميز، أضِف عنوان بريدك الإلكتروني كي تتمكّن من اختبار الإصدار بعد توزيعه.

على سبيل المثال:

    android {

       // ...

       buildTypes {
            getByName("release") {
                firebaseAppDistribution {
                  appId = "yourAppId"
                  artifactType = "AAB"
                  testers = "[e-mail], [e-mail], [e-mail]"
                }
            }
        }

        // ...
    }

يمكنك بدلاً من ذلك إلغاء القيم المحدّدة في build.gradle.kts من خلال تمرير وسيطات سطر الأوامر على شكل -PappDistribution-property-name=property-value.

5- إنشاء إصدار وتوزيعه

1. شغِّل مهمة bundleVariant Gradle لإنشاء ملف حِزم التطبيق:

   $ ./gradlew :base:bundleRelease
   

2. حدِّد موقع الحزمة في دليل الإصدار لتطبيقك (الموقع التلقائي هو app/build/outputs/bundle/release).
3. لتوزيع الإصدار، أنشِئ الهدفَين bundleRelease وappDistributionUploadRelease باستخدام برنامج تضمين مشروعك على Gradle. ضمِّن رمز Firebase المميز (الرمز الذي تلقيته في الخطوة 3: إضافة App Distribution إلى تطبيقك).

   export FIREBASE_TOKEN=your_firebase_token
   
   ./gradlew --stop // Only needed for environment variable changes
   
   ./gradlew bundleRelease appDistributionUploadRelease
   

سيتلقّى المختبِرون الآن دعوات عبر البريد الإلكتروني لتنزيل الإصدار واختباره. بصفتك المطوّر، يمكنك الآن مراقبة الإصدار في علامة التبويب الإصدارات في لوحة بيانات "توزيع التطبيقات".

6- تنزيل إصدارك واختباره

في هذا القسم، سيتم إعدادك كمختبِر لتنزيل الإصدار الذي وزّعته. بصفتك مختبِرًا، عليك مصادقة جهازك الاختباري وتفعيل ميزة "مشاركة التطبيقات مع الفريق الداخلي" في تطبيق "متجر Google Play".

1. على جهازك الاختباري، سجِّل الدخول إلى حساب البريد الإلكتروني للمختبِرين وافتح الدعوة من Firebase.
   
   
2. سجِّل الدخول باستخدام حسابك على Google واقبل الدعوة لاختبار الإصدار الموزَّع. يمكنك أيضًا تنزيل أداة اختبار التطبيقات من Firebase التي تمنع إضافة الإصدارات التي تم تنزيلها إلى مجلد Downloads على جهازك، وذلك كخيار. وتعرض أيضًا معلومات إضافية حول الإصدارات، مثل مستوى تقدّم التنزيل وإصدار الإصدار.
   
   
3. انقر على تنزيل في الإصدار لتثبيته من "متجر Play".
4. أكمِل الخطوات المتبقية لتفعيل ميزة "مشاركة التطبيقات مع الفريق الداخلي" عندما يُطلب منك ذلك (يتم عرض التعليمات على جهاز الاختبار ويجب إكمالها مرة واحدة فقط).

بعد اكتمال عملية التنزيل، سيظهر الإصدار تلقائيًا كاختصار على الشاشة الرئيسية لجهازك.

7- تهانينا

لقد استخدمت ميزة Firebase App Distribution لتحميل حِزمة تطبيق وتوزيع إصدار على المختبِرين.

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

• يمكنك الانتقال إلى مستندات توزيع التطبيقات للاطّلاع على مزيد من المعلومات حول كيفية إدارة المختبِرين لإصدارك.
• يمكنك الاطّلاع على مقالة إنشاء مجموعة حزمات تطبيق Android واختبارها للحصول على معلومات عن الأدوات الأخرى التي يمكنك استخدامها لنشر تطبيقك.