將通用功能(網路層、工具類、自定義 View、業務邏輯)抽離為獨立 Library 專案,再由多個 App 專案依賴,是模組化開發的基礎。本文針對早期 ADT (Eclipse) 環境與現代 Gradle (Android Studio) 環境,分別說明 Library 專案建立、打包發布、主專案引用的完整流程。
注意: ADT 已於 2015 年停止更新,僅供維護舊專案參考。
TestLib。bin/ 目錄下自動生成 TestLib.jar(僅含編譯後的 .class,不含資源 R.java、res/、assets/)。


TestDemo。TestLib。gen/ 自動生成 Library 的 R.java,Android Dependencies 庫出現 TestLib.jar,即可直接呼叫 Library 中的類與資源。

現代 Android 開發統一採用 AAR (Android Archive) 格式,完整包含:classes.jar、R.txt、res/、assets/、AndroidManifest.xml、proguard.txt、lint.jar 等,支援傳遞依賴與 Maven 發布。
// settings.gradle
include ':app', ':mylibrary'
// mylibrary/build.gradle
plugins {
id 'com.android.library'
id 'maven-publish' // 用於發布到 Maven 儲存庫
}
android {
namespace 'com.example.mylibrary'
compileSdk 34
defaultConfig {
minSdk 21
targetSdk 34
versionCode 1
versionName "1.0.0"
}
// 無需 applicationId
}
dependencies {
// Library 內部依賴
implementation "androidx.core:core-ktx:1.12.0"
}
// app/build.gradle
dependencies {
implementation project(':mylibrary') // 直接依賴同專案 Module
}
// mylibrary/build.gradle 新增 publishing 區塊
publishing {
publications {
release(MavenPublication) {
groupId = 'com.example'
artifactId = 'mylibrary'
version = '1.0.0'
from components.release
}
}
repositories {
maven {
// 本地 Maven 儲存庫路徑,或 Nexus/Artifactory 遠端 URL
url = uri("$rootDir/../maven-repo")
}
}
}
執行 ./gradlew :mylibrary:publish 發布。其他專案在 settings.gradle 加入 maven { url = uri("../maven-repo") },即可用 implementation "com.example:mylibrary:1.0.0" 依賴。
執行 ./gradlew :mylibrary:assembleRelease,產出 mylibrary/build/outputs/aar/mylibrary-release.aar。其他專案放入 libs/ 目錄,並在 build.gradle 加入:
repositories {
flatDir { dirs 'libs' }
}
dependencies {
implementation(name: 'mylibrary-release', ext: 'aar')
}
| 特性 | ADT (Eclipse) Library Project | Gradle (AS) Library Module (AAR) |
|---|---|---|
| 輸出格式 | JAR (僅 .class) | AAR (含資源、Manifest、ProGuard、Lint) |
| 資源合併 | 編譯時由 ADT 自動合併 | 打包進 AAR,消費端自動合併 |
| 傳遞依賴 | 不支援 | 完整支援 (api/implementation) |
| 版本管理 | 無 | Maven 坐標 (GAV) |
| 發布方式 | 複製原始碼/專案 | Maven Local/Remote、本地 AAR、JitPack |
| 跨 IDE/團隊 | 極度困難 | 標準化,語言無關 |
若仍在使用 Eclipse ADT,請儘快遷移至 Android Studio + Gradle。遷移步驟:
1. Eclipse 專案右鍵 Export → Generate Gradle build files。
2. AS 選擇 Import Project (Gradle)。
3. 將 project.properties 中的 android.library=true 改為 apply plugin: 'com.android.library'。
4. 清理 bin/、gen/,重新 Sync Gradle。