android-gradle
Настройте свою сборку с помощью Gradle
Поиск…
замечания
Система сборки Android собирает ресурсы приложений и исходный код и упаковывает их в APK, которые вы можете тестировать, разворачивать, подписывать и распространять. Android Studio использует Gradle, усовершенствованный набор инструментов для сборки, чтобы автоматизировать и управлять процессом сборки, позволяя вам определять гибкие пользовательские конфигурации сборки.
Официальная документация
Почему в проекте Android Studio есть два файла build.gradle?
<PROJECT_ROOT>\app\build.gradle
специфичен для модуля приложения.
<PROJECT_ROOT>\build.gradle
- это «файл сборки верхнего уровня», где вы можете добавить параметры конфигурации, общие для всех подпроектов / модулей.
Если вы используете другой модуль в своем проекте, в качестве локальной библиотеки у вас будет другой файл build.gradle: <PROJECT_ROOT>\module\build.gradle
Файл сборки верхнего уровня
Файл build.gradle верхнего уровня, расположенный в корневом каталоге проекта, определяет конфигурации сборки, которые применяются ко всем модулям вашего проекта. По умолчанию файл сборки верхнего уровня использует buildscript {} block
для определения репозиториев Gradle и зависимостей, которые являются общими для всех модулей проекта. В следующем примере кода описываются параметры по умолчанию и элементы DSL, которые вы можете найти в файле build.gradle верхнего уровня после создания нового проекта.
buildscript {
repositories {
mavenCentral()
}
dependencies {
classpath 'com.android.tools.build:gradle:2.2.0'
classpath 'com.google.gms:google-services:3.0.0'
}
}
ext {
compileSdkVersion = 23
buildToolsVersion = "23.0.1"
}
Файл сборки на уровне модуля
Файл build.gradle на уровне модуля, расположенный в каждом каталоге <project>/<module>/
, позволяет настраивать параметры сборки для конкретного модуля, в котором он находится. Конфигурирование этих параметров сборки позволяет вам предоставлять настраиваемые параметры упаковки, такие как в качестве дополнительных типов сборки и вкусов продукта, а также переопределить параметры в манифесте main/ app
или файле build.gradle
верхнего уровня.
apply plugin: 'com.android.application'
android {
compileSdkVersion rootProject.ext.compileSdkVersion
buildToolsVersion rootProject.ext.buildToolsVersion
}
dependencies {
//.....
}
Пример файла верхнего уровня
/** * The buildscript {} block is where you configure the repositories and * dependencies for Gradle itself--meaning, you should not include dependencies * for your modules here. For example, this block includes the Android plugin for * Gradle as a dependency because it provides the additional instructions Gradle * needs to build Android app modules. */ buildscript { /** * The repositories {} block configures the repositories Gradle uses to * search or download the 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. The code below defines * JCenter as the repository Gradle should use to look for its dependencies. */ repositories { jcenter() } /** * The dependencies {} block configures the dependencies Gradle needs to use * to build your project. The following line adds Android Plugin for Gradle * version 2.0.0 as a classpath dependency. */ dependencies { classpath 'com.android.tools.build:gradle:2.0.0' } } /** * The allprojects {} block is where you configure the repositories and * dependencies used by all modules in your project, such as third-party plugins * or libraries. Dependencies that are not required by all the modules in the * project should be configured in module-level build.gradle files. For new * projects, Android Studio configures JCenter as the default repository, but it * does not configure any dependencies. */ allprojects { repositories { jcenter() } }
Пример файла модуля
/** * The first line in the build configuration applies the Android plugin for * Gradle to this build and makes the android {} block available to specify * Android-specific build options. */ apply plugin: 'com.android.application' /** * The android {} block is where you configure all your Android-specific * build options. */ android { /** * compileSdkVersion 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. * * buildToolsVersion specifies the version of the SDK build tools, command-line * utilities, and compiler that Gradle should use to build your app. You need to * download the build tools using the SDK Manager. */ compileSdkVersion 23 buildToolsVersion "23.0.3" /** * 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 { /** * applicationId uniquely identifies the package for publishing. * However, your source code should still reference the package name * defined by the package attribute in the main/AndroidManifest.xml file. */ applicationId 'com.example.myapp' // Defines the minimum API level required to run the app. minSdkVersion 14 // Specifies the API level used to test the app. targetSdkVersion 23 // 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 Proguard settings 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 allows you to create different versions of your app that can * override defaultConfig {} 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. */ productFlavors { free { applicationId 'com.example.myapp.free' } paid { applicationId 'com.example.myapp.paid' } } } /** * The dependencies {} block in the module-level build configuration file * only specifies dependencies required to build the module itself. */ dependencies { compile project(":lib") compile 'com.android.support:appcompat-v7:24.1.0' compile fileTree(dir: 'libs', include: ['*.jar']) }
Использовать archivesBaseName для изменения имени apk
Вы можете использовать имя archivesBaseName
для установки имени apk.
Например:
defaultConfig {
....
project.ext.set("archivesBaseName", "MyName-" + defaultConfig.versionName);
}
Вы получите этот результат.
MyName-X.X.X-release.apk