美文网首页
Android Gradle 新手入门

Android Gradle 新手入门

作者: tiger桂 | 来源:发表于2017-05-03 15:25 被阅读0次

    1.  什么是Gradle?

    Gradle 是一个基于Ant和Maven概念的项目自动化建构工具。

    2.  Gradle 基本概念

    下图是很基本的Android Gradle工程,目录结构也是正常的Gradle工程的样式。下载地址

    2.1  StudyGradle/build.gradle(图标1)

    这个文件是整个项目的gradle基础配置文件:

    buildscript {// 脚步运行环境

    repositories {// 用于项目依赖

    // 中央远程仓库

    jcenter()

    }

    dependencies {

    // gradle版本

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

    // NOTE: Do not place your application dependencies here; they belong

    // in the individual module build.gradle files

    }

    }

    allprojects {

    repositories {

    jcenter()

    }

    }

    这里主要描述了两个方面:

    1. gradle 版本

    2. 仓库的源地址

    2.2  StudyGradle/app/build.gradle(图标2)

    这个文件是Module名称为app的gradle的配置文件,在此项目中是主要的gradle配置文件。

    //声明插件类型,这里声明的是Android程序

    apply plugin:'com.android.application'

    android {

    //编译SDK的版本

    compileSdkVersion22

    //build tools 的版本 对应Android SDK Build-tools

    buildToolsVersion"21.1.2"

    defaultConfig {

    //应用包名

    applicationId"com.example.dpt.studygradledemo"

    minSdkVersion21

    targetSdkVersion22

    versionCode1

    versionName"1.0"

    }

    buildTypes {//构建类型,常用的有release和debug两种,可以在这里面启用混淆,启用zipAlign以及配置签名信息等

    release {

    //是否进行混淆

    minifyEnabled false

    //混淆文件位置

    proguardFiles getDefaultProguardFile('proguard-android.txt'),'proguard-rules.pro'

    }

    }

    // 移除lint检查的error

    lintOptions {

    abortOnError false

    }

    }

    dependencies {

    // 编译依赖libs目录下的所有jar包

    compile fileTree(dir:'libs', include: ['*.jar'])

    // //应用格式: packageName:artifactId:version

    // 依赖 support-v4

    compile'com.android.support:support-v4:22.2.0'

    // 依赖 card view

    compile'com.android.support:cardview-v7:22.2.0'

    // 依赖 library module

    compile project(':demolibrary')

    compile'com.android.support:palette-v7:22.2.0'

    }

    ps:

    1. 开头第一行apply plugin: ‘com.android.application’,这表示该module是一个app module,应用了com.android.application插件,如果是一个android library,那么这里的是apply plugin: ‘com.android.library’。'com.android.application'是较新的写法,但不是最新的写法。

    2. buildToolsVersion 对应Android SDK Build-tools的版本,如图

    2.2.1  buildTypes{}

    buildTypes是构建类型,常用的有release和debug两种,可以在这里面启用混淆,启用zipAlign以及配置签名信息等。

    2.2.2  defaultConfig{}

    这里描述的是一些项目基础默认配置

    常用的属性有:versionCode,versionName,minSdkVersion,targetSdkVersion,applicationId等

    2.2.3  dependencies{}

    dependencies就不属于Android专有的配置了,它定义了该module需要依赖的jar,aar,jcenter库信息。

    1. compile fileTree(dir: 'libs', include: ['*.jar']) 编译依赖libs目录下的所有jar包

    2. compile 'com.android.support:support-v4:22.2.0' 依赖 support-v4

    3. compile project(':demolibrary') 依赖其他module

    ps:

    其中依赖开源组件的格式为:packageName:artifactId:version 例如,compile 'com.android.support:support-v4:22.2.0'

    StudyGradle/demolibrary/build.gradle(图标2)

    这个是一个依赖库的module配置文件

    //声明Android library

    apply plugin:'com.android.library'

    android {

    //编译SDK版本

    compileSdkVersion22

    //build tools 的版本 对应Android SDK Build-tools

    buildToolsVersion"21.1.2"

    defaultConfig {

    minSdkVersion21

    targetSdkVersion22

    versionCode1

    versionName"1.0"

    }

    buildTypes {

    release {

    minifyEnabled false

    proguardFiles getDefaultProguardFile('proguard-android.txt'),'proguard-rules.pro'

    }

    }

    }

    dependencies {

    compile fileTree(dir:'libs', include: ['*.jar'])

    }

    ps:

    1. 这里需要注意的是apply plugin 这里声明为Android library

    2.3  StudyGradle/build.gradle(图标3)

    这个文件是全局的项目配置文件,里面主要声明一些需要加入gradle的module

    include':app',':demolibrary'

    2.4  Gradle Wrapper(图标4)

    android studio希望你能在电脑上不安装gradle的情况下,依然使用gradle管理android项目,因此通过AS创建的每个项目都会内嵌一个gradle wrapper,作用是检查你当前的共工作环境是否安装了创建本项目时所用的gradle版本。

    如果没有,它会自动下载相应的gradle放在~/.gradle/wrapper.目录下。这样当你在你的项目里使用gradle时,可以通过gradlw命令使用当前项目环境的gradle版本,而不受环境变量的影响。

    很多人会遇到一个项目build很久,很大一部分原因就是因为这个,他会去下载自带的gradle wrapper,50多M,大部分情况下需要翻墙

    如果不能翻墙,也可以更改**gradle-wrapper.properties**的配置

    1

    2

    3

    4

    5distributionBase=GRADLE_USER_HOME

    distributionPath=wrapper/dists

    zipStoreBase=GRADLE_USER_HOME

    zipStorePath=wrapper/dists

    distributionUrl=https\://services.gradle.org/distributions/gradle-2.2.1-all.zip

    3. 打包

    3.1 Gradle Flavor

    写项目的时候经常会遇到以下的情况:

    1. 需要生成测试版本和正式版本的apk

    2. 测试版本和正式版本的URL是不一样的

    3. 测试版本和正式版本的包名需要不一致,这样才能安装到同一部手机上面。

    4. 不同apk需要应用名不同,图标不同,某些常量不同....

    >通过Productflavor你可以配置此flavor对应的包名,签名信息,版本名, 版本号等,具体可配置项可以到这里[查看](http://apdr.qiniudn.com/com.android.build.gradle.internal.dsl.ProductFlavor.html)。

    productFlavors{

    max1 {

    applicationId"com.example.dpt.gradle.max1"

    }

    x1 {

    applicationId"com.example.dpt.gradle.x1"

    }

    }

    输出所有apk

    1

    ./gradlewassemble

    输出任意flavor

    1

    ./gradlewassembleX1

    > 生成的apk在StudyGradle/app/build/outputs/apk/目录下

    3.2 简单使用场景

    3.2.1 使用不同包名

    国内应用市场、渠道众多,更换包名是最简单的需求了

    productFlavors{

    max1 {

    applicationId"com.example.dpt.gradle.max1"

    }

    x1 {

    applicationId"com.example.dpt.gradle.x1"

    }

    }

    3.2.2 buildConfig(控制变量)

    Gradle会在产生源码阶段为flavor生成一个BuildConfig.java文件。BuildConfig类默认提供了一些常量字段,比如应用的版本名(VERSION_NAME),应用的包名(PACKAGE_NAME)等。更强大的是,开发者还可以添加自定义的一些字段。

    android {

    defaultConfig {

    //自定义boolean型常量

    buildConfigField ('boolean','AUTO_UPLOAD','false')

    //自定义String型常量

    buildConfigField('String','SERVER_URI','"默认 uri"')

    }

    productFlavors{

    max1 {

    applicationId"com.example.dpt.gradle.max1"

    //自定义boolean型常量

    buildConfigField ('boolean','AUTO_UPLOAD','true')

    //自定义String型常量

    buildConfigField('String','SERVER_URI','"Max uri"')

    //自定义res常量

    resValue('string','app_name','MAX')

    }

    x1 {

    applicationId"com.example.dpt.gradle.x1"

    //自定义String型常量

    buildConfigField('String','SERVER_URI','"X1 uri"')

    //自定义res常量

    resValue('string','app_name','X1')

    }

    }

    }

    3.2.3 这还远远不够

    >如果我们想更换大量文案,图标,布局,甚至是不同版本使用有差异的控件怎么办?

    可在**src**文件夹下创建同**Flavor**,在里面可以对各种不同的Flavor,编写不同的需求。

    在Demo中,两个不同的Flavor在详情页,使用了不同的布局和控件。

    ![enter image description here](http://7d9pic.com1.z0.glb.clouddn.com/gradle_flavor.png)

    具体代码在Demo中的part2,分支

    相关文章

      网友评论

          本文标题:Android Gradle 新手入门

          本文链接:https://www.haomeiwen.com/subject/enwxvttx.html