萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> Android 開發

Android Library 專案打包 AAR/JAR 並被主專案引用:ADT/Gradle 雙方案詳解

將通用功能(網路層、工具類、自定義 View、業務邏輯)抽離為獨立 Library 專案,再由多個 App 專案依賴,是模組化開發的基礎。本文針對早期 ADT (Eclipse) 環境與現代 Gradle (Android Studio) 環境,分別說明 Library 專案建立、打包發布、主專案引用的完整流程。

方案一:ADT (Eclipse) 環境 —— Library Project 機制

注意: ADT 已於 2015 年停止更新,僅供維護舊專案參考。

1. 建立 Library 專案

  • File → New → Android Application Project,專案名如 TestLib。
  • 右鍵專案 → Properties → Android,勾選 Is Library。
  • 若啟用 Build Automatically,bin/ 目錄下自動生成 TestLib.jar(僅含編譯後的 .class,不含資源 R.java、res/、assets/)。
建立 Library 專案
勾選 Is Library
生成的 jar

2. 主專案引用 Library

  • 建立主專案 TestDemo。
  • 右鍵 → Properties → Android → Library 區域 Add → 選擇 TestLib。
  • 點擊 Apply 後,主專案 gen/ 自動生成 Library 的 R.java,Android Dependencies 庫出現 TestLib.jar,即可直接呼叫 Library 中的類與資源。
主專案引用 Library
生成 R.java 與 jar 參考

ADT 方案缺陷

  • JAR 不包含資源(Layout、Drawable、Assets),資源合併依賴 ADT 編譯時處理,無法單獨發布 JAR 給無原始碼專案使用。
  • 兩專案必須在同一 Workspace,跨團隊/跨倉庫協作困難。
  • 不支援傳遞依賴、版本管理、Maven/Ivy 儲存庫發布。

方案二:Gradle (Android Studio) 環境 —— AAR 標準發布(推薦)

現代 Android 開發統一採用 AAR (Android Archive) 格式,完整包含:classes.jar、R.txt、res/、assets/、AndroidManifest.xml、proguard.txt、lint.jar 等,支援傳遞依賴與 Maven 發布。

1. 建立 Library Module

// 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"
}

2. 本地依賴(同一專案多 Module)

// app/build.gradle
dependencies {
    implementation project(':mylibrary') // 直接依賴同專案 Module
}

3. 發布到 Maven 儲存庫(跨專案/團隊共用)

// 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" 依賴。

4. 直接發布 AAR 檔案(無 Maven 服務)

執行 ./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 ProjectGradle (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。

copyright © 萬盛學電腦網 all rights reserved