Android Java项目如何实现适配不同SDK版本的import语句条件编译？

• Java语法层面约束：import语句必须位于文件顶部、类定义之前，在import行前添加任何注解都不符合Java语法规范，编译器不会识别这类无效标注
• @TargetApi的本质局限：这是Lint层面的警告抑制注解，并非编译期条件编译指令，它仅用于提示Lint跳过对高版本API调用的NewApi告警，完全不控制javac的类解析流程。哪怕标注位置正确，javac在编译时依然会优先解析所有import的类，如果当前compileSdk对应的android.jar中不存在对应类，会直接抛出类找不到的编译错误，和注解无关
• 常见误区澄清：即便把import去掉、在方法内部用全限定类名引用高版本API，依然会触发编译器的类查找校验，只要对应类在当前compileSdk的SDK中不存在，就会编译失败，无法实现条件编译效果

方案1：Gradle源集动态排除高版本适配类 #

这是成本最低的实现方式，不需要改动原有业务逻辑结构：

1. 将所有依赖API 30特性（包含你提到的WifiNetworkSuggestion、两个Settings跳转常量）的逻辑，单独抽取到独立类文件中，比如WifiApi30Impl.java，在这个文件里正常书写需要的import语句和业务逻辑
2. 在app模块的build.gradle中添加源集配置，根据当前compileSdk版本动态控制是否编译这个高版本类：

android {
    // 原有compileSdk配置
    compileSdkVersion 30

    sourceSets {
        main {
            java {
                // compileSdk低于30时，直接跳过高版本实现类的编译流程
                if (project.android.compileSdkVersion < 30) {
                    exclude 'com/your/app/package/wifi/WifiApi30Impl.java'
                }
            }
        }
    }
}

3. 实现逻辑：被exclude的文件完全不会进入javac的编译流程，编译器自然不会解析文件内的import语句，也就不会因为找不到高版本类报错。主业务逻辑通过公共接口调用适配能力，不直接引用高版本API类，从根源上避免编译器扫描到不存在的类引用

方案2：按API版本拆分独立源码目录 #

如果高版本适配逻辑较多，可以直接将代码按版本拆分存放，减少手动维护排除规则的成本：

• 目录结构规划：
  • src/main/java/：存放通用接口定义、公共业务逻辑，不包含任何高版本API引用
  • src/main/java-compat27/：存放适配API 27的低版本实现，无高版本类依赖
  • src/main/java-compat30/：存放适配API 30的高版本实现，正常书写需要的import语句
• 在build.gradle中根据compileSdk版本动态引入对应源码目录：

sourceSets {
    main {
        java {
            if (project.android.compileSdkVersion >= 30) {
                srcDir 'src/main/java-compat30'
                exclude '**/*Api27Impl.java'
            } else {
                srcDir 'src/main/java-compat27'
                exclude '**/*Api30Impl.java'
            }
        }
    }
}

内容的提问来源于stack exchange，提问作者John Hassell