ضبط الإصدار

يجمع نظام تصميم Android موارد التطبيق ورمز المصدر في حِزم APK أو حزمات تطبيقات Android التي يمكنك اختبارها ونشرها وتوقيعها وتوزيعها.

في مقالتَي نظرة عامة على إصدار Gradle وبنية إصدار Android، ناقشنا مفاهيم التصميم وبنية تطبيق Android. والآن، حان وقت ضبط الإصدار.

مسرد مصطلحات إصدار Android

يساعدك نظام Gradle والمكوّن الإضافي لنظام Gradle المتوافق مع Android في ضبط الجوانب التالية من إصدارك:

أنواع الإصدارات

تحدّد أنواع الإصدار بعض الخصائص التي يستخدمها Gradle عند تصميم تطبيقك وحَزمه. ويتم عادةً ضبط أنواع الإصدار لمراحل مختلفة من دورة حياة التطوير.

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

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

صيغ المنتج

تمثّل صيغ المنتج إصدارات مختلفة من تطبيقك يمكنك طرحها للمستخدمين، مثل الإصدارات المجانية والمدفوعة. يمكنك تخصيص صيغ المنتج لاستخدام رموز وموارد مختلفة مع مشاركة وإعادة استخدام الأجزاء المشتركة بين جميع إصدارات تطبيقك. صيغ المنتج اختيارية، ويجب إنشاؤها يدويًا. لبدء إنشاء إصدارات مختلفة من تطبيقك، تعرَّف على كيفية ضبط صيغ المنتجات.

تنويعات التصميم

إنّ تنويعة التصميم هي منتج مشترك بين نوع الإصدار وصيغة المنتج، وهي الإعداد الذي يستخدمه Gradle لإنشاء تطبيقك. وباستخدام تنويعات التصميم، يمكنك إنشاء إصدار تصحيح الأخطاء من صيغ منتجك أثناء عملية التطوير، وإنشاء إصدارات موقعة من صيغ منتجك لتوزيعها. على الرغم من أنّك لا تضبط إعدادات تنويعات التصميم مباشرةً، يمكنك ضبط إعدادات أنواع الإصدارات وصيغ المنتجات التي تتكوّن منها. يؤدي إنشاء أنواع إصدارات أو صيغ منتجات إضافية إلى إنشاء تنويعات إصدارات إضافية أيضًا. لمعرفة كيفية إنشاء تنويعات الإصدارات وإدارتها، يمكنك الاطّلاع على النظرة العامة حول إعداد تنويعات الإصدارات.

إدخالات البيان

يمكنك تحديد قيم لبعض خصائص ملف البيان في إعدادات تنويعة الإصدار. وتحلّ قيم الإصدار هذه محل القيم الحالية في ملف البيان. ويكون ذلك مفيدًا إذا كنت تريد إنشاء عدة صيغ من تطبيقك بأسماء تطبيقات مختلفة أو إصدارات مختلفة من حزمة تطوير البرامج (SDK) كحد أدنى أو إصدارات مختلفة من حزمة SDK المستهدَفة. عند توفّر بيانات متعددة، تدمج أداة دمج البيانات إعدادات البيانات.

الاعتمادية

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

التوقيع

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

تخفيض حجم الرموز والموارد

يتيح لك نظام التصميم تحديد ملف مختلف لقواعد ProGuard لكل تنويعة تصميم. عند إنشاء تطبيقك، يطبّق نظام التصميم المجموعة المناسبة من القواعد لتقليل حجم الرموز والموارد باستخدام أدوات تقليل الحجم المضمّنة، مثل R8. يمكن أن يساعد تقليل حجم الرموز والموارد في تقليل حجم حِزم APK أو AAB.

إتاحة حِزم APK المتعدّدة

يتيح لك نظام التصميم إنشاء حِزم APK مختلفة تلقائيًا، يحتوي كل منها على الرمز البرمجي والموارد اللازمة لكثافة شاشة أو واجهة ثنائية للتطبيق (ABI) معيّنة. لمزيد من المعلومات، يُرجى الاطّلاع على إنشاء حِزم APK متعددة. ومع ذلك، يُنصح بإصدار حزمة تطبيق واحدة بتنسيق AAB، لأنّها تتيح تقسيم التطبيق حسب اللغة بالإضافة إلى كثافة الشاشة وواجهة التطبيق الثنائية، مع تجنُّب الحاجة إلى تحميل عناصر متعددة على Google Play. يجب أن تستخدم جميع التطبيقات الجديدة التي تم إرسالها بعد أغسطس 2021 حِزم AAB.

إصدارات Java في إصدارات Android

سواء كان رمز المصدر مكتوبًا بلغة Java أو Kotlin أو كليهما، هناك عدة أماكن يجب فيها اختيار إصدار JDK أو إصدار لغة Java لإنشاء تطبيقك. لمزيد من التفاصيل، يُرجى الاطّلاع على إصدارات Java في إصدارات Android.

ملفات إعدادات التصميم

يتطلّب إنشاء إعدادات مخصّصة للتصميم إجراء تغييرات على ملف واحد أو أكثر من ملفات إعدادات التصميم. تستخدم هذه الملفات النصية العادية لغة خاصة بالنطاق (DSL) لوصف منطق الإصدار ومعالجته باستخدام نص Kotlin البرمجي، وهو أحد أشكال لغة Kotlin. يمكنك أيضًا استخدام Groovy، وهي لغة ديناميكية لآلة Java الافتراضية (JVM)، من أجل ضبط إعدادات عمليات التصميم.

للبدء في ضبط إعدادات الإصدار، لا تحتاج إلى معرفة نص Kotlin البرمجي أو Groovy، لأنّ إضافة Android Gradle توفّر معظم عناصر DSL التي تحتاج إليها. لمزيد من المعلومات حول DSL الخاص بالمكوّن الإضافي لنظام Gradle المتوافق مع Android، يُرجى الاطّلاع على مستندات مرجع DSL. تعتمد نصوص Kotlin البرمجية أيضًا على Gradle Kotlin DSL الأساسية.

عند بدء مشروع جديد، ينشئ Android Studio تلقائيًا بعضًا من هذه الملفات ويملأها استنادًا إلى الإعدادات التلقائية المناسبة. للحصول على نظرة عامة حول الملفات التي تم إنشاؤها، راجِع بنية إصدار Android.

ملف Gradle Wrapper

برنامج تضمين Gradle (gradlew) هو تطبيق صغير مضمّن في الرمز المصدر، وهو يعمل على تنزيل Gradle وتشغيله. يؤدي ذلك إلى تنفيذ عمليات تصميم أكثر اتساقًا. ينزّل المطوّرون رمز مصدر التطبيق ويشغّلون gradlew. سيؤدي ذلك إلى تنزيل حزمة Gradle المطلوبة وتشغيل Gradle لإنشاء تطبيقك.

يحتوي الملف gradle/wrapper/gradle-wrapper.properties على السمة distributionUrl التي توضّح إصدار Gradle المستخدَم لتشغيل إصدارك.

distributionBase=GRADLE_USER_HOME
distributionPath=wrapper/dists
distributionUrl=https\://services.gradle.org/distributions/gradle-8.0-bin.zip
zipStoreBase=GRADLE_USER_HOME
zipStorePath=wrapper/dists

ملف إعدادات Gradle

يقع الملف settings.gradle.kts (لغة Kotlin الخاصة بالنطاق) أو الملف settings.gradle (لغة Groovy الخاصة بالنطاق) في دليل المشروع الجذر. يحدد ملف الإعدادات هذا إعدادات المستودع على مستوى المشروع، ويخبر Gradle بالوحدات التي يجب تضمينها عند إنشاء تطبيقك. ويجب أن تحدد المشاريع المتعددة الوحدات كل وحدة يجب تضمينها في الإصدار النهائي.

في معظم المشاريع، يبدو الملف على النحو التالي تلقائيًا:

pluginManagement {

    /**
      * The pluginManagement.repositories block configures the
      * repositories Gradle uses to search or download the Gradle plugins and
      * their transitive dependencies. Gradle pre-configures support for remote
      * repositories such as JCenter, Maven Central, and Ivy. You can also use
      * local repositories or define your own remote repositories. Here we
      * define the Gradle Plugin Portal, Google's Maven repository,
      * and the Maven Central Repository as the repositories Gradle should use to look for its
      * dependencies.
      */

    repositories {
        gradlePluginPortal()
        google()
        mavenCentral()
    }
}
dependencyResolutionManagement {

    /**
      * The dependencyResolutionManagement.repositories
      * block is where you configure the repositories and dependencies used by
      * all modules in your project, such as libraries that you are using to
      * create your application. However, you should configure module-specific
      * dependencies in each module-level build.gradle file. For new projects,
      * Android Studio includes Google's Maven repository and the Maven Central
      * Repository by default, but it does not configure any dependencies (unless
      * you select a template that requires some).
      */

  repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
  repositories {
      google()
      mavenCentral()
  }
}
rootProject.name = "My Application"
include(":app")

pluginManagement {

    /**
      * The pluginManagement.repositories block configures the
      * repositories Gradle uses to search or download the Gradle plugins and
      * their transitive dependencies. Gradle pre-configures support for remote
      * repositories such as JCenter, Maven Central, and Ivy. You can also use
      * local repositories or define your own remote repositories. Here we
      * define the Gradle Plugin Portal, Google's Maven repository,
      * and the Maven Central Repository as the repositories Gradle should use to look for its
      * dependencies.
      */

    repositories {
        gradlePluginPortal()
        google()
        mavenCentral()
    }
}
dependencyResolutionManagement {

    /**
      * The dependencyResolutionManagement.repositories
      * block is where you configure the repositories and dependencies used by
      * all modules in your project, such as libraries that you are using to
      * create your application. However, you should configure module-specific
      * dependencies in each module-level build.gradle file. For new projects,
      * Android Studio includes Google's Maven repository and the Maven Central
      * Repository by default, but it does not configure any dependencies (unless
      * you select a template that requires some).
      */

    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
    }
}
rootProject.name = "My Application"
include ':app'

ملف الإنشاء ذو المستوى الأعلى

يقع ملف build.gradle.kts (لغة Kotlin الخاصة بالنطاق) أو ملف build.gradle (لغة Groovy الخاصة بالنطاق) من المستوى الأعلى في دليل المشروع الجذر. يحدّد هذا الملف عادةً الإصدارات الشائعة من المكوّنات الإضافية التي تستخدمها الوحدات في مشروعك.

يوضّح نموذج الرمز البرمجي التالي الإعدادات التلقائية وعناصر DSL في نص برمجة الإصدار ذي المستوى الأعلى بعد إنشاء مشروع جديد:

plugins {

    /**
     * Use `apply false` in the top-level build.gradle file to add a Gradle
     * plugin as a build dependency but not apply it to the current (root)
     * project. Don't use `apply false` in sub-projects. For more information,
     * see Applying external plugins with same version to subprojects.
     */

    id("com.android.application") version "8.12.0" apply false
    id("com.android.library") version "8.12.0" apply false
    id("org.jetbrains.kotlin.android") version "2.1.20" apply false
}

plugins {

    /**
     * Use `apply false` in the top-level build.gradle file to add a Gradle
     * plugin as a build dependency but not apply it to the current (root)
     * project. Don't use `apply false` in sub-projects. For more information,
     * see Applying external plugins with same version to subprojects.
     */

    id 'com.android.application' version '8.12.0' apply false
    id 'com.android.library' version '8.12.0' apply false
    id 'org.jetbrains.kotlin.android' version '2.1.20' apply false
}