您现在的位置：程式碼之家 >> 編程語言 > >> 更多程式語言 >> 程式設計疑難解答

Android Studio 導入 JAR 包完整指南：libs 目錄法與 Gradle 依賴法

編輯：程式設計疑難解答

方法一：手動放入 libs 目錄 (傳統、通用)

項目視圖切換到 Project 模式。
在 app 模塊下創建 libs 目錄 (若無)：右鍵 app → New → Directory → 命名 libs。
將下載的 .jar 文件複製到 app/libs/ 下。
右鍵 JAR 文件 → Add As Library。AS 會自動修改 build.gradle 添加依賴。
檢查 app/build.gradle：

dependencies {
    implementation fileTree(dir: 'libs', include: ['*.jar']) // 自動包含 libs 下所有 jar
    // 或顯式指定
    implementation files('libs/your-library.jar')
}

方法二：GitHub/Maven 庫依賴 (推薦、自動更新)

若庫發布到 Maven Central / JitPack / JCenter：

// Project/build.gradle
allprojects {
    repositories {
        google()
        mavenCentral()
        maven { url 'https://jitpack.io' } // JitPack 常用於 GitHub 庫
    }
}

// app/build.gradle
dependencies {
    // 格式: 'groupId:artifactId:version'
    implementation 'com.github.User:Repo:Tag' // JitPack 格式
    implementation 'com.squareup.okhttp3:okhttp:4.11.0' // Maven Central 示例
}

優點： 版本管理、傳遞依賴自動解析、一鍵升級、無需手動複製文件。

方法三：本地 Maven 仓庫 (適用於無遠程倉的私有 JAR)

安裝到本地倉：mvn install:install-file -Dfile=your.jar -DgroupId=com.local -DartifactId=yourlib -Dversion=1.0 -Dpackaging=jar
mavenLocal() 加入 repositories。
implementation 'com.local:yourlib:1.0'。

常見問題排查

現象	原因	解決
右鍵 JAR 無 "Add As Library"	視圖非 Project 模式 / 文件不在模塊目錄下	切換 Project 視圖，確保 JAR 在 app/libs/
導入後找不到類/方法	JAR 版本錯誤 / 未同步 Gradle / 依賴衝突	Sync Project with Gradle Files；檢查 External Libraries 列表
Duplicate class 錯誤	同一類存在於多個 JAR / 依賴傳遞衝突	用 `exclude group: 'xxx'` 排除傳遞依賴；或升級統一版本
Could not find ...	倉庫地址缺失 / 坐標錯誤 / 網絡不通	添加 jitpack.io/mavenCentral()；核對 groupId/artifactId/version

最佳實踐建議

優先用 Gradle 依賴坐標 (方法二)，除非是極老舊/私有無發布渠道的 JAR。
libs 目錄法 僅作為臨時/離線/極特殊情況備選。
項目根目錄創建 gradle.properties 統一管理版本號：okhttpVersion=4.11.0，依賴中用 implementation "com.squareup.okhttp3:okhttp:$okhttpVersion"。
定期執行 ./gradlew dependencyUpdates (需插件) 檢查可升級依賴。

總結

**Android Studio 導入 JAR 兩大主流路徑：**
1. **手動複製到 app/libs/ → 右鍵 Add As Library** (適用離線/私有 JAR)。
2. **在 build.gradle 添加 implementation 'group:artifact:version'** (適用 Maven/JitPack 庫，**強烈推薦**)。
GitHub 庫通常提供 JitPack 坐標，直接複製到 dependencies 即可，無需手動下載 JAR。