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

1. نظرة عامة

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

ماذا ستتعلم

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

ماذا ستحتاج

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

2. أنشئ مشروع Firebase

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

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

1. في وحدة تحكم Firebase ، انقر على إضافة التطبيق .
   
   
2. عند تسجيل التطبيق الخاص بك ، تأكد من استخدام نفس اسم الحزمة مثل التطبيق الذي تم تحميله إلى حساب مطور Google Play الخاص بك. أخيرًا ، انقر فوق تسجيل التطبيق .
3. أكمل الخطوات المتبقية لإضافة ملف تهيئة Firebase لتطبيقك ( google-services.json ) إلى تطبيقك. لاحظ أنه بالنسبة لنظام التشغيل Android ، لا يحتوي تطبيق التوزيع على Firebase SDK لإضافته إلى تطبيقك.
4. انقر فوق "متابعة" لوحدة التحكم .

رابط إلى Google Play

1. في وحدة تحكم Firebase ، انتقل إلى إعدادات المشروع .
   
   
2. في علامة التبويب "التكامل" ، انقر فوق ارتباط في بطاقة Google Play .
3. اتبع التعليمات التي تظهر على الشاشة لتمكين تكامل توزيع التطبيقات ، ثم حدد تطبيق Firebase الذي تم إنشاؤه حديثًا للربط بـ Google Play.

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

3. أضف توزيع التطبيق إلى مشروعك

أضف التطبيق الإضافي Gradle لتوزيع التطبيقات

الآن ، ستستخدم Android Studio لإضافة App Distribution ومكوِّن Gradle الإضافي إلى تطبيقك.

1. في ملف Gradle على مستوى المشروع الخاص بك ( android/build.gradle.kts ) ، أضف App Distribution Gradle plugin إلى كتلة plugins .

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

2. في ملف Gradle الخاص بالإعدادات على مستوى المشروع ( android/settings.gradle.kts ) ، أضف مستودع Google Maven إلى كتلة pluginManagement .

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

3. في ملف Gradle على مستوى التطبيق ( android/app/build.gradle.kts ) ، أضف المكوِّن الإضافي لتوزيع التطبيقات إلى كتلة 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 الخاص بك

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

قم بتشغيل الأمر التالي في جذر مشروع Android الخاص بك:

~/your-android-project$ firebase login

تحتوي الوثائق المرجعية على مزيد من التفاصيل.

4. قم بتكوين خصائص الحزمة الخاصة بك في Android Studio

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

في app/build.gradle.kts ، أضف قسم firebaseAppDistribution وقم بتضمين المعلمات التالية:

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

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

    android {

       // ...

       buildTypes {
            getByName("release") {
                firebaseAppDistribution {
                  appId = "yourAppId"
                  artifactType = "AAB"
                  testers = "ali@example.com, bri@example.com, cal@example.com"
                }
            }
        }

        // ...
    }

كخيار ، يمكنك أيضًا تجاوز القيم المعينة في build.gradle.kts الخاص بك عن طريق تمرير وسيطات سطر الأوامر في شكل -PappDistribution- property-name = property-value .

5. بناء وتوزيع الإصدار

1. قم بتشغيل مهمة bundle Variant Gradle لإنشاء ملف حزم التطبيق الخاص بك:

   $ ./gradlew :base:bundleRelease
   

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

   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 App Tester ، والذي يمنع إضافة الإصدارات التي تم تنزيلها إلى مجلد Downloads بجهازك. كما يعرض أيضًا معلومات إضافية حول الإصدارات ، مثل تقدم التنزيل وإصدار الإصدار.
   
   
3. اضغط على تنزيل في الإصدار لتثبيته من متجر Play.
4. عند المطالبة ، أكمل الخطوات المتبقية لتمكين مشاركة التطبيق الداخلي (يتم عرض الإرشادات على جهاز الاختبار الخاص بك وتحتاج إلى إكمالها مرة واحدة فقط).

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

7. مبروك!

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

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

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