文章摘要
1笋婿、 創(chuàng)建庫模塊
2、以依賴的方式使用庫
3顿颅、開發(fā)注意事項(xiàng)
4缸濒、aar文件詳解
Android 庫在結(jié)構(gòu)上與 Android 應(yīng)用模塊相同。它可以提供構(gòu)建應(yīng)用所需的一切內(nèi)容元镀，包括源代碼绍填、資源文件和 Android 清單。不過栖疑，Android 庫將編譯到您可以用作 Android 應(yīng)用模塊依賴項(xiàng)的 Android 歸檔 (AAR) 文件讨永，而不是在設(shè)備上運(yùn)行的 APK。與 JAR 文件不同遇革，AAR 文件可以包含 Android 資源和一個(gè)清單文件卿闹，這樣寡壮，除了 Java 類與方法外涛贯，您還可以捆綁布局和可繪制對(duì)象等共享資源佩番。
庫模塊在以下情況下非常有用：
- 1清酥、構(gòu)建使用某些相同組件（例如 Activity、服務(wù)或 UI 布局）的多個(gè)應(yīng)用凰锡。
- 2昼牛、構(gòu)建存在多個(gè) APK 變體（例如免費(fèi)版本和付費(fèi)版本）的應(yīng)用并且需要在兩種版本中使用相同的核心組件统台。
在任何一種情況下奄容，只需要將您希望重用的文件移動(dòng)到庫模塊中冰更，然后以依賴項(xiàng)的形式為每個(gè)應(yīng)用模塊添加庫。本頁面將說明如何執(zhí)行這兩個(gè)操作昂勒。
一蜀细、創(chuàng)建庫模塊
要在您的項(xiàng)目中創(chuàng)建一個(gè)新的庫模塊，請(qǐng)按以下步驟操作：
1戈盈、點(diǎn)擊 File > New > New Module奠衔。
-
2谆刨、在出現(xiàn)的 Create New Module 窗口中，依次點(diǎn)擊 Android Library 和 Next归斤。
還存在一個(gè)用于創(chuàng)建 Java 庫的選項(xiàng)痊夭，可以構(gòu)建傳統(tǒng)的 JAR 文件。盡管 JAR 文件在大多數(shù)項(xiàng)目中都非常實(shí)用（尤其在您希望與其他平臺(tái)共享代碼時(shí)）官册，但這種文件不允許您包含 Android 資源或清單文件生兆，而后者對(duì)于 Android 項(xiàng)目中的代碼重用非常有用难捌。因此膝宁，本指南將側(cè)重論述創(chuàng)建 Android 庫。
3根吁、為您的庫命名员淫，并為庫中代碼選擇一個(gè)最低的 SDK 版本，然后點(diǎn)擊 Finish击敌。
在 Gradle 項(xiàng)目同步完成后介返，庫模塊將顯示左側(cè)的 Project 面板中。如果您未看到新模塊文件夾沃斤，請(qǐng)確保將視圖切換為 Android 視圖圣蝎。
1.1、將應(yīng)用模塊轉(zhuǎn)換為庫模塊
如果您現(xiàn)有的應(yīng)用模塊包含您希望重用的所有代碼衡瓶，則可以按照以下步驟將其轉(zhuǎn)換為庫模塊：
- 1徘公、打開現(xiàn)有應(yīng)用模塊的 build.gradle 文件。您應(yīng)在頂部看到以下內(nèi)容：
apply plugin: 'com.android.application'
- 2哮针、按照下面所示更改插件分配：
apply plugin: 'com.android.library'
- 3关面、點(diǎn)擊 Sync Project with Gradle Files。
就這么簡單十厢。模塊的整個(gè)結(jié)構(gòu)仍然相同等太，但是現(xiàn)在它將作為 Android 庫運(yùn)行，構(gòu)建也將創(chuàng)建一個(gè) AAR 文件蛮放，而不是 APK缩抡。
二、以依賴項(xiàng)形式添加您的庫
要在另一個(gè)應(yīng)用模塊中使用您的 Android 庫的代碼包颁，請(qǐng)按以下步驟操作：
-
1瞻想、通過兩種方式之一將庫添加到您的項(xiàng)目（如果您是在相同項(xiàng)目中創(chuàng)建的庫模塊，則該模塊已經(jīng)存在徘六，您可以跳過此步驟）：
- 1.1内边、添加已編譯的 AAR（或 JAR）文件：
- 1.1.1、點(diǎn)擊 File > New Module待锈。
- 1.1.2漠其、依次點(diǎn)擊 Import .JAR/.AAR Package 和 Next。
- 1.1.3、輸入 AAR 或 JAR 文件的位置和屎，然后點(diǎn)擊 Finish拴驮。
- 1.2、將庫模塊導(dǎo)入到您的項(xiàng)目中：
- 1.2.1柴信、點(diǎn)擊 File > New > Import Module套啤。
- 1.2.2、輸入庫模塊目錄的位置随常，然后點(diǎn)擊 Finish潜沦。
庫模塊將復(fù)制到您的項(xiàng)目中，因此您可以盡管編輯庫代碼绪氛。如果您希望維護(hù)一個(gè)版本的庫代碼唆鸡，則此方法可能不是您想要的，您應(yīng)按照上文所述導(dǎo)入編譯的 AAR 文件枣察。
- 1.1内边、添加已編譯的 AAR（或 JAR）文件：
2争占、確保庫列在您 settings.gradle 文件的頂部，如下面名為“my-library-module”的庫所示：
include ':app', ':my-library-module'
- 3序目、打開應(yīng)用模塊的 build.gradle 文件臂痕，并向 dependencies 塊中添加一行新代碼，如下面的片段所示：
dependencies {
compile project(":my-library-module")
}
- 4猿涨、點(diǎn)擊 Sync Project with Gradle Files握童。
在上面的示例中，名為 my-library- module 的 Android 庫模塊成為 build.gradle 文件所在模塊的構(gòu)建依賴項(xiàng)嘿辟。
您的應(yīng)用模塊現(xiàn)在可以訪問 Android 庫中的任何代碼和資源舆瘪，庫 AAR 文件在構(gòu)建時(shí)已捆綁到您的 APK 中。
不過红伦，如果希望單獨(dú)共享 AAR 文件英古，則可以在 項(xiàng)目名稱/模塊名稱/build/outputs/aar/ 中找到它，也可以通過點(diǎn)擊 Build > Make Project 的方式重新生成此文件昙读。
三召调、選擇要設(shè)為公開的資源
庫中的所有資源在默認(rèn)情況下均處于公開狀態(tài)。要將所有資源隱式設(shè)為私有蛮浑，您必須至少將一個(gè)特定的屬性定義為公開唠叛。資源包括您項(xiàng)目的 res/ 目錄中的所有文件，例如圖像沮稚。要阻止您的庫用戶訪問僅供內(nèi)部使用的資源艺沼，您應(yīng)通過聲明一個(gè)或多個(gè)公開資源的方式來使用這種自動(dòng)私有標(biāo)識(shí)機(jī)制。
要?jiǎng)h除某個(gè)公開資源蕴掏，請(qǐng)將一個(gè) 聲明添加到您的庫的 public.xml 文件中障般。如果您之前尚未添加公開資源调鲸，則需要在您的庫的 res/values/ 目錄中創(chuàng)建 public.xml 文件。
下面的示例代碼可以創(chuàng)建兩個(gè)名稱分別為 mylib_app_name 和 mylib_public_string 的公開字符串資源：
<resources>
<public name="mylib_app_name" type="string"/>
<public name="mylib_public_string" type="string"/>
</resources>
如果希望任何資源保持對(duì)使用您的庫的開發(fā)者可見挽荡，您應(yīng)當(dāng)將其設(shè)為公開藐石。例如，盡管 v7 appcompat 庫中的大多數(shù)資源都是私有資源定拟，但是為了支持 Material Design于微，控制工具欄小部件的屬性應(yīng)當(dāng)公開。
將屬性隱式設(shè)為私有不僅可以阻止您的庫用戶從內(nèi)部庫資源獲得代碼自動(dòng)完成建議青自，還讓您能夠在不中斷您的庫客戶端的情況下重命名或移除私有資源株依。私有資源不在代碼自動(dòng)完成和 Theme Editor 的作用范圍內(nèi)，并且如果您嘗試引用私有資源性穿，Lint 將顯示警告勺三。
四、開發(fā)注意事項(xiàng)
在開發(fā)您的庫模塊和相關(guān)應(yīng)用時(shí)需曾，請(qǐng)注意以下行為和限制。
將庫模塊引用添加至您的 Android 應(yīng)用模塊后祈远，您可以設(shè)置它們的相對(duì)優(yōu)先級(jí)呆万。構(gòu)建時(shí)，庫會(huì)按照一次一個(gè)的方式與應(yīng)用合并车份，并按照從低到高的優(yōu)先級(jí)順序谋减。
1、資源合并沖突
構(gòu)建工具會(huì)將庫模塊中的資源與相關(guān)應(yīng)用模塊的資源合并扫沼。如果在兩個(gè)模塊中均定義了給定資源 ID出爹，將使用應(yīng)用中的資源。
如果多個(gè) AAR 庫之間發(fā)生沖突缎除，將使用依賴項(xiàng)列表首先列出（位于 dependencies
塊頂部）的庫中的資源严就。
為了避免常用資源 ID 的資源沖突，請(qǐng)使用在模塊（或在所有項(xiàng)目模塊）中具有唯一性的前綴或其他一致的命名方案器罐。2梢为、庫模塊可以包含 JAR 庫
您可以開發(fā)一個(gè)自身包含 JAR 庫的庫模塊；不過轰坊，您需要手動(dòng)編輯相關(guān)應(yīng)用模塊的構(gòu)建路徑铸董，并添加 JAR 文件的路徑。3肴沫、庫模塊可以依賴外部 JAR 庫
您可以開發(fā)一個(gè)依賴于外部庫（例如 Maps 外部庫）的庫模塊粟害。在這種情況下，相關(guān)應(yīng)用必須針對(duì)包含外部庫（例如 Google API 插件）的目標(biāo)構(gòu)建颤芬。另外也要注意悲幅，庫模塊和相關(guān)應(yīng)用都必須在其清單文件的 <uses- library>
元素中聲明外部庫孽文。4、庫模塊不得包含原始資源
工具不支持在庫模塊中使用原始資源文件（保存在 assets/
目錄中）夺艰。應(yīng)用使用的任何原始資源都必須存儲(chǔ)在應(yīng)用模塊自身的 assets/
目錄中芋哭。5、應(yīng)用模塊的 minSdkVersion
必須大于或等于庫定義的版本
庫作為相關(guān)應(yīng)用模塊的一部分編譯郁副，因此减牺，庫模塊中使用的 API 必須與應(yīng)用模塊支持的平臺(tái)版本兼容。6存谎、每個(gè)庫模塊都會(huì)創(chuàng)建自己的 R 類
在您構(gòu)建相關(guān)應(yīng)用模塊時(shí)拔疚，庫模塊將先編譯到 AAR 文件中，然后再添加到應(yīng)用模塊中既荚。因此稚失，每個(gè)庫都有其自己的 R
類，并根據(jù)庫的軟件包名稱命名恰聘。從主模塊和庫模塊生成的 R
類會(huì)在所需的所有軟件包（包括主模塊的軟件包和庫的軟件包）中創(chuàng)建句各。-
7、庫模塊可能包含自己的 ProGuard 配置文件
通過將 ProGuard 配置文件添加到包含其 ProGuard 指令的庫晴叨，您可以在自己的庫上啟用代碼壓縮凿宾。構(gòu)建工具會(huì)為庫模塊將此文件嵌入到生成的 AAR 文件中。在您將庫添加到應(yīng)用模塊時(shí)兼蕊，庫的 ProGuard 文件將附加至應(yīng)用模塊的 ProGuard 配置文件 (proguard.txt)初厚。通過將 ProGuard 文件嵌入到您的庫模塊中，您可以確保依賴于此庫的應(yīng)用模塊不必手動(dòng)更新其 ProGuard 文件即可使用庫孙技。當(dāng) ProGuard 在 Android 應(yīng)用模塊上運(yùn)行時(shí)产禾，它會(huì)同時(shí)使用來自應(yīng)用模塊和庫的指令，因此您不應(yīng)當(dāng)只在庫上運(yùn)行 ProGuard牵啦。
要指定您的庫的配置文件名稱亚情，請(qǐng)將其添加到 consumerProguardFiles 方法中，此方法位于您的庫的 build.gradle 文件的 defaultConfig 塊內(nèi)蕾久。例如势似，以下片段會(huì)將 lib-proguard-rules.txt 設(shè)置為庫的 ProGuard 配置文件：
android {
defaultConfig {
consumerProguardFiles 'lib-proguard-rules.txt'
}
...
}
默認(rèn)情況下，應(yīng)用模塊會(huì)使用庫的發(fā)布構(gòu)建僧著，即使在使用應(yīng)用模塊的調(diào)試構(gòu)建類型時(shí)亦是如此履因。要使用庫中不同的構(gòu)建類型，您必須將依賴項(xiàng)添加到應(yīng)用的 build.gradle 文件的 dependencies 塊中盹愚，并在庫的 build.gradle 文件中將 publishNonDefault 設(shè)置為 true栅迄。例如，您應(yīng)用的 build.gradle 文件中的以下代碼段會(huì)使應(yīng)用在應(yīng)用模塊于調(diào)試模式下構(gòu)建時(shí)使用庫的調(diào)試構(gòu)建類型皆怕，以及在應(yīng)用模塊于發(fā)布模式下構(gòu)建時(shí)使用庫的發(fā)布構(gòu)建類型：
dependencies {
debugCompile project(path: ':library', configuration: 'debug')
releaseCompile project(path: ':library', configuration: 'release')
}
您還必須在自己庫的 build.gradle 文件的 android 塊內(nèi)添加以下代碼行毅舆，以便將此庫的非發(fā)布配置展示給使用它的項(xiàng)目：
android {
...
publishNonDefault true
}
不過請(qǐng)注意西篓，設(shè)置 publishNonDefault
會(huì)增加構(gòu)建時(shí)間。
為了確保您的庫的 ProGuard 規(guī)則不會(huì)將意外的壓縮副作用施加到應(yīng)用模塊憋活，請(qǐng)僅包含適當(dāng)規(guī)則岂津，停用不適用于此庫的 ProGuard 功能。嘗試協(xié)助開發(fā)者的規(guī)則可能會(huì)與應(yīng)用模塊或它的其他庫中的現(xiàn)有代碼沖突悦即，因此不應(yīng)包含這些規(guī)則吮成。例如，您的庫的 ProGuard 文件可以指定在應(yīng)用模塊的壓縮期間需要保留的代碼辜梳。
注：Jack 工具鏈僅支持 ProGuard 的部分壓縮和模糊選項(xiàng)粱甫。
五、AAR 文件詳解
AAR 文件的文件擴(kuò)展名為 .aar作瞄，Maven 工件類型也應(yīng)當(dāng)是 aar茶宵。文件本身是一個(gè)包含以下強(qiáng)制性條目的 zip 文件：
- /AndroidManifest.xml
- /classes.jar
- /res/
- /R.txt
此外，AAR 文件可能包含以下可選條目中的一個(gè)或多個(gè)： - /assets/
- /libs/名稱.jar
- /jni/abi 名稱/名稱.so（其中 abi 名稱 是 Android 支持的 ABI 之一）
- /proguard.txt
- /lint.jar
