Android Studio 中正確導入第三方 JAR 包的最佳實踐

舊式做法的陷阱

早期 Eclipse 時代通過 Build Path > Add External JARs 引入 JAR，但在 Android Studio (Gradle) 專案中這樣做會導致「編譯通過、運行報錯」（NoClassDefFoundError），因為 JAR 未被打包進 APK。

標準流程

1. 將 JAR 文件放入模塊目錄下的 libs/ 文件夾（若無則新建）。
2. 在模塊的 build.gradle 中聲明：

   dependencies {
       implementation files('libs/your-lib.jar')
       // 或一次性引入整個 libs 目錄
       implementation fileTree(dir: 'libs', include: ['*.jar'])
   }

3. 點擊 Sync Now 同步 Gradle。

進階：發布到 Maven 本地/遠程倉庫

若多個專案共用同一 JAR，建議發布至 Maven 倉庫（如 Nexus、GitHub Packages），然後按坐標依賴：

implementation 'com.example:your-lib:1.0.0'

常見問題排查

• 重複類錯誤：檢查是否同時引入了同一庫的不同版本，使用 gradle dependencies 分析依賴樹。
• 混淆導致類丟失：在 proguard-rules.pro 中保留該庫類：-keep class com.thirdparty.** { *; }。