Android11 新特性与适配指南

Android 11（API 30）引入了多项重要特性和权限变更，核心集中在存储权限、后台位置、包可见性、前台服务等方面。本文基于 Kotlin 语言，从核心变更点、适配方案、代码示例等维度讲解适配要点。

一、核心变更概览

二、分区存储适配（最核心）

1. 变更说明

Android 11 强制启用分区存储（Scoped Storage），应用只能访问：

• 应用私有目录（/Android/data/包名/）：无需权限
• 媒体文件（图片/音频/视频）：通过 MediaStore API 访问
• 下载文件：通过DownloadManager或存储访问框架（SAF）

2. 适配方案

（1）基础配置（清单文件）

<!-- 保留旧权限（兼容低版本），但Android 11不再生效 --><uses-permissionandroid:name="android.permission.READ_EXTERNAL_STORAGE"/><uses-permissionandroid:name="android.permission.WRITE_EXTERNAL_STORAGE"android:maxSdkVersion="28"/><!-- Android 11访问媒体文件仅需读权限 --><uses-permissionandroid:name="android.permission.READ_EXTERNAL_STORAGE"/><!-- 如需批量修改/删除媒体文件，需申请此权限 --><uses-permissionandroid:name="android.permission.MANAGE_EXTERNAL_STORAGE"tools:ignore="ScopedStorage"/><!-- 可选：临时关闭分区存储（仅过渡用，不推荐） --><applicationandroid:requestLegacyExternalStorage="true"android:targetSdkVersion="30"></application>

（2）读取媒体文件（Kotlin）

通过 MediaStore 查询图片示例：

/** * 读取设备中的图片文件 */funqueryImages(context:Context):List<Uri>{valimageUris=mutableListOf<Uri>()valprojection=arrayOf(MediaStore.Images.Media._ID,MediaStore.Images.Media.DISPLAY_NAME,MediaStore.Images.Media.DATE_ADDED)// 按添加时间倒序查询valsortOrder="${MediaStore.Images.Media.DATE_ADDED}DESC"context.contentResolver.query(MediaStore.Images.Media.EXTERNAL_CONTENT_URI,projection,null,null,sortOrder)?.use{cursor->validColumn=cursor.getColumnIndexOrThrow(MediaStore.Images.Media._ID)while(cursor.moveToNext()){valid=cursor.getLong(idColumn)valuri=ContentUris.withAppendedId(MediaStore.Images.Media.EXTERNAL_CONTENT_URI,id)imageUris.add(uri)}}returnimageUris}

（3）写入媒体文件（Kotlin）

保存图片到公共相册示例：

/** * 保存图片到公共相册 * @param bitmap 要保存的图片 * @param displayName 文件名 */funsaveImageToGallery(context:Context,bitmap:Bitmap,displayName:String):Uri?{valcontentValues=ContentValues().apply{put(MediaStore.Images.Media.DISPLAY_NAME,displayName)put(MediaStore.Images.Media.MIME_TYPE,"image/jpeg")put(MediaStore.Images.Media.RELATIVE_PATH,"Pictures/MyApp")// 保存到Pictures/MyApp目录if(Build.VERSION.SDK_INT>=Build.VERSION_CODES.Q){put(MediaStore.Images.Media.IS_PENDING,1)// 标记为待处理}}valcontentUri=MediaStore.Images.Media.EXTERNAL_CONTENT_URIvaruri:Uri?=nulltry{uri=context.contentResolver.insert(contentUri,contentValues)uri?.let{context.contentResolver.openOutputStream(it)?.use{outputStream->bitmap.compress(Bitmap.CompressFormat.JPEG,90,outputStream)}if(Build.VERSION.SDK_INT>=Build.VERSION_CODES.Q){contentValues.clear()contentValues.put(MediaStore.Images.Media.IS_PENDING,0)context.contentResolver.update(it,contentValues,null,null)}}}catch(e:Exception){uri?.let{context.contentResolver.delete(it,null,null)}e.printStackTrace()}returnuri}

（4）批量操作媒体文件（需 MANAGE_EXTERNAL_STORAGE 权限）

/** * 检查是否有管理所有文件的权限 */funhasManageExternalStoragePermission(context:Context):Boolean{returnif(Build.VERSION.SDK_INT>=Build.VERSION_CODES.R){Environment.isExternalStorageManager()}else{true}}/** * 申请管理所有文件的权限 */funrequestManageExternalStoragePermission(activity:Activity){if(Build.VERSION.SDK_INT>=Build.VERSION_CODES.R&&!Environment.isExternalStorageManager()){valintent=Intent(Settings.ACTION_MANAGE_APP_ALL_FILES_ACCESS_PERMISSION).apply{data=Uri.parse("package:${activity.packageName}")}activity.startActivityForResult(intent,REQUEST_CODE_MANAGE_STORAGE)}}

三、后台位置权限适配

1. 变更说明

Android 11 要求后台位置权限需单独申请，且必须先获得前台位置权限（ACCESS_FINE_LOCATION/ACCESS_COARSE_LOCATION）。

2. 适配代码

（1）清单声明

<uses-permissionandroid:name="android.permission.ACCESS_FINE_LOCATION"/><uses-permissionandroid:name="android.permission.ACCESS_COARSE_LOCATION"/><uses-permissionandroid:name="android.permission.ACCESS_BACKGROUND_LOCATION"/>

（2）权限申请逻辑

// 权限请求码privateconstvalREQUEST_CODE_LOCATION=1001/** * 检查并申请位置权限 */funcheckAndRequestLocationPermission(activity:Activity){valforegroundPermissions=arrayOf(Manifest.permission.ACCESS_FINE_LOCATION,Manifest.permission.ACCESS_COARSE_LOCATION)// 先检查前台位置权限if(ContextCompat.checkSelfPermission(activity,foregroundPermissions[0])!=PackageManager.PERMISSION_GRANTED){ActivityCompat.requestPermissions(activity,foregroundPermissions,REQUEST_CODE_LOCATION)}else{// 前台权限已获取，申请后台位置权限（Android 11+）if(Build.VERSION.SDK_INT>=Build.VERSION_CODES.R&&ContextCompat.checkSelfPermission(activity,Manifest.permission.ACCESS_BACKGROUND_LOCATION)!=PackageManager.PERMISSION_GRANTED){ActivityCompat.requestPermissions(activity,arrayOf(Manifest.permission.ACCESS_BACKGROUND_LOCATION),REQUEST_CODE_LOCATION)}}}/** * 处理权限申请结果 */overridefunonRequestPermissionsResult(requestCode:Int,permissions:Array<outString>,grantResults:IntArray){super.onRequestPermissionsResult(requestCode,permissions,grantResults)if(requestCode==REQUEST_CODE_LOCATION){if(grantResults.isNotEmpty()&&grantResults[0]==PackageManager.PERMISSION_GRANTED){// 权限已授予if(Build.VERSION.SDK_INT>=Build.VERSION_CODES.R&&permissions.contains(Manifest.permission.ACCESS_BACKGROUND_LOCATION)){// 后台位置权限处理}}else{// 权限被拒绝，引导用户到设置页开启if(!ActivityCompat.shouldShowRequestPermissionRationale(this,permissions[0])){valintent=Intent(Settings.ACTION_APPLICATION_DETAILS_SETTINGS).apply{data=Uri.parse("package:$packageName")}startActivity(intent)}}}}

四、包可见性适配

1. 变更说明

Android 11 限制应用查询设备上其他应用的信息，需在AndroidManifest.xml中声明需要访问的应用包名或意图。

2. 适配方案

（1）声明可见应用（清单文件）

<queries><!-- 允许查询特定包名的应用 --><packageandroid:name="com.example.targetapp"/><!-- 允许查询支持特定意图的应用 --><intent><actionandroid:name="android.intent.action.VIEW"/><dataandroid:scheme="http"/></intent><!-- 允许查询所有已安装应用（仅特殊场景使用） --><packageandroid:name="androidx.core.content.pm.PackageManagerCompat"/></queries>

（2）查询应用是否安装（Kotlin）

/** * 检查应用是否安装（Android 11+适配） */funisAppInstalled(context:Context,packageName:String):Boolean{returntry{if(Build.VERSION.SDK_INT>=Build.VERSION_CODES.TIRAMISU){context.packageManager.getPackageInfo(packageName,PackageManager.PackageInfoFlags.of(0))}else{@Suppress("DEPRECATION")context.packageManager.getPackageInfo(packageName,0)}true}catch(e:PackageManager.NameNotFoundException){false}}

五、前台服务适配

1. 变更说明

Android 11 要求前台服务必须指定类型（如location、mediaPlayback等），且禁止后台应用启动前台服务（特殊场景需申请SYSTEM_ALERT_WINDOW权限）。

2. 适配代码

（1）清单声明前台服务类型

<serviceandroid:name=".MyForegroundService"android:foregroundServiceType="location|mediaPlayback"><intent-filter><actionandroid:name="com.example.MyForegroundService"/></intent-filter></service>

（2）启动前台服务（Kotlin）

/** * 启动前台服务（Android 11+适配） */funstartForegroundService(context:Context){valserviceIntent=Intent(context,MyForegroundService::class.java)if(Build.VERSION.SDK_INT>=Build.VERSION_CODES.O){context.startForegroundService(serviceIntent)}else{context.startService(serviceIntent)}}// 服务内部实现classMyForegroundService:Service(){privatevalNOTIFICATION_ID=1001privatevalCHANNEL_ID="ForegroundServiceChannel"overridefunonStartCommand(intent:Intent?,flags:Int,startId:Int):Int{createNotificationChannel()valnotification=NotificationCompat.Builder(this,CHANNEL_ID).setContentTitle("前台服务标题").setContentText("前台服务内容").setSmallIcon(R.drawable.ic_notification).build()// Android 11+需指定服务类型if(Build.VERSION.SDK_INT>=Build.VERSION_CODES.R){startForeground(NOTIFICATION_ID,notification,ServiceInfo.FOREGROUND_SERVICE_TYPE_LOCATION)}else{startForeground(NOTIFICATION_ID,notification)}// 业务逻辑处理returnSTART_STICKY}privatefuncreateNotificationChannel(){if(Build.VERSION.SDK_INT>=Build.VERSION_CODES.O){valchannel=NotificationChannel(CHANNEL_ID,"前台服务通道",NotificationManager.IMPORTANCE_DEFAULT)valmanager=getSystemService(NotificationManager::class.java)manager.createNotificationChannel(channel)}}overridefunonBind(intent:Intent):IBinder?=null}

六、其他适配要点

1. 权限对话框「仅本次」选项处理

Android 11 新增「仅本次」权限授权选项，需处理权限临时授权的场景：

/** * 检查权限是否为临时授权（仅本次） */funisPermissionTemporaryGranted(activity:Activity,permission:String):Boolean{returnif(Build.VERSION.SDK_INT>=Build.VERSION_CODES.R){ActivityCompat.checkSelfPermission(activity,permission)==PackageManager.PERMISSION_GRANTED&&!ActivityCompat.shouldShowRequestPermissionRationale(activity,permission)}else{false}}

2. 悬浮窗权限适配

/** * 检查悬浮窗权限 */funhasOverlayPermission(context:Context):Boolean{returnif(Build.VERSION.SDK_INT>=Build.VERSION_CODES.M){Settings.canDrawOverlays(context)}else{true}}/** * 申请悬浮窗权限 */funrequestOverlayPermission(activity:Activity,requestCode:Int){if(Build.VERSION.SDK_INT>=Build.VERSION_CODES.M&&!Settings.canDrawOverlays(activity)){valintent=Intent(Settings.ACTION_MANAGE_OVERLAY_PERMISSION).apply{data=Uri.parse("package:${activity.packageName}")}activity.startActivityForResult(intent,requestCode)}}

七、适配建议

1. 分阶段适配：先兼容 Android 11 核心变更（存储、位置），再处理次要特性；
2. 测试覆盖：在 Android 11 真机/模拟器上测试，重点验证权限申请、文件操作、后台服务；
3. 兼容低版本：使用Build.VERSION.SDK_INT做版本判断，保证低版本正常运行；
4. 避免滥用权限：MANAGE_EXTERNAL_STORAGE仅在必要时申请，优先使用分区存储 API；
5. 遵循官方规范：定期查看 Android 11 官方适配文档 跟进最新变更。

八、参考资源

• 安卓11官方文档
• 安卓11行为变更

以上适配方案覆盖 Android 11 核心变更点，可根据项目实际需求调整代码逻辑。