01-17-01 API Level与版本管理机制什么是API LevelAPI Level是Android系统的版本号每个Android版本都有唯一的API Level。源码定义// Build.javapublicclassBuild{publicstaticclassVERSION{/** * 设备的Android版本 */publicstaticfinalintSDK_INTandroid.os.Build.VERSION.SDK_INT;/** * Android版本代号 */publicstaticfinalStringRELEASEgetString(ro.build.version.release);}}API Level对应表Android版本API Level代号发布时间Android 1434Upside Down Cake2023Android 1333Tiramisu2022Android 12L32Snow Cone v22022Android 1231Snow Cone2021Android 1130Red Velvet Cake2020Android 1029Quince Tart2019Android 928Pie2018Android 8.127Oreo2017Android 8.026Oreo2017Android 7.125Nougat2016Android 7.024Nougat2016Android 6.023Marshmallow2015Android 5.122Lollipop2015Android 5.021Lollipop2014三个关键版本号1. minSdkVersion - 最低支持版本android { defaultConfig { minSdkVersion 21 // 最低支持Android 5.0 } }作用Google Play不会将应用分发给API Level低于minSdkVersion的设备低版本设备无法安装该应用选择建议API 21覆盖99%设备推荐API 23覆盖98%设备支持运行时权限API 26覆盖90%设备支持通知渠道2. targetSdkVersion - 目标版本android { defaultConfig { targetSdkVersion 34 // 目标Android 14 } }作用告诉系统我已针对这个版本进行了适配重要特性// targetSdkVersion决定系统行为// targetSdkVersion 23安装时授予所有权限// targetSdkVersion 23运行时申请危险权限// targetSdkVersion 24file:// URI可用// targetSdkVersion 24必须使用FileProvider// targetSdkVersion 29可访问外部存储// targetSdkVersion 29Scoped Storage限制// targetSdkVersion 30可查询所有已安装应用// targetSdkVersion 30需要QUERY_ALL_PACKAGES权限Google Play要求2023年8月起新应用必须targetSdkVersion 332023年11月起应用更新必须targetSdkVersion 333. compileSdkVersion - 编译版本android { compileSdkVersion 34 // 使用Android 14 SDK编译 }作用决定可以使用哪些API只影响编译不影响运行规则compileSdkVersion targetSdkVersion minSdkVersion最佳实践android { compileSdkVersion 34 // 使用最新SDK编译 defaultConfig { minSdkVersion 21 // 支持Android 5.0 targetSdkVersion 34 // 已适配Android 14 } }API Level检查机制源码实现// PackageManagerService.javaprivatevoidcheckMinSdkVersion(PackageInfoLitepkg){if(pkg.installLocationPackageInfo.INSTALL_LOCATION_INTERNAL_ONLY){if(pkg.versionCodeandroid.os.Build.VERSION_CODES.CUR_DEVELOPMENT){// 检查minSdkVersionif(pkg.minSdkVersionBuild.VERSION.SDK_INT){thrownewPackageManagerException(INSTALL_FAILED_OLDER_SDK,Requires newer sdk version #pkg.minSdkVersion);}}}}运行时检查// 检查设备API Levelif(Build.VERSION.SDK_INTBuild.VERSION_CODES.TIRAMISU){// Android 13代码registerReceiver(receiver,filter,RECEIVER_NOT_EXPORTED)}else{// Android 12及以下registerReceiver(receiver,filter)}编译时检查// 使用RequiresApi注解RequiresApi(Build.VERSION_CODES.O)funcreateNotificationChannel(){valchannelNotificationChannel(channel_id,Channel Name,NotificationManager.IMPORTANCE_DEFAULT)notificationManager.createNotificationChannel(channel)}// Lint会检查调用处是否有版本判断API变更类型1. 新增API// Android 8.0新增NotificationChannelRequiresApi(26)publicfinalclassNotificationChannel{// 新增类}2. 废弃API// Android 10废弃DeprecatedpublicStringgetDeviceId(){returnnull;}3. 移除API// Android 9移除Apache HTTP Client// import org.apache.http.client.HttpClient; // 编译失败4. 行为变更// Android 9限制明文HTTP// targetSdkVersion 28时默认禁止HTTP请求兼容性保障机制1. CTS测试# Compatibility Test Suite# 确保设备API实现符合Android规范adb shell am instrument-w\-eclass android.app.cts.ActivityManagerTest\android.app.cts/androidx.test.runner.AndroidJUnitRunner2. SDK Tools验证# Lint检查API使用./gradlew lint# 输出Warning: Call requires API level26(current min is21): NotificationChannel[NewApi]3. API Diff报告Google每次发布新版本都会生成API变更报告API Additions- 新增的APIAPI Changes- 修改的APIAPI Removals- 移除的API实战版本兼容代码条件编译classCompatActivity:AppCompatActivity(){overridefunonCreate(savedInstanceState:Bundle?){super.onCreate(savedInstanceState)// 通知渠道Android 8.0if(Build.VERSION.SDK_INTBuild.VERSION_CODES.O){createNotificationChannel()}// Scoped StorageAndroid 10valimageUriif(Build.VERSION.SDK_INTBuild.VERSION_CODES.Q){MediaStore.Images.Media.getContentUri(MediaStore.VOLUME_EXTERNAL_PRIMARY)}else{MediaStore.Images.Media.EXTERNAL_CONTENT_URI}}RequiresApi(Build.VERSION_CODES.O)privatefuncreateNotificationChannel(){valchannelNotificationChannel(CHANNEL_ID,Default Channel,NotificationManager.IMPORTANCE_DEFAULT)valmanagergetSystemService(NotificationManager::class.java)manager.createNotificationChannel(channel)}}反射调用新API// 在minSdk 26的应用中使用NotificationChannelfuncreateChannelCompat(context:Context){if(Build.VERSION.SDK_INTBuild.VERSION_CODES.O){// 直接调用valchannelNotificationChannel(id,name,NotificationManager.IMPORTANCE_DEFAULT)context.getSystemService(NotificationManager::class.java).createNotificationChannel(channel)}else{// 低版本无需创建Channel}}常见错误错误1直接使用新API// minSdkVersion 21但直接使用API 26的类valchannelNotificationChannel(...)// 编译失败或运行时崩溃修复if(Build.VERSION.SDK_INTBuild.VERSION_CODES.O){valchannelNotificationChannel(...)}错误2targetSdkVersion过低targetSdkVersion 22 // 太低无法上架Google Play影响Google Play拒绝上架无法使用新特性用户体验差错误3compileSdkVersion低于targetSdkVersioncompileSdkVersion 30 targetSdkVersion 34 // 编译失败修复compileSdkVersion 34 targetSdkVersion 34总结API Level核心概念API LevelAndroid版本的数字标识minSdkVersion应用支持的最低系统版本targetSdkVersion应用适配的目标版本compileSdkVersion编译使用的SDK版本版本管理原则compileSdkVersion始终使用最新targetSdkVersion尽量保持最新满足Google Play要求minSdkVersion根据用户覆盖率决定推荐21新API必须加版本判断兼容性保障编译期Lint检查API使用运行期Build.VERSION.SDK_INT判断测试期CTS测试保证兼容性关键要点API Level是Android版本兼容的基石理解三个版本号的作用是编写兼容代码的前提