判断一个 Android “HelloWorld” 应用是否兼容不同系统版本,主要看以下几个方面:

1. 查看 minSdk、targetSdk、compileSdk
在 app/build.gradle 或 build.gradle.kts 中:
android {
compileSdk 34
defaultConfig {
applicationId "com.example.helloworld"
minSdk 21
targetSdk 34
versionCode 1
versionName "1.0"
}
}
含义:
| 配置项 | 含义 |
|---|---|
minSdk |
应用支持的最低 Android API 版本 |
targetSdk |
应用针对的目标 Android 行为版本 |
compileSdk |
编译时使用的 Android API 版本 |
例如:
minSdk 21
表示 Android 5.0(API 21)及以上系统可以安装和运行该应用。
兼容性判断
设备系统 API 版本满足:
设备 API Level >= minSdk
应用通常就允许安装。但能安装不代表所有功能都一定正常,还需要处理新旧 API 差异。
2. 判断当前系统版本
不要直接判断系统版本字符串,应使用 Build.VERSION.SDK_INT:
Kotlin
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
// Android 8.0 及以上代码
} else {
// Android 8.0 以下代码
}
Java
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
// Android 8.0 及以上代码
} else {
// 旧版本代码
}
例如,通知渠道只支持 Android 8.0(API 26)及以上:
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
val channel = NotificationChannel(
"default",
"默认通知",
NotificationManager.IMPORTANCE_DEFAULT
)
}
这样可以避免在低版本系统中调用不存在的 API,导致崩溃。
3. 使用 Android Studio 的兼容性检查
Android Studio 可以帮助发现 API 兼容问题:
- 使用
Lint检查 - 查看代码中的黄色警告
- 如果调用了高版本 API,通常会提示:
Call requires API level ...This API is not available in older versions
例如:
val manager = getSystemService(NotificationManager::class.java)
如果该 API 只支持较高版本,Android Studio 会提示你增加版本判断或使用兼容写法。
4. 使用 AndroidX 和兼容库
尽量使用 AndroidX 提供的兼容类,例如:
implementation("androidx.appcompat:appcompat:1.7.0")
implementation("androidx.core:core-ktx:1.13.1")
使用:
ContextCompat.getColor(this, R.color.black)
不要直接依赖某些只在新版本中存在的系统方法。常见兼容类包括:
ContextCompat
ActivityCompat
NotificationCompat
FileProvider
例如创建通知时,应优先使用:
NotificationCompat.Builder(this, "default")
而不是只使用新版本 API。
5. 注意 Manifest 和系统行为变化
不同 Android 版本除了 API 不同,系统规则也可能变化。
常见情况:
Android 6.0:运行时权限
危险权限需要运行时申请:
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
requestPermissions(
arrayOf(Manifest.permission.CAMERA),
100
)
}
Android 8.0:后台限制
后台启动服务需要使用前台服务或其他替代方案。
Android 8.0:通知渠道
通知必须创建 NotificationChannel。
Android 10:分区存储
访问外部存储的方式发生变化,不能完全依赖旧的文件路径。
Android 12:组件必须声明 exported
如果 Activity、Service 或 Receiver 带有 intent-filter,需要在 AndroidManifest.xml 中明确声明:
<activity
android:name=".MainActivity"
android:exported="true">
<intent-filter>
<action android:name="android.intent.action.MAIN" />
<category android:name="android.intent.category.LAUNCHER" />
</intent-filter>
</activity>
Android 13:通知权限
需要申请:
<uses-permission android:name="android.permission.POST_NOTIFICATIONS" />
Android 13/14:照片、后台服务等权限规则变化
对于较新的 Android 版本,应根据目标 SDK 使用新的权限和 API。
6. 在多个 Android 版本上测试
建议至少测试:
- 最低支持版本,例如 Android 5.0 或 Android 8.0
- 常用版本,例如 Android 10、11、12
- 最新版本,例如 Android 13、14 或更高版本
- 不同屏幕尺寸和厂商设备
可以使用:
- Android Studio Emulator
- Firebase Test Lab
- 真机测试
- Google Play Console 的预发布报告
查看 Build.VERSION.SDK_INT 可以打印设备 API 版本:
Log.d("AndroidVersion", Build.VERSION.SDK_INT.toString())
7. 最简单的判断标准
对于一个普通的 HelloWorld 项目,可以按下面方式判断:
minSdk决定最低支持的系统版本;- 设备 API Level 小于
minSdk,应用不能安装; - 使用新 API 时增加
SDK_INT判断; - 优先使用 AndroidX 兼容库;
- 使用 Android Studio Lint 检查;
- 在最低版本、常见版本和最新版本上运行测试;
- 检查权限、通知、存储、组件声明等系统行为变化。
例如:
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
// Android 13 及以上
} else {
// Android 12 及以下
}
核心原则是:
能否安装:看 minSdk
代码能否调用:看 API Level
系统行为是否变化:看 targetSdk 和 Android 版本
最终是否真正兼容:需要真机或模拟器测试