優雅的Android Studio項目配置--常用庫和版本管理

原文出自: http://blog.csdn.net/caroline_wendy/article/details/50552549

最近經常有人問我, 如何管理gradle版本, 我來統一講解這些小技巧.

隨著Android開發的成熟, 模塊越來越多, 為了開發穩定的程序, 引入的庫也隨之增加, 如何確保所有項目使用相同的編譯版本he庫版本呢?

當然, Gradle的參數配置可以幫我們實現這些.

1. 常用庫

apply plugin: 'me.tatarka.retrolambda'      // Lambda表達式
apply plugin: 'com.android.application'     // Android應用
apply plugin: 'com.neenbedankt.android-apt' // 編譯時類
apply plugin: 'com.android.databinding'     // 數據綁定

def cfg = rootProject.ext.configuration // 配置
def libs = rootProject.ext.libraries // 庫

android {
    compileSdkVersion cfg.compileVersion
    buildToolsVersion cfg.buildToolsVersion

    defaultConfig {
        applicationId cfg.package
        minSdkVersion cfg.minSdk
        targetSdkVersion cfg.targetSdk
        versionCode cfg.version_code
        versionName cfg.version_name

        buildConfigField "String", "MARVEL_PUBLIC_KEY", "\"${marvel_public_key}\""
        buildConfigField "String", "MARVEL_PRIVATE_KEY", "\"${marvel_private_key}\""
    }

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

    compileOptions {
        sourceCompatibility JavaVersion.VERSION_1_8
        targetCompatibility JavaVersion.VERSION_1_8
    }

    // 注釋沖突
    packagingOptions {
        exclude 'META-INF/services/javax.annotation.processing.Processor'
    }
}

dependencies {
    compile fileTree(dir: 'libs', include: ['*.jar'])
    testCompile 'junit:junit:4.12'

    // Android
    compile "com.android.support:design:${libs.supportVersion}"
    compile "com.android.support:appcompat-v7:${libs.supportVersion}"
    compile "com.android.support:cardview-v7:${libs.supportVersion}"
    compile "com.android.support:recyclerview-v7:${libs.supportVersion}"
    compile "com.android.support:palette-v7:${libs.supportVersion}"

    // Retrofit
    compile "com.squareup.retrofit:retrofit:${libs.retrofit}"
    compile "com.squareup.retrofit:converter-gson:${libs.retrofit}"
    compile "com.squareup.retrofit:adapter-rxjava:${libs.retrofit}"

    // ReactiveX
    compile "io.reactivex:rxjava:${libs.rxandroid}"
    compile "io.reactivex:rxandroid:${libs.rxandroid}"

    // Dagger
    compile "com.google.dagger:dagger:${libs.dagger}"
    apt "com.google.dagger:dagger-compiler:${libs.dagger}"
    compile "org.glassfish:javax.annotation:${libs.javax_annotation}"

    // Others
    compile "com.jakewharton:butterknife:${libs.butterknife}" // 資源注入
    compile "com.github.bumptech.glide:glide:${libs.glide}" // 圖片處理
    compile "jp.wasabeef:recyclerview-animators:${libs.recycler_animators}" // Recycler動畫
    compile "de.hdodenhof:circleimageview:${libs.circleimageview}" // 頭像視圖
}

項目版本: 
def cfg = rootProject.ext.configuration 
cfg.compileVersion 
庫版本: 
def libs = rootProject.ext.libraries 
${libs.retrofit}

2. 參數管理

buildConfigField管理私有參數, 配置在gradle.properties里面.

android {
    defaultConfig {
        buildConfigField "String", "MARVEL_PUBLIC_KEY", "\"${marvel_public_key}\""
        buildConfigField "String", "MARVEL_PRIVATE_KEY", "\"${marvel_private_key}\""
    }
}

設置參數的 類型\變量名\位置 三個部分.

marvel_public_key   = 74129ef99c9fd5f7692608f17abb88f9
marvel_private_key  = 281eb4f077e191f7863a11620fa1865f2940ebeb

未指定路徑, 默認是配置在gradle.properties中. 
兩個地方可以配置參數, 一個是項目的build.gradle, 一個是gradle.properties.

項目中使用BuildConfig.xxx引入參數.

MarvelSigningIterceptor signingIterceptor = new MarvelSigningIterceptor(
                BuildConfig.MARVEL_PUBLIC_KEY, BuildConfig.MARVEL_PRIVATE_KEY);

3. 版本管理

版本管理配置在項目的build.gradle中, 包含兩個部分, 一個是項目的版本, 一個是庫的版本. 把常用參數設置成為變量. 子項目使用 rootProject.ext.xxx 的形式引入.

ext {
    configuration = [
            package          : "me.chunyu.spike.springrainnews",
            buildToolsVersion: "23.0.1",
            compileVersion   : 23,
            minSdk           : 14,
            targetSdk        : 23,
            version_code     : 1,
            version_name     : "0.0.1",
    ]

    libraries = [
            supportVersion    : "23.1.1",
            retrofit          : "2.0.0-beta2",
            rxandroid         : "1.1.0",
            dagger            : "2.0",
            javax_annotation  : "10.0-b28",
            butterknife       : "7.0.1",
            glide             : "3.6.1",
            recycler_animators: "2.1.0",
            circleimageview   : "2.0.0"
    ]
}

buildscript {
    repositories {
        jcenter()
    }

    dependencies {
        classpath 'com.android.tools.build:gradle:2.0.0-alpha5'
        classpath 'com.neenbedankt.gradle.plugins:android-apt:1.8'
        classpath 'me.tatarka:gradle-retrolambda:3.2.4'
        classpath 'com.android.databinding:dataBinder:1.0-rc4'
    }
}

allprojects {
    repositories {
        jcenter()
    }
}

task clean(type: Delete) {
    delete rootProject.buildDir
}

通過這樣的方式管理Android項目, 可以便捷的更改版本號, 所有模塊統一.

OK, that’s all! Enjoy it!