نشر تطبيق Lightbuild

ميزة تجريبية: Lightbuild هي نسخة حصرية تجريبية. لا يزال تصميمه قيد التطوير، ولا يتيح بعد استخدام جميع ميزات إصدارات Android. بالنسبة إلى تطبيقات الإنتاج أو المشاريع الحالية أو التطبيقات الجديدة الطموحة، يمكنك مواصلة استخدام Kotlin DSL. تُعدّ النسخة الحصرية من Lightbuild مناسبة للتطبيقات الصغيرة والنماذج الأولية والعروض التوضيحية. لمزيد من التفاصيل حول ما يتيحه، يُرجى الاطّلاع على مقارنة Kotlin DSL وملاحظات الإصدار.

لنشر تطبيقك على Google Play، عليك إنشاء نسخة إصدار من التطبيق على هيئة مجموعة حزمات تطبيق Android، وتوقيعها باستخدام مفتاح التحميل، ثم تحميلها إلى Play Console. توضّح لك هذه الصفحة كيفية ضبط توقيع الإصدار في مشروع Lightbuild وإنشاء حزمة تطبيق موقَّعة باستخدام واجهة سطر أوامر Lightbuild.

إنشاء مفتاح تحميل

يستخدم Google Play ميزة توقيع التطبيق من Play لتوقيع حِزم APK التي يسلّمها للمستخدمين، وعليك توقيع حِزم التطبيق التي تحمّلها باستخدام مفتاح تحميل. إذا لم يكن لديك مفتاح تحميل حتى الآن، يمكنك إنشاء مفتاح باستخدام keytool، وهو مضمَّن في حزمة تطوير Java‏ (JDK):

keytool -genkey -v -keystore upload-keystore.jks -keyalg RSA -keysize 2048 -validity 10000 -alias upload

سيطلب منك الأمر إدخال كلمات مرور لملف تخزين المفاتيح والمفتاح، ثم ينشئ ملف تخزين مفاتيح باسم upload-keystore.jks في الدليل الحالي. يُرجى تخزين ملف تخزين المفاتيح في مكان آمن خارج مشروعك، وعدم إضافته إلى نظام التحكّم في الإصدارات. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة توقيع تطبيقك.

ضبط توقيع الإصدار

في ملف lightbuild.yaml الخاص بوحدة تطبيقك، أضِف حزمة signing إلى ملف release الشخصي في packaging. بدلاً من كتابة كلمات المرور في الملف، يمكنك الإشارة إلى متغيّرات البيئة باستخدام البنية ${NAME}:

android:
  packaging:
    release:
      signing:
        storeFile: "${RELEASE_STORE_FILE}"
        storePassword: "${RELEASE_STORE_PASSWORD}"
        keyAlias: "${RELEASE_KEY_ALIAS}"
        keyPassword: "${RELEASE_KEY_PASSWORD}"

عند إنشاء التطبيق، يقرأ Lightbuild كل قيمة من متغيّر البيئة الخاص بها، وبالتالي لا يتم تخزين كلمات المرور في ملفات مشروعك. لمزيد من المعلومات حول هذه الإعدادات، يُرجى الاطّلاع على الحِزم في مرجع إعدادات Lightbuild.

ملاحظة مهمة: لا تكتب كلمات المرور مباشرةً في ملفات lightbuild.yaml. فأي شخص يمكنه قراءة ملفات مشروعك، بما في ذلك سجلّ التحكّم في الإصدارات، يمكنه استخدامها لتوقيع التطبيقات باستخدام مفتاحك.

ضبط متغيرات البيئة

قبل إنشاء التطبيق، اضبط متغيّرات البيئة في الوحدة الطرفية التي تشغّل فيها واجهة سطر أوامر Lightbuild. على سبيل المثال، على نظام التشغيل macOS أو Linux:

export RELEASE_STORE_FILE="$HOME/keystores/upload-keystore.jks"
export RELEASE_STORE_PASSWORD="KEYSTORE_PASSWORD"
export RELEASE_KEY_ALIAS="upload"
export RELEASE_KEY_PASSWORD="KEY_PASSWORD"

على أجهزة Windows، في PowerShell:

$env:RELEASE_STORE_FILE = "$HOME\keystores\upload-keystore.jks"
$env:RELEASE_STORE_PASSWORD = "KEYSTORE_PASSWORD"
$env:RELEASE_KEY_ALIAS = "upload"
$env:RELEASE_KEY_PASSWORD = "KEY_PASSWORD"

استبدِل KEYSTORE_PASSWORD وKEY_PASSWORD بكلمات المرور الخاصة بك. في نظام CI، يمكنك تخزين كلمات المرور كرموز سرية، وعرضها في عملية الإنشاء كمتغيرات بيئة.

تحذير: في حال عدم ضبط أي من متغيرات البيئة هذه، سيتعذّر إنشاء جميع إصدارات وحدة تطبيقك، بما في ذلك الإصدارات المخصصة لتصحيح الأخطاء، وسيظهر خطأ مثل Missing required environment variable: RELEASE_STORE_FILE. اضبط المتغيّرات في كل بيئة تنشئ فيها تطبيقك.

إنشاء حِزمة تطبيق موقَّعة

قبل كل إصدار، عليك زيادة إعداد versionCode في ملف lightbuild.yaml الخاص بوحدة تطبيقك، وتعديل versionName إذا لزم الأمر. يتطلّب Google Play رمز إصدار أعلى لكل عملية تحميل. لمعرفة مزيد من المعلومات، يُرجى الاطّلاع على تحديد إصدار تطبيقك.

لإنشاء حِزمة تطبيق الإصدار الموقَّعة، شغِّل الأمر التالي:

lightbuild build app:app-release.aab

يكتب Lightbuild الحزمة في app/build/app-release.aab. لمعرفة المكان الذي يكتب فيه كل هدف من أهداف وحدة التطبيق مخرجاته، شغِّل الأمر lightbuild query app/... --output=files.

تحميل تطبيقك على Google Play

حمِّل حِزمة التطبيق الموقَّعة إلى Play Console. لاختبار تطبيقك قبل طرحه للمستخدمين، عليك تحميله أولاً إلى مسار اختبار داخلي. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة تحميل تطبيقك إلى Play Console.