HelloWorld不同安卓系统版本如何判断兼容性

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

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 项目,可以按下面方式判断:

  1. minSdk 决定最低支持的系统版本;
  2. 设备 API Level 小于 minSdk,应用不能安装;
  3. 使用新 API 时增加 SDK_INT 判断;
  4. 优先使用 AndroidX 兼容库;
  5. 使用 Android Studio Lint 检查;
  6. 在最低版本、常见版本和最新版本上运行测试;
  7. 检查权限、通知、存储、组件声明等系统行为变化。

例如:

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
    // Android 13 及以上
} else {
    // Android 12 及以下
}

核心原则是:

能否安装:看 minSdk
代码能否调用:看 API Level
系统行为是否变化:看 targetSdk 和 Android 版本
最终是否真正兼容:需要真机或模拟器测试

返回首页