android-gradle Zelfstudie
Aan de slag met android-gradle

Wat is Android-gradle

android-gradle is een gradle plug-in die officieel wordt onderhouden door het ontwikkelteam van Google Tools en is de officiële build-tool sinds de aankondiging op 16 mei 2013 op de Google I / O.

Leer de basis door te lezen Configureer je build met Gradle .

Hoofdfuncties

De belangrijkste kenmerken van de Android Gradle-plug-in zijn:

• Afhankelijkheidsbeheer
• Modulaire projecten met bibliotheken
• Varianten door smaken en buildtypen
• IDE onafhankelijke builds

Overzicht

1. Download en installeer Android Studio
2. open het en maak een nieuw project met alle standaardinstellingen

In theorie kunt u gradle rechtstreeks installeren, zelf de configuratiebestanden en de mapstructuur maken. In de praktijk doet niemand dat.

Project structuur

Een projectmapstructuur ziet er meestal als volgt uit:

Plug android-gradle

Een gradle-project is meestal onderverdeeld in subproject of modules die elk een specifiek build-script bevatten.

De plug- build.gradle wordt meestal gedeclareerd in het hoofd- / topniveau build.gradle bestand:

buildscript {
    // maven repositories for dependencies
    repositories {
        jcenter()
    }
    // build script dependencies
    dependencies {
        // this is the dependency to the android build tools
        classpath 'com.android.tools.build:gradle:2.1.2'
    }
}

allprojects {
    // maven repositories for all sub-project / modules
    repositories {
        jcenter()
    }
}

In dit voorbeeld is de android-gradle plug android-gradle 2.1.2 zoals u op deze regel kunt zien:

classpath 'com.android.tools.build:gradle:2.1.2'

modules

Het project is verdeeld in modules die elk een specifiek build.gradle script bevatten. Het bestand settings.gradle vermeldt deze modules:

include ':app'

De dubbele punt : wordt enigszins gebruikt als scheidingsteken voor mappen.

Om de plug-in te gebruiken, moet deze worden toegepast bovenaan het build.gradle bestand van elke module ( app in het voorbeeld).

Voor een Android-applicatie:

apply plugin: 'com.android.application'

Voor een Android-bibliotheek:

apply plugin: 'com.android.library'

En vervolgens geconfigureerd in de android tag:

android {
  // gradle-android plugin configuration
}

Standaard Android-applicatieconfiguratie

De build.gradle gegenereerd door Android Studio voor een applicatie ziet er als volgt uit:

apply plugin: 'com.android.application'

android {
    // setup which version of the SDK to build against and
    // with what version of the build tools
    compileSdkVersion 23
    buildToolsVersion "23.0.2"

    // default app configurations
    defaultConfig {
        // this is your app unique ID
        applicationId "com.example.myapp"
        
        // devices with lower SDK version can't install the app
        minSdkVersion 14
        // target SDK version, should be the last available one and
        // match the compile one
        targetSdkVersion 23
        
        // integer and string version of your app
        versionCode 1
        versionName "1.0"
    }
    
    // default build types are "debug" and "release"
    buildTypes {
        release {
            // enable / disable proguard optimization
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
        }
    }
}

// app dependencies
dependencies {
    // any jar file in the libs folder
    compile fileTree(dir: 'libs', include: ['*.jar'])
    // test dependency
    testCompile 'junit:junit:4.12'
    // runtime dependency on the support library
    compile 'com.android.support:appcompat-v7:24.0.0'
}

Configureer uw build met Gradle leert u meer geavanceerde instellingen en opties voor de Android Gradle-plug-in en gaat dieper in op de betekenis van deze instelling.

De defaultConfig wordt zo genoemd omdat deze kan worden opgeheven met Product Flavours .

De buildTypes tag kunt u instellen hoe u uw app te bouwen waardoor optimalisatie (zoals proguard), kunt u meer informatie lezen Build Types . Het kan ook worden gebruikt om het ondertekenen van uw app in te stellen.

U moet ook meer leren over het aangeven van afhankelijkheden . Zoals je ziet, bevindt de dependencies tag zich buiten de android tag: dit betekent dat het niet wordt gedefinieerd door de Android-plug-in, maar dat het standaardgradiënt gradle .

The Gradle Wrapper

Android Studio installeert standaard ook een geleidelijke wrapper . Dit is een hulpmiddel dat u rechtstreeks vanaf de opdrachtregel kunt uitvoeren en het zal een lokale specifieke versie van gradle downloaden de eerste keer dat u het uitvoert.

Om de app te compileren, kunt u vervolgens de gradle wrapper starten

Linux / Mac:

./gradlew assemble

Ramen:

gradlew assemble

Het script start de wrapper, die zich in een gradle map in de hoofdmap van uw project bevindt:

• gradle-wrapper.jar : de code van de wrapper om gradle te downloaden en uit te voeren
• gradle-wrapper.properties definiëren welke gradelversie de wrapper moet downloaden

Externe links:

• Officiële Android Build Tools-documentatie
• Officiële Android Gradle Plugin-documentatie
• Stackoverflow gradle documentatie
• Officiële gradle documentatie