如何在Android项目的Java库中实现Android版本编译时检查

1. 推荐的编译时版本检查方案 #

最实用的方案是通过Gradle生成编译时常量，结合Java静态条件判断。Android Gradle Plugin（AGP）自带BuildConfig类生成机制，你可以把当前编译的minSdkVersion、compileSdkVersion转成数值常量注入代码，再用这些常量做条件判断——Java编译器会自动优化掉静态条件为false的代码块，相当于实现编译时的代码取舍。

另外，Android官方的@RequiresApi（替代旧的@TargetApi）注解可辅助编译时检查：如果代码调用了高于当前minSdkVersion的API，Lint会直接给出警告或错误，避免运行时崩溃，但它仅做检查，不直接控制代码的包含/排除。

2. 支持条件编译的Gradle工具/插件 #

不需要额外第三方插件，Android Gradle Plugin（AGP）本身就足够支持基于Android版本的条件编译：

• AGP自带的BuildConfig生成机制，允许自定义注入版本相关常量；
• AGP的sourceSets配置，可按API版本划分代码目录，实现不同版本代码的选择性编译；
• 若需复杂逻辑，直接在模块的build.gradle（或build.gradle.kts）中用Groovy/Kotlin DSL编写自定义逻辑，动态控制代码源或依赖即可。

3. 编译阶段条件性包含/排除代码块 #

有两种常用实现方式：

方式一：BuildConfig常量+静态条件判断 #

1. 在模块的build.gradle中配置自定义BuildConfig字段：

android {
    defaultConfig {
        // 注入minSdkVersion数值常量
        buildConfigField "int", "MIN_SDK", "${defaultConfig.minSdkVersion}"
        // 注入compileSdkVersion数值常量
        buildConfigField "int", "COMPILE_SDK", "${compileSdkVersion}"
    }
}

2. 在Java代码中使用常量做条件判断：

public class CompatibilityUtils {
    public static void doSomething() {
        if (BuildConfig.MIN_SDK >= 23) {
            // 仅在minSdk >=23时编译这段代码
            doMarshmallowPlusLogic();
        } else {
            // 仅在minSdk <23时编译这段代码
            doPreMarshmallowLogic();
        }
    }
}

Java编译器会自动移除静态条件为false的代码块，最终字节码只会保留符合当前版本条件的代码。

方式二：按API版本划分代码目录 #

1. 在模块中创建按API版本命名的源码目录：

src/
├── main/          # 通用代码
│   └── java/
├── api23/         # 仅API>=23时编译的代码
│   └── java/
└── preApi23/      # 仅API<23时编译的代码
    └── java/

2. 在build.gradle中配置sourceSets，根据版本条件包含对应目录：

android {
    sourceSets {
        main.java.srcDirs += file("src/main/java")
        // 当minSdk >=23时，包含api23目录
        if (defaultConfig.minSdkVersion >= 23) {
            main.java.srcDirs += file("src/api23/java")
        } else {
            main.java.srcDirs += file("src/preApi23/java")
        }
    }
}

这种方式适合差异较大的代码完全分离，避免单个文件中过多条件判断，代码结构更清晰。

另外，配合@RequiresApi注解可在编译时检查API调用合法性：

@RequiresApi(23)
public static void doMarshmallowPlusLogic() {
    // 调用Android 6.0+的API
}

如果当前编译的minSdkVersion低于23，Lint会直接提示错误，提前发现兼容性问题。

内容的提问来源于stack exchange，提问作者Mouad Oumous