Replace observe: Ricardo Costeira up to date this tutorial for Android Studio 2023.1.1. Irina Galata wrote the unique.
On this tutorial, you’ll study Gradle and how one can set it up in a maintainable and scalable method. By the top of this tutorial, you’ll be capable to:
- Construct your Android apps from the command line.
- Learn each Groovy and Kotlin Gradle construct information.
- Handle dependencies with Gradle.
What’s Gradle?
Gradle is an open-source build-automation system. It has the comfort of a Groovy- or Kotlin-based DSL and the benefits of Ant and Maven. With Gradle, you’ll be able to simply manipulate the construct course of and its logic to create a number of variations of your app. It’s a lot simpler to make use of and much more concise and versatile when in comparison with Ant or Maven alone.
Getting Began
Obtain the starter venture by clicking the Obtain Supplies hyperlink on the high or backside of the tutorial.
Open the venture in Android Studio, and try its construction within the Undertaking pane in Android Studio:
Take note of the information with the Gradle elephant icon and .gradle extension. These information are generated by Android Studio mechanically throughout venture creation. They’re written in Groovy and accountable for processing your venture’s construct. They comprise the mandatory information about venture construction, library dependencies, library variations and the app variations you’ll get on account of the construct course of.
Ranging from Android Studio Giraffe, Kotlin would be the default language for construct configuration. Gradle information written in Kotlin have the .gradle.kts extension. You may see that there are already a couple of within the venture, however they had been manually added. These are the Kotlin equal to the .gradle ones. Nicely, kind of — they’re pretty totally different in conduct at this level, however you’ll perceive why as you progress via the tutorial.
Exploring the Undertaking-Stage Information
Discover the construct.gradle file within the root listing of the venture. It’s referred to as a top-level (project-level) construct.gradle file. It incorporates the settings which can be utilized to all modules of the venture.
Open the file, and also you’ll see the next code:
// 1
buildscript {
// 2
repositories {
google()
mavenCentral()
}
// 3
dependencies {
classpath "com.android.instruments.construct:gradle:8.2.2"
classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:1.9.20"
}
}
// 4
allprojects {
repositories {
google()
mavenCentral()
}
}
// 5
duties.register('clear', Delete) {
delete rootProject.buildDir
}
Right here’s what’s happening, step-by-step:
- Within the
buildscript
block, you outline settings wanted to construct your venture. - Within the
repositories
block, you add names of the repositories the place Gradle ought to seek for the plugins you employ. - The
dependencies
block incorporates essential plugin dependencies — on this case the Gradle and Kotlin plugins. Don’t put your module dependencies on this block. - The construction of the
allprojects
block is much like thebuildscript
block, however right here you outline repositories for your whole modules, not for Gradle itself. Normally you don’t outline thedependencies
part forallprojects
. The dependencies for every module are totally different and may reside within the module-level construct.gradle. - A job represents a bit of labor within the construct course of. This easy one cleans up the construct information when executed. You’ll be taught extra about duties later on this tutorial.
Transferring on to Module-level Information
Now, go to the construct.gradle file within the app module listing. It incorporates dependencies — libraries {that a} module depends on — and directions for the construct course of. Every module defines its personal construct.gradle file.
// 1
plugins {
id "com.android.utility"
id "kotlin-android"
}
// 2
android {
// 3
namespace "com.kodeco.socializify"
// 4
compileSdk 34
// 5
defaultConfig {
// 6
applicationId "com.kodeco.socializify"
// 7
minSdkVersion 23
// 8
targetSdkVersion 34
// 9
versionCode 1
// 10
versionName "1.0"
}
// 11
buildFeatures {
viewBinding true
}
// 12
kotlin {
jvmToolchain(17)
}
}
// 13
dependencies {
implementation fileTree(embrace: ["*.jar"], dir: "libs")
implementation "androidx.appcompat:appcompat:1.6.1"
implementation "com.google.android.materials:materials:1.9.0"
}
The code above does the next:
- Specifies an inventory of plugins wanted to construct the module. The
com.android.utility
plugin is important with the intention to arrange the Android-specific settings of the construct course of. Right here, you can too usecom.android.library
if you happen to’re making a library module. Thekotlin-android
plugin permits you to use the Kotlin language in your module. - Within the
android
block, you place all platform-specific choices of the module. - Defining a
namespace
is important for issues like useful resource entry. This was within the AndroidManifest.xml file underneath thebundle
property, however has now migrated. - The
compileSdk
possibility signifies the API degree your app can be compiled with. In different phrases, you’ll be able to’t use options from an API increased than this worth. Right here, you’ve set the worth to make use of APIs from Android Tiramisu. - The
defaultConfig
block incorporates choices that can be utilized to all construct variations (e.g., debug, launch, and so forth) of your app by default. - The
applicationId
is the identifier of your app. It needs to be distinctive in order to efficiently publish or replace your app on the Google Play Retailer. In the event you go away it undefined, the construct system will use thenamespace
asapplicationId
. - With the intention to set the bottom API degree supported, use
minSdkVersion
. Your app is not going to be accessible within the Play Retailer for the gadgets working on decrease API ranges. - The
targetSdkVersion
parameter defines the utmost API degree your app has been examined on. That’s to say, you’re positive your app works correctly on the gadgets with this SDK model, and it doesn’t require any backward-compatibility conduct. The very best strategy is to completely take a look at an app utilizing the newest API, conserving yourtargetSdkVersion
worth equal tocompileSdk
. -
versionCode
is a numeric worth for the app model. -
versionName
is a user-friendly string for the app model. - The
buildFeatures
block helps you to allow sure options, like View binding or Compose. On this case, it’s doing the previous. - Gradle 8.2 helps JVM 17 by default, so that you pressure the venture to make use of Java 17 via Gradle’s Java toolchain assist.
- The
dependencies
block incorporates all dependencies wanted for this module. Later on this tutorial, you’ll discover out extra about managing your venture’s dependencies.