当前位置：首页 > news >正文

01-17-03 向前兼容的技术手段

news 2026/6/7 4:58:27

01-17-03 向前兼容的技术手段

什么是向前兼容

向前兼容（Forward Compatibility）：老应用能在新系统上正常运行。

目标：2015年开发的应用（targetSdk 22）在2024年的Android 14设备上仍能运行。

为什么需要向前兼容

应用生命周期问题

应用开发时间：2015年（Android 5.1，API 22） 应用停止维护：2018年 用户设备升级：2024年（Android 14，API 34） 应用是否能运行？

Google的挑战：

全球数百万应用
大量应用已停止维护
用户升级系统后不能让应用崩溃

向前兼容的实现机制

1. targetSdkVersion作为兼容开关

新系统通过targetSdkVersion判断应用期望的行为：

// ActivityManagerService.javavoidstartActivity(Intentintent,ApplicationInfoappInfo){inttargetSdk=appInfo.targetSdkVersion;if(targetSdk<Build.VERSION_CODES.N){// targetSdk < 24：允许file:// URIallowFileUriExposure(intent);}else{// targetSdk >= 24：强制使用FileProvidercheckFileUriExposure(intent);}}

2. 废弃API继续保留

即使API废弃，也不会删除：

// TelephonyManager.java// Android 1.0就存在@Deprecated// Android 10标记废弃publicStringgetDeviceId(){// Android 10+返回null，但方法保留if(Build.VERSION.SDK_INT>=Build.VERSION_CODES.Q){returnnull;// 不返回真实IMEI}returnmDeviceId;}// 新API替代@RequiresPermission(android.Manifest.permission.READ_PRIVILEGED_PHONE_STATE)publicStringgetImei(){// Android 8.0+新增returnmImei;}

3. 默认行为保持宽松

新限制默认不生效，需要显式启用：

<!-- Android 9引入明文HTTP限制 --><!-- 默认值取决于targetSdkVersion --><!-- targetSdk < 28：默认允许HTTP --><applicationandroid:usesCleartextTraffic="true"><!-- 默认值 --></application><!-- targetSdk >= 28：默认禁止HTTP --><applicationandroid:usesCleartextTraffic="false"><!-- 默认值 --></application>

源码实现：

// ApplicationInfo.javapublicbooleanusesCleartextTraffic(){if(targetSdkVersion<Build.VERSION_CODES.P){// targetSdk < 28：默认允许returntrue;}else{// targetSdk >= 28：读取配置return(flags&FLAG_USES_CLEARTEXT_TRAFFIC)!=0;}}

向前兼容的实战案例

案例1：文件URI暴露

Android 7.0的变更

问题：file:// URI会暴露应用私有文件路径

// Android 6.0及以下可以这样做valfile=File(context.filesDir,"photo.jpg")valuri=Uri.fromFile(file)// file:///data/data/com.example.app/files/photo.jpgvalintent=Intent(Intent.ACTION_VIEW).apply{setDataAndType(uri,"image/jpeg")}startActivity(intent)// [通过] Android 6.0可以// Android 7.0+会抛出异常startActivity(intent)// [未通过] FileUriExposedException

向前兼容机制

// StrictMode.javapublicstaticvoidonFileUriExposed(Uriuri,Stringlocation){finalStringmessage=uri+" exposed beyond app through "+location;// 检查targetSdkVersionif(getApplicationInfo().targetSdkVersion>=Build.VERSION_CODES.N){// targetSdk >= 24：抛出异常thrownewFileUriExposedException(message);}else{// targetSdk < 24：只打印警告，不崩溃Log.w(TAG,message);onVmPolicyViolation(newThrowable(message));}}

结果：

老应用（targetSdk 22）：只打印警告，继续运行
新应用（targetSdk 24+）：强制使用FileProvider

正确的适配方式

// 使用FileProvidervalfile=File(context.filesDir,"photo.jpg")valuri=FileProvider.getUriForFile(context,"com.example.app.fileprovider",file)// content://com.example.app.fileprovider/files/photo.jpgvalintent=Intent(Intent.ACTION_VIEW).apply{setDataAndType(uri,"image/jpeg")addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION)}startActivity(intent)// [通过] 所有版本都可以

案例2：运行时权限

Android 6.0的变更

问题：危险权限需要运行时申请

// Android 5.1及以下classCameraActivity:Activity(){overridefunonCreate(savedInstanceState:Bundle?){super.onCreate(savedInstanceState)// 直接打开相机，权限在安装时已授予openCamera()// [通过] Android 5.1可以}}// Android 6.0+需要运行时申请openCamera()// [未通过] SecurityException（如果targetSdk >= 23）

向前兼容机制

// ContextImpl.java@OverridepublicintcheckSelfPermission(Stringpermission){if(getApplicationInfo().targetSdkVersion<Build.VERSION_CODES.M){// targetSdk < 23：检查权限是否在Manifest中声明// 如果声明了，自动授予returnPackageManager.PERMISSION_GRANTED;}else{// targetSdk >= 23：检查是否运行时授予returncheckPermission(permission,android.os.Process.myPid(),android.os.Process.myUid());}}

结果：

老应用（targetSdk 22）：安装时授予所有权限
新应用（targetSdk 23+）：需要运行时申请

兼容性代码

classCameraActivity:AppCompatActivity(){overridefunonCreate(savedInstanceState:Bundle?){super.onCreate(savedInstanceState)if(Build.VERSION.SDK_INT>=Build.VERSION_CODES.M){// Android 6.0+：检查并请求权限if(checkSelfPermission(Manifest.permission.CAMERA)!=PackageManager.PERMISSION_GRANTED){requestPermissions(arrayOf(Manifest.permission.CAMERA),REQUEST_CAMERA)return}}// Android 6.0以下或已授权：直接打开openCamera()}overridefunonRequestPermissionsResult(requestCode:Int,permissions:Array<String>,grantResults:IntArray){if(requestCode==REQUEST_CAMERA){if(grantResults.isNotEmpty()&&grantResults[0]==PackageManager.PERMISSION_GRANTED){openCamera()}}}companionobject{constvalREQUEST_CAMERA=1}}

案例3：后台位置权限

Android 10的变更

问题：后台位置需要单独申请

// Android 9及以下<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>// 获得前台+后台位置权限// Android 10+<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/><uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION"/>// 需要分开申请

向前兼容机制

// LocationManagerService.javabooleancheckLocationPermission(Stringpermission,intpid,intuid){ApplicationInfoappInfo=getApplicationInfo(uid);if(appInfo.targetSdkVersion<Build.VERSION_CODES.Q){// targetSdk < 29：ACCESS_FINE_LOCATION包含后台权限if(permission.equals(ACCESS_BACKGROUND_LOCATION)){returncheckPermission(ACCESS_FINE_LOCATION,pid,uid);}}else{// targetSdk >= 29：必须单独授予后台位置权限returncheckPermission(permission,pid,uid);}returncheckPermission(permission,pid,uid);}

结果：

老应用（targetSdk 28）：前台权限自动包含后台
新应用（targetSdk 29+）：必须单独申请后台权限

案例4：Scoped Storage

Android 10的变更

问题：限制外部存储访问

// Android 9及以下valfile=File(Environment.getExternalStorageDirectory(),"Download/file.txt")file.writeText("Hello")// [通过] 可以// Android 10+（Scoped Storage）file.writeText("Hello")// [未通过] 权限不足（如果targetSdk >= 29）

向前兼容机制

// Environment.javapublicstaticFilegetExternalStorageDirectory(){ApplicationInfoappInfo=ActivityThread.currentApplication().getApplicationInfo();if(appInfo.targetSdkVersion<Build.VERSION_CODES.Q){// targetSdk < 29：允许直接访问外部存储returnnewFile("/storage/emulated/0");}elseif(appInfo.targetSdkVersion<Build.VERSION_CODES.R&&appInfo.requestsLegacyExternalStorage()){// targetSdk 29：可以选择退出Scoped StoragereturnnewFile("/storage/emulated/0");}else{// targetSdk >= 30：强制Scoped StoragethrownewUnsupportedOperationException("Direct access to external storage is no longer supported");}}

临时退出机制（Android 10）：

<!-- AndroidManifest.xml --><applicationandroid:requestLegacyExternalStorage="true"><!-- targetSdk 29可以选择退出Scoped Storage --></application>

结果：

老应用（targetSdk 28）：可以直接访问外部存储
Android 10应用（targetSdk 29）：可选择退出
Android 11+应用（targetSdk 30+）：强制Scoped Storage

案例5：包可见性限制

Android 11的变更

问题：限制查询已安装应用列表

// Android 10及以下valpackages=packageManager.getInstalledPackages(0)// 返回所有已安装应用 [通过]// Android 11+valpackages=packageManager.getInstalledPackages(0)// 只返回部分应用 [未通过]（如果targetSdk >= 30）

向前兼容机制

// PackageManagerService.javaList<PackageInfo>getInstalledPackages(intflags,intuserId){ApplicationInfocallingApp=getCallingApplicationInfo();if(callingApp.targetSdkVersion<Build.VERSION_CODES.R){// targetSdk < 30：返回所有应用returngetAllPackages(flags,userId);}else{// targetSdk >= 30：只返回可见应用returngetVisiblePackages(flags,userId,callingApp);}}List<PackageInfo>getVisiblePackages(intflags,intuserId,ApplicationInfocallingApp){List<PackageInfo>result=newArrayList<>();// 1. 系统应用始终可见// 2. 相同签名的应用可见// 3. <queries>声明的应用可见// 4. 使用常见Intent的应用可见returnresult;}

适配方式：

<!-- AndroidManifest.xml --><manifest><!-- 声明需要查询的包 --><queries><!-- 特定包名 --><packageandroid:name="com.example.app"/><!-- 特定Intent --><intent><actionandroid:name="android.intent.action.VIEW"/><dataandroid:scheme="https"/></intent></queries></manifest>

向前兼容的代价

1. 代码复杂度

系统需要维护多个版本的行为逻辑：

// ActivityManagerService.javavoidstartActivity(Intentintent,ApplicationInfoappInfo){inttargetSdk=appInfo.targetSdkVersion;if(targetSdk<LOLLIPOP){// Android 5.0以前的行为startActivityLegacy(intent);}elseif(targetSdk<MARSHMALLOW){// Android 6.0以前的行为startActivityPreM(intent);}elseif(targetSdk<NOUGAT){// Android 7.0以前的行为startActivityPreN(intent);}elseif(targetSdk<OREO){// Android 8.0以前的行为startActivityPreO(intent);}elseif(targetSdk<PIE){// Android 9以前的行为startActivityPreP(intent);}elseif(targetSdk<Q){// Android 10以前的行为startActivityPreQ(intent);}elseif(targetSdk<R){// Android 11以前的行为startActivityPreR(intent);}else{// 最新行为startActivityCurrent(intent);}}

2. 性能开销

每次调用都需要检查targetSdkVersion：

// 增加判断逻辑inttargetSdk=getTargetSdkVersion();if(targetSdk<TARGET_VERSION){// 旧逻辑}else{// 新逻辑}

3. 安全风险

老应用可能绕过新的安全限制：

// targetSdk < 23的应用可以绕过运行时权限if(targetSdk<Build.VERSION_CODES.M){grantAllPermissions();// 安全隐患}

Google的应对策略

1. 强制更新targetSdkVersion

Google Play要求：

2023年8月：新应用必须targetSdk 33+ 2023年11月：应用更新必须targetSdk 33+ 2024年8月：targetSdk 34+

2. 逐步淘汰老API

// 标记废弃@DeprecatedpublicStringgetDeviceId(){}// 限制访问（Android 9+）@hidepublicStringgetDeviceId(){}// 彻底删除（未来）// public String getDeviceId() { } // 删除

3. 提供迁移指南

Google为每个Android版本提供详细的行为变更文档：

https://developer.android.com/about/versions/14/behavior-changes-14

最佳实践

1. 及时更新targetSdkVersion

android { defaultConfig { // [未通过] 不要长期使用低版本 // targetSdkVersion 22 // [通过] 保持最新 targetSdkVersion 34 } }

2. 编写兼容性代码

// [通过] 使用版本判断if(Build.VERSION.SDK_INT>=Build.VERSION_CODES.N){// Android 7.0+代码useFileProvider()}else{// Android 7.0以下代码useFileUri()}

3. 使用AndroidX

// [通过] AndroidX自动处理兼容性ContextCompat.checkSelfPermission(context,permission)ActivityCompat.requestPermissions(activity,permissions,requestCode)

4. 关注官方文档

定期查看行为变更文档：

Android 14: https://developer.android.com/about/versions/14/behavior-changes-all
Android 13: https://developer.android.com/about/versions/13/behavior-changes-all