Flutter 适配实战：不同 Android 版本的兼容性处理方案

在 Android 生态中，版本碎片化问题严重（据统计，Android 11 以下设备占比超 40%）。Flutter 开发者需重点处理以下兼容性问题：

1. 权限管理（Android 6.0+）

• 问题：Android 6.0 (API 23) 引入运行时权限机制
• 解决方案：

  // 使用 permission_handler 插件
  if (await Permission.location.isDenied) {
    await Permission.location.request();
  }
  // 旧版本自动获得安装时授权
  

2. 通知渠道（Android 8.0+）

• 问题：Android 8.0 (API 26) 要求通知必须关联渠道
• 兼容方案：

  Future<void> showNotification() async {
    final AndroidNotificationDetails androidDetails = AndroidNotificationDetails(
      Platform.isAndroid && sdkVersion >= 26 
        ? 'channel_id' // 8.0+ 需要渠道ID
        : 'default_channel',
      'Channel Name'
    );
    await flutterLocalNotifications.show(0, '标题', '内容', NotificationDetails(android: androidDetails));
  }
  

3. 存储访问（Android 10/11+）

• 问题：
  • Android 10 (API 29) 引入作用域存储
  • Android 11 (API 30) 加强权限管理
• 处理方案：

  // 使用 path_provider 获取安全路径
  final Directory dir = await getApplicationDocumentsDirectory();
  final File file = File('${dir.path}/data.txt');
  
  // 媒体文件访问使用 image_picker
  final XFile? image = await ImagePicker().pickImage(source: ImageSource.gallery);
  

4. 后台定位（Android 10+）

• 问题：Android 10 限制后台定位访问
• 适配代码：

  void requestLocation() async {
    if (Platform.isAndroid && sdkVersion >= 29) {
      await Permission.locationAlways.request(); // 10+ 需要持续定位权限
    } else {
      await Permission.locationWhenInUse.request();
    }
  }
  

5. 全屏显示适配（Android 4.4+）

• 问题：异形屏和手势导航栏遮挡内容
• 解决方案：

  Scaffold(
    body: SafeArea( // 自动避开系统栏
      bottom: false, // 保留底部手势区
      child: ListView(...)
    )
  )
  

6. 网络安全性配置（Android 9+）

• 问题：Android 9 (API 28) 默认阻止明文流量
• 修复步骤：
  1. 创建 android/app/src/main/res/xml/network_security_config.xml：

     <network-security-config>
       <domain-config cleartextTrafficPermitted="true">
         <domain includeSubdomains="true">yourdomain.com</domain>
       </domain-config>
     </network-security-config>
     

  2. 在 AndroidManifest.xml 引用：

     <application 
        android:networkSecurityConfig="@xml/network_security_config"
     

7. 版本检测通用方法

// 获取 Android SDK 版本
int get androidSdkVersion {
  if (Platform.isAndroid) {
    final systemVersion = DeviceInfoPlugin().androidInfo.then((info) => info.version.sdkInt);
    return systemVersion ?? 0;
  }
  return 0;
}

// 使用示例
if (androidSdkVersion >= 23) {
  // 执行运行时权限请求
}

最佳实践总结

1. 最低版本控制：建议 minSdkVersion >= 21（Android 5.0）
2. 分级加载：通过 androidSdkVersion 动态加载不同实现
3. 插件选择：优先选用维护积极的插件（如 permission_handler、device_info_plus）
4. 测试覆盖：使用 Android 模拟器覆盖关键版本（5.0、8.0、10.0、12.0）

通过条件编译和版本检测，可有效实现“一次编写，多版本适配”。重点适配区间应覆盖 Android 8.0-12（占活跃设备 85% 以上），同时确保基础功能在 Android 5.0+ 正常运行。