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

1. نظرة عامة

image10.png

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

ما ستتعلمه

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

ماذا ستحتاج

  • أحدث إصدار من أندرويد ستوديو
  • ملف حزمة موقّع قمت بإنشائه من 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، لا تحتوي App Distribution على Firebase SDK لإضافتها إلى تطبيقك.
  4. انقر فوق متابعة لوحدة التحكم .
  1. في وحدة تحكم Firebase، انتقل إلى إعدادات المشروع .

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

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

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

قم بإضافة البرنامج المساعد App Distribution Gradle

الآن، ستستخدم Android Studio لإضافة 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. في ملف إعدادات 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 )، قم بإضافة المكون الإضافي 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 الخاص بك

قبل أن تتمكن من استخدام مكون 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 لإنشاء ملف حزم التطبيق الخاص بك:
    $ ./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 App Tester ، والذي يمنع إضافة الإصدارات التي تم تنزيلها إلى مجلد Downloads بجهازك. كما يعرض أيضًا معلومات إضافية حول الإصدارات، مثل تقدم التنزيل وإصدار الإصدار.

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

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

7. تهانينا!

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

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