توزيع إصدارات حزمة التطبيق على المختبرين - 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، انقر فوق إضافة Project، ثم اسم المشروع "AppBundlesCodelab". تذكر معرّف المشروع لمشروع Firebase الخاص بك. إذا لم تقم بتحرير معرف المشروع ، فسيقوم Firebase تلقائيًا بتعيين معرف فريد لمشروعك.

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

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

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

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

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

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

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

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

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

  1. في ملف Gradle مستوى المشروع الخاص بك ( android/build.gradle )، إضافة التطبيق توزيع Gradle المساعد ومستودع مخضرم جوجل.
    buildscript {
        repositories {
            // Check that you have Google's Maven repository (if not, add it).
            google()
            jcenter()
        }
        dependencies {
            // Add the App Distribution Gradle plugin
            classpath `com.google.firebase:firebase-appdistribution-gradle:2.1.2`
        }
    }
    
  2. في ملف Gradle على مستوى التطبيق الخاص بك ( android/app/build.gradle )، إضافة المساعد توزيع التطبيق:
    apply plugin: `com.android.application`
    
    // ...
    
    // Apply the App Distribution Gradle plugin
    apply plugin: `com.google.firebase.appdistribution`
    
    // ...
    
  3. إذا كنت خلف وكيل الشركة أو جدار حماية، إضافة خاصية نظام جافا التالية التي تمكن التطبيقات توزيع لتحميل توزيعات ل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 : التطبيق الخاص بك Firebase التطبيقات ID. يمكنك العثور عليها في علامة التبويب عام من إعدادات المشروع الخاص بك.
  • 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. توزيع الإصدار، بناء الأهداف 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.

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

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

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

7. مبروك!

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

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