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

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

1. نظرة عامة

image10.png

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

ماذا ستتعلم

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

ماذا ستحتاج

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

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

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

    image8.png
  3. (اختياري) عند المطالبة ، قم بتمكين Google Analytics.
  4. أكمل الخطوات المتبقية ، ثم انقر على إنشاء مشروع .

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

  1. في وحدة تحكم Firebase ، انقر على إضافة تطبيق .

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

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

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

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

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

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

  1. في ملف Gradle على مستوى المشروع ( android/build.gradle ) ، أضف المكوِّن الإضافي لـ App Distribution Gradle ومستودع Google Maven.
    buildscript {
        repositories {
            // Check that you have Google's Maven repository (if not, add it).
            google()
            mavenCentral()
        }
        dependencies {
            // Add the App Distribution Gradle plugin
            classpath `com.google.firebase:firebase-appdistribution-gradle:2.1.2`
        }
    }
    
  2. في ملف Gradle الخاص بك على مستوى التطبيق ( android/app/build.gradle ) ، أضف المكون الإضافي App Distribution:
    apply plugin: `com.android.application`
    
    // ...
    
    // Apply the App Distribution Gradle plugin
    apply plugin: `com.google.firebase.appdistribution`
    
    // ...
    
  3. إذا كنت تعمل خلف وكيل شركة أو جدار حماية ، فأضف خاصية نظام Java التالية التي تمكّن توزيع التطبيقات من تحميل توزيعاتك إلى Firebase:
    -Djavax.net.ssl.trustStore=/path/to/truststore -Djavax.net.ssl.trustStorePassword=password
    

مصادقة مشروع Firebase الخاص بك

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

  1. قم بتشغيل الأمر التالي في جذر مشروع Android الخاص بك:
    ~/your-android-project$ ./gradlew appDistributionLogin
    
  2. عندما يقوم الأمر بطباعة ارتباط المصادقة ، افتحه في المستعرض. عند المطالبة ، قم بتسجيل الدخول إلى حساب Google الخاص بك ومنح الإذن للوصول إلى مشروع Firebase الخاص بك. يقوم أمر Gradle بطباعة رمز تحديث مميز ، والذي يستخدمه المكون الإضافي App Distribution للمصادقة مع Firebase.
  3. اضبط متغير البيئة FIREBASE_TOKEN على الرمز المميز من الخطوة السابقة:
    ~/your-android-project$ export FIREBASE_TOKEN=your_firebase_token
    

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

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

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

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

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

android {

   // ...

   buildTypes {
       release {
           firebaseAppDistribution {
               appId="yourAppId"
               artifactType="AAB"
               testers="your@exampleemail.com, cerseimartell.772371@email.com"
           }
       }
   }

// ...
}

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

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

  1. قم بتشغيل مهمة bundle Variant Gradle لإنشاء ملف حزم التطبيق الخاص بك:
    $ ./gradlew :base:bundleRelease
    
  2. حدد موقع الحزمة في دليل بناء التطبيق الخاص بك (الموقع الافتراضي هو app/build/outputs/bundle/release ).
  3. لتوزيع الإصدار ، أنشئ appDistributionUploadRelease bundleRelease برنامج تضمين 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.

    image6.png
  2. قم بتسجيل الدخول باستخدام حساب Google الخاص بك واقبل الدعوة لاختبار الإصدار الموزع. كخيار ، يمكنك أيضًا تنزيل Firebase App Tester ، والذي يمنع إضافة الإصدارات التي تم تنزيلها إلى مجلد Downloads بجهازك. يعرض أيضًا معلومات إضافية حول الإصدارات ، مثل تقدم التنزيل وإصدار الإصدار.

    image9.png
  3. اضغط على تنزيل في الإصدار لتثبيته من متجر Play.
  4. عند المطالبة ، أكمل الخطوات المتبقية لتمكين مشاركة التطبيق الداخلية (يتم عرض الإرشادات على جهاز الاختبار الخاص بك وتحتاج إلى إكمالها مرة واحدة فقط).

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

7. مبروك!

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

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