تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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

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

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

مسرد مصطلحات تطبيقات Android

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

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

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

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

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

نكهات المنتجات

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

إنشاء الأسعار المتغيرة

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

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

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

التبعيات

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

التوقيع

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

تقليص حجم الرموز والموارد

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

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

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

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

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

إنشاء ملفات الإعداد

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

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

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

ملف Gradle Wrapper

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

يحتوي ملف gradle/wrapper/gradle-wrapper.properties على سمة distributionUrl تصف إصدار IDE IDE الذي يتم استخدامه لتشغيل عملية الإنشاء.

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 DSL) أو ملف settings.gradle (لـ Groovy DSL) في دليل المشروع الجذر. يحدِّد ملف الإعدادات هذا إعدادات المستودع على مستوى المشروع ويُعلم Gradle بالوحدات التي يجب أن يتضمّنها عند إنشاء تطبيقك. ويجب أن تحدِّد المشاريع المتعدّدة الوحدات كل وحدة يجب تضمينها في الإصدار النهائي.

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

Kotlinرائع

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 DSL) أو build.gradle (للغة Groovy DSL) من المستوى الأعلى في دليل المشروع الجذر. ويحدِّد هذا الملف عادةً الإصدارات الشائعة من الإضافات التي تستخدمها الوحدات في مشروعك.

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

Kotlinرائع

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.9.0" apply false
    id("com.android.library") version "8.9.0" apply false
    id("org.jetbrains.kotlin.android") version "2.1.10" 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.9.0' apply false
    id 'com.android.library' version '8.9.0' apply false
    id 'org.jetbrains.kotlin.android' version '2.1.10' apply false
}

/** * The first section in the build configuration applies the Android Gradle plugin * to this build and makes the android block available to specify * Android-specific build options. */ plugins { id("com.android.application") } /** * Locate (and possibly download) a JDK used to build your kotlin * source code. This also acts as a default for sourceCompatibility, * targetCompatibility and jvmTarget. Note that this does not affect which JDK * is used to run the Gradle build itself, and does not need to take into * account the JDK version required by Gradle plugins (such as the * Android Gradle Plugin) */ kotlin { jvmToolchain(11) } /** * The android block is where you configure all your Android-specific * build options. */ android { /** * The app's namespace. Used primarily to access app resources. */ namespace = "com.example.myapp" /** * compileSdk specifies the Android API level Gradle should use to * compile your app. This means your app can use the API features included in * this API level and lower. */ compileSdk = 33 /** * The defaultConfig block encapsulates default settings and entries for all * build variants and can override some attributes in main/AndroidManifest.xml * dynamically from the build system. You can configure product flavors to override * these values for different versions of your app. */ defaultConfig { // Uniquely identifies the package for publishing. applicationId = "com.example.myapp" // Defines the minimum API level required to run the app. minSdk = 21 // Specifies the API level used to test the app. targetSdk = 33 // Defines the version number of your app. versionCode = 1 // Defines a user-friendly version name for your app. versionName = "1.0" } /** * The buildTypes block is where you can configure multiple build types. * By default, the build system defines two build types: debug and release. The * debug build type is not explicitly shown in the default build configuration, * but it includes debugging tools and is signed with the debug key. The release * build type applies ProGuard settings and is not signed by default. */ buildTypes { /** * By default, Android Studio configures the release build type to enable code * shrinking, using minifyEnabled, and specifies the default ProGuard rules file. */ getByName("release") { isMinifyEnabled = true // Enables code shrinking for the release build type. proguardFiles( getDefaultProguardFile("proguard-android.txt"), "proguard-rules.pro" ) } } /** * The productFlavors block is where you can configure multiple product flavors. * This lets you create different versions of your app that can * override the defaultConfig block with their own settings. Product flavors * are optional, and the build system does not create them by default. * * This example creates a free and paid product flavor. Each product flavor * then specifies its own application ID, so that they can exist on the Google * Play Store or an Android device simultaneously. * * If you declare product flavors, you must also declare flavor dimensions * and assign each flavor to a flavor dimension. */ flavorDimensions += "tier" productFlavors { create("free") { dimension = "tier" applicationId = "com.example.myapp.free" } create("paid") { dimension = "tier" applicationId = "com.example.myapp.paid" } } /** * To override source and target compatibility (if different from the * toolchain JDK version), add the following. All of these * default to the same value as kotlin.jvmToolchain. If you're using the * same version for these values and kotlin.jvmToolchain, you can * remove these blocks. */ //compileOptions { // sourceCompatibility = JavaVersion.VERSION_11 // targetCompatibility = JavaVersion.VERSION_11 //} //kotlinOptions { // jvmTarget = "11" //} } /** * The dependencies block in the module-level build configuration file * specifies dependencies required to build only the module itself. * To learn more, go to Add build dependencies. */ dependencies { implementation(project(":lib")) implementation("androidx.appcompat:appcompat:1.7.0") implementation(fileTree(mapOf("dir" to "libs", "include" to listOf("*.jar")))) }

/** * The first line in the build configuration applies the Android Gradle plugin * to this build and makes the android block available to specify * Android-specific build options. */ plugins { id 'com.android.application' } /** * Locate (and possibly download) a JDK used to build your kotlin * source code. This also acts as a default for sourceCompatibility, * targetCompatibility and jvmTarget. Note that this does not affect which JDK * is used to run the Gradle build itself, and does not need to take into * account the JDK version required by Gradle plugins (such as the * Android Gradle Plugin) */ kotlin { jvmToolchain 11 } /** * The android block is where you configure all your Android-specific * build options. */ android { /** * The app's namespace. Used primarily to access app resources. */ namespace 'com.example.myapp' /** * compileSdk specifies the Android API level Gradle should use to * compile your app. This means your app can use the API features included in * this API level and lower. */ compileSdk 33 /** * The defaultConfig block encapsulates default settings and entries for all * build variants and can override some attributes in main/AndroidManifest.xml * dynamically from the build system. You can configure product flavors to override * these values for different versions of your app. */ defaultConfig { // Uniquely identifies the package for publishing. applicationId 'com.example.myapp' // Defines the minimum API level required to run the app. minSdk 21 // Specifies the API level used to test the app. targetSdk 33 // Defines the version number of your app. versionCode 1 // Defines a user-friendly version name for your app. versionName "1.0" } /** * The buildTypes block is where you can configure multiple build types. * By default, the build system defines two build types: debug and release. The * debug build type is not explicitly shown in the default build configuration, * but it includes debugging tools and is signed with the debug key. The release * build type applies ProGuard settings and is not signed by default. */ buildTypes { /** * By default, Android Studio configures the release build type to enable code * shrinking, using minifyEnabled, and specifies the default ProGuard rules file. */ release { minifyEnabled true // Enables code shrinking for the release build type. proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro' } } /** * The productFlavors block is where you can configure multiple product flavors. * This lets you create different versions of your app that can * override the defaultConfig block with their own settings. Product flavors * are optional, and the build system does not create them by default. * * This example creates a free and paid product flavor. Each product flavor * then specifies its own application ID, so that they can exist on the Google * Play Store or an Android device simultaneously. * * If you declare product flavors, you must also declare flavor dimensions * and assign each flavor to a flavor dimension. */ flavorDimensions "tier" productFlavors { free { dimension "tier" applicationId 'com.example.myapp.free' } paid { dimension "tier" applicationId 'com.example.myapp.paid' } } /** * To override source and target compatibility (if different from the * tool chain JDK version), add the following. All of these * default to the same value as kotlin.jvmToolchain. If you're using the * same version for these values and kotlin.jvmToolchain, you can * remove these blocks. */ //compileOptions { // sourceCompatibility JavaVersion.VERSION_11 // targetCompatibility JavaVersion.VERSION_11 //} //kotlinOptions { // jvmTarget = '11' //} } /** * The dependencies block in the module-level build configuration file * specifies dependencies required to build only the module itself. * To learn more, go to Add build dependencies. */ dependencies { implementation project(":lib") implementation 'androidx.appcompat:appcompat:1.7.0' implementation fileTree(dir: 'libs', include: ['*.jar']) }

كتالوجات الإصدارات

إذا كان الإصدار يحتوي على عدة وحدات تتضمّن تبعيات شائعة، أو إذا كان لديك عدة مشاريع مستقلة تتضمّن تبعيات شائعة، ننصحك باستخدام قائمة الإصدارات أو فاتورة المواد (BOM) لتحديد الإصدارات الشائعة.

أنظمة التصميم الأخرى

إنّ إنشاء تطبيقات Android باستخدام Bazel هو إجراء ممكن ولكنّه غير مدعوم رسميًا. لا يدعم استوديو Android مشروعات Bazel رسميًا.

للتعرّف بشكل أفضل على القيود الحالية للإنشاء باستخدام Bazel، يُرجى الاطّلاع على المشاكل المعروفة.

يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ Java وOpenJDK هما علامتان تجاريتان مسجَّلتان لشركة Oracle و/أو الشركات التابعة لها.

تاريخ التعديل الأخير: 2025-04-03 (حسب التوقيت العالمي المتفَّق عليه)

X
متابعة AndroidDev@ على X
YouTube
يمكنك زيارة قناة Android Developers على YouTube.
LinkedIn
Connect with the Android Developers community on LinkedIn

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

مسرد مصطلحات تطبيقات Android

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

إنشاء ملفات الإعداد

ملف Gradle Wrapper

ملف إعدادات Gradle

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

ملف الإنشاء على مستوى الوحدة

إعدادات حزمة تطوير البرامج (SDK) لنظام التشغيل Android

نموذج نص برمجي لإنشاء وحدة التطبيق

ملفات خصائص Gradle

إعادة ربط حزمة NDK بمسار أقصر (نظام التشغيل Windows فقط)

مزامنة المشروع مع ملفات Gradle

مجموعات المصادر

كتالوجات الإصدارات

أنظمة التصميم الأخرى

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

مسرد مصطلحات تطبيقات Android

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

إنشاء ملفات الإعداد

ملف Gradle Wrapper

ملف إعدادات Gradle

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

ملف الإنشاء على مستوى الوحدة

إعدادات حزمة تطوير البرامج (SDK) لنظام التشغيل Android

نموذج نص برمجي لإنشاء وحدة التطبيق

ملفات خصائص Gradle

إعادة ربط حزمة NDK بمسار أقصر (نظام التشغيل Windows فقط)

مزامنة المشروع مع ملفات Gradle

مجموعات المصادر

كتالوجات الإصدارات

أنظمة التصميم الأخرى

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