如何在不同Android版本间保持应用兼容性？

一、版本兼容问题的通用解决建议 #

• 合理配置构建参数：将compileSdk设置为最新稳定版，minSdk明确声明应用支持的最低系统版本，targetSdk根据业务适配计划调整，IDE会自动识别并警告调用了高于minSdk的API。
• 增加运行时版本判断：调用高版本API前，通过Build.VERSION.SDK_INT和系统版本常量做校验，示例逻辑如下：

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
    // 调用Android 12（API 31）及以上才支持的API
} else {
    // 执行低版本兼容的替代逻辑
}

• 优先使用Jetpack兼容库：谷歌官方的AndroidX系列库已经对大部分高版本能力做了向下适配，比如用AppCompatActivity替代原生Activity，用ActivityResultContracts替代旧版的startActivityForResult，无需自己额外做版本判断。
• 及时替换废弃API：对IDE标注为已废弃的API，优先采用官方推荐的兼容替代方案，避免使用已被系统移除的接口。
• 多版本覆盖测试：除了真机测试，可通过Android Studio模拟器创建不同API层级的测试设备，跑自动化测试用例覆盖边界场景。

二、「最新系统开发测试可保证旧版本兼容」说法的真实性 #

该说法完全不属实。

Android系统的兼容逻辑是高版本系统保留旧版API的实现（除非官方明确标记移除），但旧版本系统不会包含后续新增的API、权限规则、系统行为变更。在最新系统上跑通的逻辑，放到旧系统上可能直接抛出NoClassDefFoundError、NoSuchMethodError等崩溃，也可能因为权限、窗口机制等系统行为差异出现功能异常。

三、兼容性问题的归类标记方案 #

官方提供的原生标记是@RequiresApi注解，在调用了高于minSdk版本API的类、方法上添加该注解，标注所需的最低API版本即可，示例：

@RequiresApi(Build.VERSION_CODES.S)
private void callApiAbove31() {
    // 仅API 31及以上可调用的逻辑
}

该注解既可以让IDE精准提示版本调用风险，也可以通过全局搜索该注解的方式，统一管理所有兼容性相关的代码。如果需要自定义分类，也可以通过// COMPAT: [版本说明]的注释格式标记兼容逻辑，方便全局检索。

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