Android Gradle開發指南詳解

這篇文章主要爲大家詳細介紹了Android Gradle開發指南的相關資料,具有一定的參考價值,感興趣的小夥伴們可以參考一下

Gradle簡介

Gradle 是一個優秀的構建系統和構建工具,它允許通過插件創建自定義的構建邏輯。它具有如下一些特點:

  • 採用了 Domain Specific Language(DSL 語言) 來描述和控制構建邏輯。
  • 構建文件基於 Groovy,並且允許通過混合聲明 DSL 元素和使用代碼來控制 DSL 元素以控制自定義的構建邏輯。
  • 支持 Maven 或者 Ivy 的依賴管理。
  • 非常靈活。允許使用最好的實現,但是不會強制實現的方式。
  • 插件可以提供自己的 DSL 和 API 以供構建文件使用。
  • 良好的 API 工具供 IDE 集成。

使用Gradle方式來構建項目,主要是爲了達到如下的一些目的:

  • 讓重用代碼和資源變得更加容易
  • 讓創建同一應用程序的不同版本變得更加容易,無論是多個 apk 發佈版本還是同一個應用的不同定製版本
  • 讓構建過程變得更加容易配置,擴展和定製。
  • 整合優秀的 IDE。

構建項目基礎

文件構建

一個Gradle項目的構建過程定義在build.gradle文件中,位於項目的根目錄下。一個最簡單的Gradle純Java項目的build.gradle文件包含以下內容。

apply plugin: 'java'

上面的代碼是引入了Gradle的Java插件,這個插件提供了所有構建和測試Java應用程序所需要的東西。例如,下面是一個最簡單的Android項目的build.gradle文件的源代碼。

buildscript {
  repositories {
    google()
    jcenter()
    
  }
  dependencies {
    classpath 'com.android.tools.build:gradle:3.4.1'
  }
}

allprojects {
  repositories {
    google()
    jcenter()
    
  }
}

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

build.gradle文件

在一個Android項目中一般會出現至少2個build.gradle文件,一個是project的gradle文件,一個是app module的gradle文件。

gradle文件中會涉及很多的常用命令和代碼,它們的具體含義如下:

1.jcenter()

代碼託管庫,設置後可以在項目中引用jcenter上的開源項目,聲明在build.gradle文件的repositories閉包中。

2.gradle插件及版本號

經常會看到如下一段代碼:

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

3.Android 閉包配置

在build.gradle的Android閉包中會看到一些常用的配置,如下所示:

  • compileSdkVersion: 用於指定項目的編譯版本。
  • buildToolsVersion: 用於指定項目的構建工具的版本。
  • applicationId: 用於指定項目的包名,在創建項目的時候已經指定了包名,當要修改整個項目的包名時可以在此更改。
  • minSdkVersion: 項目最低的兼容版本。
  • targetSdkVersion:表示你在該目標版本上已經做過了充分的測試,系統將爲你的應用開啓一些最新的功能和特性。假如targetSdkVersion 爲23或者更高,那麼在Android6.0中運行這個應用時會開啓新的功能和特性;若設置成了22,只能說明你的應用程序在Android5.1系統上做過了充分的測試,Android6.0的新功能就不會啓用。
  • versionCode: 項目的版本號。
  • versionName: 項目版本號的版本名。

4.buildTypes閉包

此配置包一般會包含兩個閉包配置,一個是debug,一個release;當然也可以有其他閉包。debug閉包用於生成測試版安裝文件的配置,release閉包用於生成正式版安裝文件的配置。此文件的配置如下:

  • minifyEnabled:用於設置是否對項目的代碼進行混淆。true代表開啓,false代表關閉。
  • proguardFiles:指定混淆時使用的文件。
  • proguard-android.txt:在Android SDK 目錄下的,裏面是所有項目通用的混淆規則。
  • proguard-rules.pro:是在當前項目根目錄下的,裏面編寫當前項目特有的混淆規則。

5.dependencies閉包

Android Studio 項目開發中一共有三種依賴方式:本地依賴、庫依賴和遠程依賴。

  • 本地依賴:可以對本地的Jar包或目錄添加依賴關係。
  • 庫依賴:可以對項目中的庫模塊添加依賴關係。
  • 遠程依賴:=可以對jcenter庫上的開源項目添加依賴關係。

項目結構

Gradle遵循約定優先於配置的概念,在可能的情況儘可能提供合理的默認配置參數。Android基本的項目開始於兩個名爲“source sets”的組件,即main source code和test code。它們分別位於:src/main/和src/androidTest/文件中。
對於Java plugin和Android plugin來說,它們的Java源代碼和資源文件路徑如下:java/和resources/文件目錄中。

對於Android plugin來說,它還擁有以下特有的文件和文件夾結構:

  • AndroidManifest.xml
  • res/
  • assets/
  • aidl/
  • rs/
  • jni/

配置結構

當默認的項目結構不適用的時候,你可能需要去自定義配置它。根據Gradle文檔,重新爲Java項目配置sourceSets可以使用以下方法:

sourceSets {
  main {
    java {
      srcDir 'src/java'
    }
    resources {
      srcDir 'src/resources'
    }
  }
}

當然,也可以使用如下的配置方式:

sourceSets {
  main.java.srcDirs = ['src/java']
  main.resources.srcDirs = ['src/resources']
}

Android Plugin使用的是類似的語法。但是由於它使用的是自己的sourceSets,這些配置將會被添加在android對象中。

以下是一個示例,它使用了舊項目結構中的main源碼,並且將androidTestsourceSet組件重新映射到tests文件夾。

android {
  sourceSets {
    main {
      manifest.srcFile 'AndroidManifest.xml'
      java.srcDirs = ['src']
      resources.srcDirs = ['src']
      aidl.srcDirs = ['src']
      renderscript.srcDirs = ['src']
      res.srcDirs = ['res']
      assets.srcDirs = ['assets']
    }

    androidTest.setRoot('tests')
  }
}

以上就是本文的全部內容,希望對大家的學習有所幫助,也希望大家多多支持神馬文庫。

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章