JDK 1.6兼容自制JAR在Android低API版本方法缺失问题求助

这种问题我之前帮不少开发者排查过——核心原因是JDK 1.6的方法集和Android不同API级别的方法支持并不是完全对齐的，有些JDK 1.6里存在的方法，Android直到更高的API级别才实现（或者Android Dalvik/ART并没有完全照搬JDK的实现）。针对你的情况，这里有几个系统性的解决方案，帮你彻底解决隐藏的依赖问题：

1. 用Android Lint做静态扫描，提前揪出问题 #

这是最直接的第一步，Android Lint可以自动扫描你的JAR和应用代码，找出所有调用了高于minSdkVersion="16"的API的地方。

• 开启方式：在Android Studio里，点击菜单栏的Analyze > Inspect Code，选择整个项目后，在检查项里找到Android > Lint > Correctness > NewApi并运行检查。
• 也可以在build.gradle里配置自动检查：

  android {
      lintOptions {
          check 'NewApi'
          abortOnError false // 可选，不想让检查中断构建的话设为false
      }
  }
  

  这样每次构建时，Lint都会帮你标记出所有可能在低版本设备上崩溃的方法调用。

2. 启用Core Library Desugaring，自动兼容JDK方法 #

Google提供的Desugar工具可以把高版本JDK的核心库方法转换成低版本Android兼容的实现，很多你遇到的JDK方法缺失问题，Desugar都能自动处理。

• 配置方式：在你的应用模块build.gradle里添加以下配置：

  android {
      compileOptions {
          coreLibraryDesugaringEnabled true
          sourceCompatibility JavaVersion.VERSION_1_6
          targetCompatibility JavaVersion.VERSION_1_6
      }
  }
  
  dependencies {
      coreLibraryDesugaring 'com.android.tools:desugar_jdk_libs:2.0.4'
  }
  

  这个工具会处理大部分java.util、java.lang等核心包的方法兼容，比如一些集合操作、字符串方法等，不需要你手动替换。

3. 手动验证JDK方法的Android兼容性 #

如果你担心Desugar覆盖不到的情况，可以逐个验证你JAR里用到的JDK方法在目标API级别是否存在：

• 打开Android官方的API参考文档，搜索对应的方法，查看它的Added in API level标注（比如java.util.Objects.requireNonNull()是在API 19才添加的）。
• 也可以用反编译工具（比如jadx）打开你的JAR，导出所有方法调用，然后批量检查这些方法的最低API要求。

4. 封装兼容性工具类，做运行时判断 #

对于一些Desugar处理不了的方法，或者你需要更精细控制的场景，可以自己写封装类，在运行时根据设备API级别选择不同的实现：

public class CompatUtils {
    public static <T> T requireNonNull(T obj) {
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT) {
            return Objects.requireNonNull(obj);
        } else {
            if (obj == null) {
                throw new NullPointerException();
            }
            return obj;
        }
    }
}

然后在JAR里调用这个封装类的方法，而不是直接调用JDK的方法。

5. 全覆盖测试，排除隐藏问题 #

最后一定要做覆盖所有目标API级别的测试：

• 用Android模拟器创建API 16、19、20的虚拟机，运行你的应用核心流程。
• 写自动化测试用例（比如JUnit或Espresso），覆盖JAR里的所有关键方法，在低版本设备上跑一遍，确保没有隐藏的NoSuchMethodError。

按照这个流程走，基本可以把所有潜在的JDK方法依赖问题都找出来并解决掉。

内容的提问来源于stack exchange，提问作者T Clulow