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

نصائح ووصفات طعام للغراب

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

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

إدارة المشاريع والمصادر

في ما يلي بعض الإعدادات لإدارة وحدات مشروعك و مصادرها. لمزيد من المعلومات عن إنشاء المشاريع والوحدات وإدارتها، يُرجى الاطّلاع على نظرة عامة على المشاريع.

تغيير إعدادات مجموعة المصادر التلقائية

يمكنك استخدام العنصر sourceSets في ملف build.gradle على مستوى الوحدة لتغيير المكان الذي يبحث فيه Gradle عن الملفات لكل مكوّن من مجموعة المصادر.

رائع

android {
  ...
  sourceSets {
    // Encapsulates configurations for the main source set.
    main {
      // Changes the directory for Java sources. The default directory is
      // 'src/main/java'.
      java.srcDirs = ['other/java']

      // When you list multiple directories, Gradle uses all of them to collect
      // sources. You should avoid specifying a directory which is a parent to one
      // or more other directories you specify.
      res.srcDirs = ['other/res1', 'other/res2']

      // For each source set, you can specify only one Android manifest.
      // The following points Gradle to a different manifest for this source set.
      manifest.srcFile 'other/AndroidManifest.xml'
      ...
    }

    // Create additional blocks to configure other source sets.
    androidTest {

      // If all the files for a source set are located under a single root
      // directory, you can specify that directory using the setRoot property.
      // When gathering sources for the source set, Gradle looks only in locations
      // relative to the root directory you specify. For example, after applying
      // the configuration below for the androidTest source set, Gradle looks for
      // Java sources only in the src/tests/java/ directory.
      setRoot 'src/tests'
      ...
    }
  }
}
...

Kotlin

android {
  ...
  sourceSets {
    // Encapsulates configurations for the main source set.
    getByName("main") {
      // Changes the directory for Java sources. The default directory is
      // 'src/main/java'.
      java.setSrcDirs("other/java")

      // When you list multiple directories, Gradle uses all of them to collect
      // sources. You should avoid specifying a directory which is a parent to one
      // or more other directories you specify.
      res.setSrcDirs("other/res1", "other/res2")

      // For each source set, you can specify only one Android manifest.
      // The following points Gradle to a different manifest for this source set.
      manifest.srcFile("other/AndroidManifest.xml")
      ...
    }

    // Create additional blocks to configure other source sets.
    androidTest {

      // If all the files for a source set are located under a single root
      // directory, you can specify that directory using the setRoot property.
      // When gathering sources for the source set, Gradle looks only in locations
      // relative to the root directory you specify. For example, after applying
      // the configuration below for the androidTest source set, Gradle looks for
      // Java sources only in the src/tests/java/ directory.
      setRoot("src/tests")
      ...
    }
  }
}
...

إدارة المكتبات والموارد التابعة

يوفّر Gradle آلية فعّالة لإدارة التبعيات، سواء كانت مكتبات عن بُعد أو وحدات مكتبات محلية.

استهداف إصدارات معيّنة باستخدام إعدادات التبعيات

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

رائع

android {...}

// Creates Gradle dependency configurations to use in the dependencies block.
configurations {
  // For variants that combine a product flavor and build type, you need to
  // intitialize a placeholder for its dependency configuration.
  freeDebugRuntimeOnly{}
  ...
}

dependencies {
    // Adds an implementation dependency only to the "free" product flavor.
    freeImplementation 'com.google.firebase:firebase-ads:21.5.1'
    // Adds a runtimeOnly dependency only to the "freeDebug" build variant.
    freeDebugRuntimeOnly fileTree(dir: 'libs', include: ['*.jar'])
    // Adds a remote binary dependency only for local tests.
    testImplementation 'junit:junit:4.12'
    // Adds a remote binary dependency only for the instrumented test APK.
    androidTestImplementation 'com.android.support.test.espresso:espresso-core:3.6.1'
}

Kotlin

android {...}

dependencies {
    // Use ""() notation for custom flavors and build types
    // Adds an implementation dependency only to the "free" product flavor.
    "freeImplementation"("com.google.firebase:firebase-ads:21.5.1")
    // Adds a runtimeOnly dependency only to the "freeDebug" build variant.
    "freeDebugRuntimeOnly"(fileTree("dir" to "libs", "include" to "*.jar"))
    // Adds a remote binary dependency only for local tests.
    testImplementation("junit:junit:4.12")
    // Adds a remote binary dependency only for the instrumented test APK.
    androidTestImplementation("com.android.support.test.espresso:espresso-core:3.6.1")
}

إنشاء إصدارات مختلفة من تطبيقك

يتيح لك Gradle والمكوّن الإضافي لنظام التشغيل Android إنشاء إصدارات مختلفة من تطبيقك من وحدة واحدة من خلال ضبط أنواع الإصدار.

ضبط رموز الإصدارات الديناميكية

بشكلٍ تلقائي، عندما ينشئ Gradle حِزم APK لمشروعك، تحتوي كل حزمة APK على معلومات الإصدار نفسها، كما هو محدّد في ملف build.gradle على مستوى الوحدة. بما أنّ "متجر Google Play" لا يسمح بتحميل حِزم APK متعددة للتطبيق نفسه تتضمّن جميعها معلومات الإصدار نفسها، عليك التأكّد من أنّ كل حزمة APK تحتوي على versionCode فريد قبل uploadedتحميلها إلى "متجر Play".

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

رائع

android {
  ...
  defaultConfig {
    ...
    versionCode 4
  }
  splits {
    ...
  }
}

// Map for the version code that gives each ABI a value.
ext.abiCodes = ['armeabi-v7a':1, mips:2, x86:3]

// For per-density APKs, create a similar map like this:
// ext.densityCodes = ['hdpi': 1, 'xhdpi': 2, 'xxhdpi': 3, 'xxxhdpi': 4]

import com.android.build.OutputFile

// For each APK output variant, override versionCode with a combination of
// ext.abiCodes * 1000 + variant.versionCode. In this example, variant.versionCode
// is equal to defaultConfig.versionCode. If you configure product flavors that
// define their own versionCode, variant.versionCode uses that value instead.
android.applicationVariants.all { variant ->

  // Assigns a different version code for each output APK
  // other than the universal APK.
  variant.outputs.each { output ->

    // Stores the value of ext.abiCodes that is associated with the ABI for this variant.
    def baseAbiVersionCode =
            // Determines the ABI for this variant and returns the mapped value.
            project.ext.abiCodes.get(output.getFilter(OutputFile.ABI))

    // Because abiCodes.get() returns null for ABIs that are not mapped by ext.abiCodes,
    // the following code does not override the version code for universal APKs.
    // However, because we want universal APKs to have the lowest version code,
    // this outcome is desirable.
    if (baseAbiVersionCode != null) {

      // Assigns the new version code to versionCodeOverride, which changes the version code
      // for only the output APK, not for the variant itself. Skipping this step simply
      // causes Gradle to use the value of variant.versionCode for the APK.
      output.versionCodeOverride =
              baseAbiVersionCode * 1000 + variant.versionCode
    }
  }
}

Kotlin

android {
  ...
  defaultConfig {
    ...
    versionCode = 4
  }
  splits {
    ...
  }
}

// Map for the version code that gives each ABI a value.
val abiCodes = mapOf("armeabi-v7a" to 1, "mips" to 2, "x86" to 3)

// For per-density APKs, create a similar map like this:
// val densityCodes = mapOf("hdpi" to 1, "xhdpi" to 2, "xxhdpi" to 3, "xxxhdpi" to 4)

import com.android.build.api.variant.FilterConfiguration.FilterType.*

// For each APK output variant, override versionCode with a combination of
// abiCodes * 1000 + variant.versionCode. In this example, variant.versionCode
// is equal to defaultConfig.versionCode. If you configure product flavors that
// define their own versionCode, variant.versionCode uses that value instead.
androidComponents {
    onVariants { variant ->

        // Assigns a different version code for each output APK
        // other than the universal APK.
        variant.outputs.forEach { output ->
            val name = output.filters.find { it.filterType == ABI }?.identifier

            // Stores the value of abiCodes that is associated with the ABI for this variant.
            val baseAbiCode = abiCodes[name]
            // Because abiCodes.get() returns null for ABIs that are not mapped by ext.abiCodes,
            // the following code does not override the version code for universal APKs.
            // However, because we want universal APKs to have the lowest version code,
            // this outcome is desirable.
            if (baseAbiCode != null) {
                // Assigns the new version code to output.versionCode, which changes the version code
                // for only the output APK, not for the variant itself.
                output.versionCode.set(baseAbiCode * 1000 + (output.versionCode.get() ?: 0))
            }
        }
    }
}

دمج عدّة أنواع من المنتجات

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

يستخدم نموذج الرمز البرمجي التالي السمة flavorDimensions لإنشاء سمة إصدار "الوضع" لتجميع إصدارَي المنتج "كامل" و "إصدار تجريبي"، وسمة إصدار "واجهة برمجة التطبيقات" لتجميع إعدادات إصدارات المنتج استنادًا إلى مستوى واجهة برمجة التطبيقات. بعد ذلك، يجمع Gradle نكهات المنتجات من سمة "الوضع" مع تلك الخاصة بسمة "واجهة برمجة التطبيقات".

رائع

android {
  ...
  buildTypes {
    debug {...}
    release {...}
  }

  // Specifies the flavor dimensions you want to use. The order in which you
  // list each dimension determines its priority, from highest to lowest,
  // when Gradle merges variant sources and configurations. You must assign
  // each product flavor you configure to one of the flavor dimensions.
  flavorDimensions "api", "mode"

  productFlavors {
    demo {
      // Assigns this product flavor to the "mode" flavor dimension.
      dimension "mode"
      ...
    }

    full {
      dimension "mode"
      ...
    }

    // Configurations in the "api" product flavors override those in "mode"
    // flavors and the defaultConfig block. Gradle determines the priority
    // between flavor dimensions based on the order in which they appear next
    // to the flavorDimensions property above--the first dimension has a higher
    // priority than the second, and so on.
    minApi24 {
      dimension "api"
      minSdkVersion '24'
      // To ensure the target device receives the version of the app with
      // the highest compatible API level, assign version codes in increasing
      // value with API level. To learn more about assigning version codes to
      // support app updates and uploading to Google Play, read Multiple APK Support
      versionCode 30000 + android.defaultConfig.versionCode
      versionNameSuffix "-minApi24"
      ...
    }

    minApi23 {
      dimension "api"
      minSdkVersion '23'
      versionCode 20000  + android.defaultConfig.versionCode
      versionNameSuffix "-minApi23"
      ...
    }

    minApi21 {
      dimension "api"
      minSdkVersion '21'
      versionCode 10000  + android.defaultConfig.versionCode
      versionNameSuffix "-minApi21"
      ...
    }
  }
}
...

Kotlin

android {
  ...
  buildTypes {
    getByName("debug") {...}
    getByName("release") {...}
  }

  // Specifies the flavor dimensions you want to use. The order in which you
  // list each dimension determines its priority, from highest to lowest,
  // when Gradle merges variant sources and configurations. You must assign
  // each product flavor you configure to one of the flavor dimensions.
  flavorDimensions += listOf("api", "mode")

  productFlavors {
    create("demo") {
      // Assigns this product flavor to the "mode" flavor dimension.
      dimension = "mode"
      ...
    }

    create("full") {
      dimension = "mode"
      ...
    }

    // Configurations in the "api" product flavors override those in "mode"
    // flavors and the defaultConfig block. Gradle determines the priority
    // between flavor dimensions based on the order in which they appear next
    // to the flavorDimensions property above--the first dimension has a higher
    // priority than the second, and so on.
    create("minApi24") {
      dimension = "api"
      minSdkVersion(24)
      // To ensure the target device receives the version of the app with
      // the highest compatible API level, assign version codes in increasing
      // value with API level. To learn more about assigning version codes to
      // support app updates and uploading to Google Play, read Multiple APK Support
      versionCode = 30000 + android.defaultConfig.versionCode
      versionNameSuffix = "-minApi24"
      ...
    }

    create("minApi23") {
      dimension = "api"
      minSdkVersion(23)
      versionCode = 20000  + android.defaultConfig.versionCode
      versionNameSuffix = "-minApi23"
      ...
    }

    create("minApi21") {
      dimension = "api"
      minSdkVersion(21)
      versionCode = 10000  + android.defaultConfig.versionCode
      versionNameSuffix = "-minApi21"
      ...
    }
  }
}
...

فلترة الأسعار المتغيرة

يمكنك فلترة أشكال التصميم التي لا تريدها باستخدام العنصر variantFilter في ملف build.gradle الخاص بالوحدة. يطلب ملف الرمز البرمجي التالي من Gradle عدم إنشاء أي أنواع تجريبية تجمع بين ملفَي طعم المنتج "minApi21" و "demo":

رائع

android {
  ...
  buildTypes {...}

  flavorDimensions "api", "mode"
  productFlavors {
    demo {...}
    full {...}
    minApi24 {...}
    minApi23 {...}
    minApi21 {...}
  }

  variantFilter { variant ->
      def names = variant.flavors*.name
      // To check for a certain build type, use variant.buildType.name == "<buildType>"
      if (names.contains("minApi21") && names.contains("demo")) {
          // Gradle ignores any variants that satisfy the conditions above.
          setIgnore(true)
      }
  }
}
...

Kotlin

android {
  ...
  buildTypes {...}

  flavorDimensions "api", "mode"
  productFlavors {
    create("demo") {...}
    create("full") {...}
    create("minApi24") {...}
    create("minApi23") {...}
    create("minApi21") {...}
  }
}

androidComponents {
    beforeVariants { variantBuilder ->
        // To check for a certain build type, use variantBuilder.buildType == "<buildType>"
        if (variantBuilder.productFlavors.containsAll(listOf("api" to "minApi21", "mode" to "demo"))) {
            // Gradle ignores any variants that satisfy the conditions above.
            variantBuilder.enabled = false
        }
    }
}
...

اختبار تطبيقك

لمزيد من المعلومات عن تنفيذ اختبارات الوحدة المحلية والمدمجة، يُرجى الاطّلاع على مقالة اختبار تطبيقك.

ضبط خيارات التدقيق

يمكنك ضبط خيارات lint معيّنة باستخدام قالب lintOptions في ملف build.gradle على مستوى الوحدة. لمزيد من المعلومات عن استخدام Lint في مشروع Android، يمكنك الاطّلاع على المقالة تحسين الرمز البرمجي باستخدام Lint.

رائع

android {
    ...
    lintOptions {
        // Turns off checks for the issue IDs you specify.
        disable 'TypographyFractions','TypographyQuotes'
        // Turns on checks for the issue IDs you specify. These checks are in
        // addition to the default lint checks.
        enable 'RtlHardcoded','RtlCompat', 'RtlEnabled'
        // To enable checks for only a subset of issue IDs and ignore all others,
        // list the issue IDs with the 'check' property instead. This property overrides
        // any issue IDs you enable or disable using the properties above.
        checkOnly 'NewApi', 'InlinedApi'
        // If set to true, turns off analysis progress reporting by lint.
        quiet true
        // if set to true (default), stops the build if errors are found.
        abortOnError false
        // if true, only report errors.
        ignoreWarnings true
    }
}
...

Kotlin

android {
    ...
    lintOptions {
        // Turns off checks for the issue IDs you specify.
        disable("TypographyFractions")
        disable("TypographyQuotes")
        // Turns on checks for the issue IDs you specify. These checks are in
        // addition to the default lint checks.
        enable("RtlHardcoded")
        enable("RtlCompat")
        enable("RtlEnabled")
        // To enable checks for only a subset of issue IDs and ignore all others,
        // list the issue IDs with the 'check' property instead. This property overrides
        // any issue IDs you enable or disable using the properties above.
        checkOnly("NewApi", "InlinedApi")
        // If set to true, turns off analysis progress reporting by lint.
        quiet = true
        // if set to true (default), stops the build if errors are found.
        abortOnError = false
        // if true, only report errors.
        ignoreWarnings = true
    }
}
...

ضبط إعدادات بيان أداة القياس

عندما ينشئ Gradle حزمة APK الاختبارية، ينشئ تلقائيًا ملف AndroidManifest.xml ويضبطه باستخدام العقدة <instrumentation>. يمكنك تغيير بعض إعدادات هذه العقدة إما عن طريق إنشاء ملف بيان آخر في مجموعة مصادر الاختبار أو ضبط ملف build.gradle على مستوى الوحدة، كما هو موضّح في نموذج الرمز البرمجي التالي.

رائع

android {
  ...
  // Each product flavor you configure can override properties in the
  // defaultConfig block. To learn more, go to Configure Product Flavors.
  defaultConfig {
    ...
    // Specifies the application ID for the test APK.
    testApplicationId "com.test.foo"
    // Specifies the fully-qualified class name of the test instrumentation runner.
    testInstrumentationRunner "android.test.InstrumentationTestRunner"
    // If set to 'true', enables the instrumentation class to start and stop profiling.
    // If set to false (default), profiling occurs the entire time the instrumentation
    // class is running.
    testHandleProfiling true
    // If set to 'true', indicates that the Android system should run the instrumentation
    // class as a functional test. The default value is 'false'
    testFunctionalTest true
  }
}
...

Kotlin

android {
  ...
  // Each product flavor you configure can override properties in the
  // defaultConfig block. To learn more, go to Configure Product Flavors.
  defaultConfig {
    ...
    // Specifies the application ID for the test APK.
    testApplicationId = "com.test.foo"
    // Specifies the fully-qualified class name of the test instrumentation runner.
    testInstrumentationRunner = "android.test.InstrumentationTestRunner"
    // If set to 'true', enables the instrumentation class to start and stop profiling.
    // If set to false (default), profiling occurs the entire time the instrumentation
    // class is running.
    testHandleProfiling = true
    // If set to 'true', indicates that the Android system should run the instrumentation
    // class as a functional test. The default value is 'false'
    testFunctionalTest = true
  }
}
...

تغيير نوع الإصدار التجريبي

يتم تلقائيًا تنفيذ جميع الاختبارات على نوع الإصدار المخصّص لتصحيح الأخطاء. يمكنك تغيير هذا الإعداد إلى نوع إنشاء آخر باستخدام السمة testBuildType فيملف build.gradle على مستوى الوحدة. على سبيل المثال، إذا أردت تنفيذ اختباراتك على نوع الإصدار "الإصدار التجريبي"، عدِّل الملف كما هو موضّح في المقتطف التالي.

رائع

android {
    ...
    testBuildType "staging"
}

Kotlin

android {
    ...
    testBuildType "staging"
}

ضبط خيارات اختبار Gradle

لتحديد الخيارات التي تغيّر طريقة تنفيذ Gradle لجميع اختباراتك، اضبط العنصر testOptions في العنصر build.gradle على مستوى الوحدة.

رائع

android {
  ...
  // Encapsulates options for running tests.
  testOptions {
    // Changes the directory where Gradle saves test reports. By default, Gradle saves test reports
    // in the path_to_your_project/module_name/build/outputs/reports/ directory.
    // '$rootDir' sets the path relative to the root directory of the current project.
    reportDir "$rootDir/test-reports"
    // Changes the directory where Gradle saves test results. By default, Gradle saves test results
    // in the path_to_your_project/module_name/build/outputs/test-results/ directory.
    // '$rootDir' sets the path relative to the root directory of the current project.
    resultsDir "$rootDir/test-results"
  }
}

Kotlin

android {
  ...
  // Encapsulates options for running tests.
  testOptions {
    // Changes the directory where Gradle saves test reports. By default, Gradle saves test reports
    // in the path_to_your_project/module_name/build/outputs/reports/ directory.
    // '$rootDir' sets the path relative to the root directory of the current project.
    reportDir "$rootDir/test-reports"
    // Changes the directory where Gradle saves test results. By default, Gradle saves test results
    // in the path_to_your_project/module_name/build/outputs/test-results/ directory.
    // '$rootDir' sets the path relative to the root directory of the current project.
    resultsDir "$rootDir/test-results"
  }
}

لتحديد خيارات لاختبارات الوحدات المحلية فقط، اضبط العنصر testOptions.unitTests.

رائع

android {
  ...
  testOptions {
    ...
    // Encapsulates options for local unit tests.
    unitTests {
      // By default, local unit tests throw an exception any time the code you are testing tries to access
      // Android platform APIs (unless you mock Android dependencies yourself or with a testing
      // framework like Mockito). However, you can enable the following property so that the test
      // returns either null or zero when accessing platform APIs, rather than throwing an exception.
      returnDefaultValues true

      // Encapsulates options for controlling how Gradle executes local unit tests. For a list
      // of all the options you can specify, read Gradle's reference documentation.
      all {
        // Sets JVM argument(s) for the test JVM(s).
        jvmArgs '-XX:MaxPermSize=256m'

        // You can also check the task name to apply options to only the tests you specify.
        if (it.name == 'testDebugUnitTest') {
          systemProperty 'debug', 'true'
        }
      }
    }
  }
}

Kotlin

android {
  ...
  testOptions {
    ...
    // Encapsulates options for local unit tests.
    unitTests {
      // By default, local unit tests throw an exception any time the code you are testing tries to access
      // Android platform APIs (unless you mock Android dependencies yourself or with a testing
      // framework like Mockito). However, you can enable the following property so that the test
      // returns either null or zero when accessing platform APIs, rather than throwing an exception.
      returnDefaultValues true

      // Encapsulates options for controlling how Gradle executes local unit tests. For a list
      // of all the options you can specify, read Gradle's reference documentation.
      all {
        // Sets JVM argument(s) for the test JVM(s).
        jvmArgs '-XX:MaxPermSize=256m'

        // You can also check the task name to apply options to only the tests you specify.
        if (it.name == 'testDebugUnitTest') {
          systemProperty 'debug', 'true'
        }
      }
    }
  }
}

تحسين الإصدار

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

تصغير الرمز

يستخدم "استوديو Android" أداة R8 التي تستهلك ملفات قواعد ProGuard من أجل تصغير الرمز البرمجي. بالنسبة إلى projects الجديدة، يستخدم "استوديو Android" ملف إعدادات تلقائيًا (proguard-android.txt) من tools/proguard/folder حزمة تطوير البرامج (SDK) لنظام التشغيل Android. لتقليل حجم الرمز البرمجي بشكل أكبر، جرِّب استخدام ملف proguard-android-optimize.txt في الموقع نفسه.

رائع

android {
  buildTypes {
    release {
      minifyEnabled true
      proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'),
                                           'proguard-rules.pro'
    }
  }
  ...
}
...

Kotlin

android {
  buildTypes {
    release {
      minifyEnabled true
      proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'),
                                           'proguard-rules.pro'
    }
  }
  ...
}
...

لإضافة قواعد خاصة بكل نوع من أنواع الإصدار، عليك ضبط سمة proguardFiles إضافية لكل نوع. على سبيل المثال، يُضيف المثال التاليflavor2-rules.pro إلى "flavor2". يستخدم الآن إصدار الإصدار من "flavor2" جميع ملفات القواعد الثلاثة لأنّه يتم أيضًا تطبيق تلك الملفات من مجموعة الإصدار.

رائع

android {
  ...
  buildTypes {
    release {
      minifyEnabled true
      proguardFiles getDefaultProguardFile('proguard-android.txt'),
             'proguard-rules.pro'
    }
  }
  productFlavors {
    flavor1 {
      ...
    }
    flavor2 {
      proguardFile 'flavor2-rules.pro'
    }
  }
}
...

Kotlin

android {
  ...
  buildTypes {
    release {
      minifyEnabled true
      proguardFiles getDefaultProguardFile('proguard-android.txt'),
             'proguard-rules.pro'
    }
  }
  productFlavors {
    flavor1 {
      ...
    }
    flavor2 {
      proguardFile 'flavor2-rules.pro'
    }
  }
}
...

نشر التطبيق

لمزيد من المعلومات حول نشر تطبيقك على Google Play، يُرجى الاطّلاع على مقالة نشر تطبيقك.

توقيع التطبيق

على الرغم من أنّ Android Studio يوفّر طريقة مباشرة لضبط التوقيع لإصدارات الإصدار من واجهة المستخدم، يمكنك ضبط القسم signingConfigs يدويًا في ملف build.gradle للوحدة:

رائع

android {
  ...
  defaultConfig { ... }

  // Encapsulates signing configurations.
  signingConfigs {
    // Creates a signing configuration called "release".
    release {
      // Specifies the path to your keystore file.
      storeFile file("my-release-key.jks")
      // Specifies the password for your keystore.
      storePassword "password"
      // Specifies the identifying name for your key.
      keyAlias "my-alias"
      // Specifies the password for your key.
      keyPassword "password"
    }
  }
  buildTypes {
    release {
      // Adds the "release" signing configuration to the release build type.
      signingConfig signingConfigs.release
      ...
    }
  }
}
...

Kotlin

android {
  ...
  defaultConfig { ... }

  // Encapsulates signing configurations.
  signingConfigs {
    // Creates a signing configuration called "release".
    release {
      // Specifies the path to your keystore file.
      storeFile file("my-release-key.jks")
      // Specifies the password for your keystore.
      storePassword "password"
      // Specifies the identifying name for your key.
      keyAlias "my-alias"
      // Specifies the password for your key.
      keyPassword "password"
    }
  }
  buildTypes {
    release {
      // Adds the "release" signing configuration to the release build type.
      signingConfig signingConfigs.release
      ...
    }
  }
}
...

إزالة معلومات التوقيع الخاص من مشروعك

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

أنشئ ملفًا باسم keystore.properties في الدليل الجذر لمشروعك وأدرِج المعلومات التالية:
```
storePassword=myStorePassword
keyPassword=myKeyPassword
keyAlias=myKeyAlias
storeFile=myStoreFileLocation
```

في ملف build.gradle، حمِّل ملف keystore.properties على النحو التالي (يجب أن يكون هذا قبل مجموعة android):

رائع

// Creates a variable called keystorePropertiesFile, and initializes it to the
// keystore.properties file.
def keystorePropertiesFile = rootProject.file("keystore.properties")

// Initializes a new Properties() object called keystoreProperties.
def keystoreProperties = new Properties()

// Loads the keystore.properties file into the keystoreProperties object.
keystoreProperties.load(new FileInputStream(keystorePropertiesFile))

android {
  ...
}
...

Kotlin

// Creates a variable called keystorePropertiesFile, and initializes it to the
// keystore.properties file.
def keystorePropertiesFile = rootProject.file("keystore.properties")

// Initializes a new Properties() object called keystoreProperties.
def keystoreProperties = new Properties()

// Loads the keystore.properties file into the keystoreProperties object.
keystoreProperties.load(new FileInputStream(keystorePropertiesFile))

android {
  ...
}
...

أدخِل معلومات التوقيع المخزّنة في عنصر keystoreProperties:

رائع

android {
  signingConfigs {
    config {
      keyAlias keystoreProperties['keyAlias']
      keyPassword keystoreProperties['keyPassword']
      storeFile file(keystoreProperties['storeFile'])
      storePassword keystoreProperties['storePassword']
    }
  }
  ...
}
...

Kotlin

android {
  signingConfigs {
    config {
      keyAlias keystoreProperties['keyAlias']
      keyPassword keystoreProperties['keyPassword']
      storeFile file(keystoreProperties['storeFile'])
      storePassword keystoreProperties['storePassword']
    }
  }
  ...
}
...

انقر على المزامنة الآن في شريط الإشعارات.

لمزيد من المعلومات حول توقيع التطبيق، يُرجى الاطّلاع على مقالة توقيع تطبيقك.

تبسيط تطوير التطبيقات

تساعدك النصائح التالية في تسهيل تطوير تطبيق Android.

في وقت الإنشاء، ينشئ Gradle فئة BuildConfig لكي يتمكّن код تطبيقك من فحص معلومات عن الإصدار الحالي. يمكنك أيضًا إضافة حقول مخصّصة إلى فئة BuildConfig من ملف إعدادات عملية إنشاء Gradle باستخدام الأسلوب buildConfigField() والوصول إلى هذه القيم في رمز وقت تشغيل تطبيقك. وبالمثل، يمكنك إضافة قيم موارد التطبيق باستخدام resValue().

رائع

android {
  ...
  buildTypes {
    release {
      // These values are defined only for the release build, which
      // is typically used for full builds and continuous builds.
      buildConfigField("String", "BUILD_TIME", "\"${minutesSinceEpoch}\"")
      resValue("string", "build_time", "${minutesSinceEpoch}")
      ...
    }
    debug {
      // Use static values for incremental builds to ensure that
      // resource files and BuildConfig aren't rebuilt with each run.
      // If these rebuild dynamically, they can interfere with
      // Apply Changes as well as Gradle UP-TO-DATE checks.
      buildConfigField("String", "BUILD_TIME", "\"0\"")
      resValue("string", "build_time", "0")
    }
  }
}
...

Kotlin

android {
  ...
  buildTypes {
    release {
      // These values are defined only for the release build, which
      // is typically used for full builds and continuous builds.
      buildConfigField("String", "BUILD_TIME", "\"${minutesSinceEpoch}\"")
      resValue("string", "build_time", "${minutesSinceEpoch}")
      ...
    }
    debug {
      // Use static values for incremental builds to ensure that
      // resource files and BuildConfig aren't rebuilt with each run.
      // If these rebuild dynamically, they can interfere with
      // Apply Changes as well as Gradle UP-TO-DATE checks.
      buildConfigField("String", "BUILD_TIME", "\"0\"")
      resValue("string", "build_time", "0")
    }
  }
}
...

في رمز تطبيقك، يمكنك الوصول إلى السمات على النحو التالي:

Kotlin

...
Log.i(TAG, BuildConfig.BUILD_TIME)
Log.i(TAG, getString(R.string.build_time))

Java

...
Log.i(TAG, BuildConfig.BUILD_TIME);
Log.i(TAG, getString(R.string.build_time));

في بعض الحالات، قد تحتاج إلى الإفصاح عن الموقع نفسه في كل من ملف البيان ورمزك (على سبيل المثال، عند الإفصاح عن الجهات المانحة للاعتماد في FileProvider). بدلاً من تعديل الموقع نفسه في مواقع متعددة لتوضيح التغيير، حدِّد موقعًا واحدًا في ملفbuild.gradle الوحدة لكي يكون متاحًا لكل من البيان ورمزك، كما هو موضّح في المثال التالي. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة إدراج متغيّرات الإنشاء في ملف البيان.

رائع

android {
  // For settings specific to a product flavor, configure these properties
  // for each flavor in the productFlavors block.
  defaultConfig {
    // Creates a property for the FileProvider authority.
    def filesAuthorityValue = applicationId + ".files"
    // Creates a placeholder property to use in the manifest.
    manifestPlaceholders =
      [filesAuthority: filesAuthorityValue]
      // Adds a new field for the authority to the BuildConfig class.
      buildConfigField("String",
                       "FILES_AUTHORITY",
                       "\"${filesAuthorityValue}\"")
  }
  ...
}
...

Kotlin

android {
  // For settings specific to a product flavor, configure these properties
  // for each flavor in the productFlavors block.
  defaultConfig {
    // Creates a property for the FileProvider authority.
    val filesAuthorityValue = applicationId + ".files"
    // Creates a placeholder property to use in the manifest.
    manifestPlaceholders["filesAuthority"] = filesAuthorityValue
      // Adds a new field for the authority to the BuildConfig class.
      buildConfigField("String",
                       "FILES_AUTHORITY",
                       "\"${filesAuthorityValue}\"")
  }
  ...
}
...

في بيان التطبيق، يمكنك الوصول إلى العنصر النائب على النحو التالي:

<manifest>
  ...
  <application>
    ...
    <provider
      android:name="android.support.v4.content.FileProvider"
      android:authorities="${filesAuthority}"
      android:exported="false"
      android:grantUriPermissions="true">
      ...
    </provider>
  </application>
</manifest>

يبدو الوصول إلى الحقل FILES_AUTHORITY في رمز تطبيقك على النحو التالي:

Kotlin

...
val contentUri: Uri = FileProvider.getUriForFile(context, BuildConfig.FILES_AUTHORITY, myFile)

Java

...
Uri contentUri = FileProvider.getUriForFile(getContext(),
  BuildConfig.FILES_AUTHORITY,
  myFile);

نصائح ووصفات طعام للغراب

إدارة المشاريع والمصادر

تغيير إعدادات مجموعة المصادر التلقائية

رائع

Kotlin

إدارة المكتبات والموارد التابعة

استهداف إصدارات معيّنة باستخدام إعدادات التبعيات

رائع

Kotlin

إنشاء إصدارات مختلفة من تطبيقك

ضبط رموز الإصدارات الديناميكية

رائع

Kotlin

دمج عدّة أنواع من المنتجات

رائع

Kotlin

فلترة الأسعار المتغيرة

رائع

Kotlin

اختبار تطبيقك

ضبط خيارات التدقيق

رائع

Kotlin

ضبط إعدادات بيان أداة القياس

رائع

Kotlin

تغيير نوع الإصدار التجريبي

رائع

Kotlin

ضبط خيارات اختبار Gradle

رائع

Kotlin

رائع

Kotlin

تحسين الإصدار

تصغير الرمز

رائع

Kotlin

رائع

Kotlin

نشر التطبيق

توقيع التطبيق

رائع

Kotlin

إزالة معلومات التوقيع الخاص من مشروعك

رائع

Kotlin

رائع

Kotlin

تبسيط تطوير التطبيقات

مشاركة الحقول المخصّصة وقيم الموارد مع رمز تطبيقك

رائع

Kotlin

Kotlin

Java

مشاركة المواقع مع البيان

رائع

Kotlin

Kotlin

Java