将原生Java项目导入Android作为库使用的问题

我之前也碰到过一模一样的情况——Jar明明显示在External Library里，但就是没法正常导入类编译，大概率是打包、配置或者兼容性的问题，咱们一步步来排查解决：

1. 先确认Jar包的内容是否完整 #

首先得确保你打的Jar包确实包含了需要的工具类，打开终端执行命令：

jar tf your-library.jar

查看输出的目录结构，是不是和原生Java项目的包结构完全一致，有没有漏掉你要用到的类文件。另外要注意：Jar默认不会打包原生项目里的资源文件（比如.properties、.xml），如果工具类依赖这些资源，后续得单独处理。

2. 检查Android项目的依赖配置 #

• 如果是手动将Jar放到libs/目录：
  打开模块级别的build.gradle（通常是app/build.gradle），确认里面有正确的依赖配置：

  dependencies {
      // 匹配libs下所有Jar包
      implementation fileTree(dir: 'libs', include: ['*.jar'])
      // 或者单独指定你的Jar（二选一即可）
      // implementation files('libs/your-library.jar')
  }
  

• 如果是直接添加Java模块作为依赖：
  先检查settings.gradle里有没有包含这个模块：

  include ':app', ':your-java-module'
  

  然后在app/build.gradle里添加模块依赖：

  dependencies {
      implementation project(':your-java-module')
  }
  

  配置完记得点击右上角的「Sync Now」同步Gradle。

3. 确保Java版本兼容性 #

如果原生Java项目用了Java 8及以上的特性（比如Lambda表达式、Stream API），Android项目必须开启对应版本的支持：
在app/build.gradle的android块里添加：

android {
    compileOptions {
        sourceCompatibility JavaVersion.VERSION_1_8
        targetCompatibility JavaVersion.VERSION_1_8
    }
    // 如果项目用了Kotlin，还要加上下面这段
    kotlinOptions {
        jvmTarget = '1.8'
    }
}

4. 排查依赖冲突或缺失 #

原生Java项目可能依赖了其他第三方库，这些依赖不会被打包到Jar里，所以Android项目需要手动添加这些依赖到build.gradle。
如果碰到类重复或者依赖冲突的错误，可以执行命令查看完整依赖树：

./gradlew app:dependencies

找到冲突的依赖后，用exclude排除重复部分，比如：

implementation('some-third-party-lib') {
    exclude group: 'com.example', module: 'conflicting-module'
}

5. 处理资源文件的问题 #

如果你的工具类用到了原生项目里的资源文件，Jar包不会自动把这些资源同步到Android项目的资源目录，这时候需要：

• 把资源文件（比如.properties）复制到Android项目的assets/或者res/raw/目录
• 修改工具类里读取资源的代码，适配Android的资源读取方式，比如把原来的：

  InputStream is = new FileInputStream("config.properties");
  

  改成：

  // 需要传入Context对象来读取Android资源
  InputStream is = context.getAssets().open("config.properties");
  

6. 清理缓存并重建项目 #

有时候Gradle缓存会导致莫名其妙的编译错误，试试：

• 点击Android Studio顶部菜单的Build -> Clean Project，然后Build -> Rebuild Project
• 或者用命令行执行：

  ./gradlew clean assembleDebug
  

内容的提问来源于stack exchange，提问作者Hoàng Tùng