兼容性说明

本文档介绍 flutter_tencent_map 插件对 Flutter 版本、Android/iOS 系统版本、以及腾讯地图 SDK 版本的兼容性要求。


Flutter 与 Dart 版本

项目 最低版本 推荐版本
Flutter 2.0.0 3.16.0+
Dart SDK 2.14.0 3.2.0+

注意:插件使用了 Set<T> diff、Factory<T> 等需要 Dart 2.14+ 的语言特性。


Android 版本要求

项目
minSdkVersion 21(Android 5.0)
compileSdkVersion 31(Android 12)
targetCompatibility Java 1.8
原生语言 Java(不使用 Kotlin)

iOS 版本要求

项目
Deployment Target 13.0
原生语言 Objective-C

腾讯地图 SDK 版本

插件采用双版本兼容策略:

平台 低版本(编译基准) 高版本(反射目标)
Android 5.9.0 6.10.0+
iOS 5.7.7 6.9.0+

兼容策略说明

  • 低版本:作为 compileOnly(Android)/ podspec(iOS)的依赖基准。插件编译时只引用低版本 SDK 中已有的 API,保证插件能在低版本 SDK 环境下正常编译和运行。
  • 高版本:SDK 升级到高版本后,新增的 API 通过 Compat 反射层(respondsToSelector / 反射调用)按需启用,无需升级插件即可享受新特性。

环境检查清单

在开始集成前,请确认以下环境已就绪:

  • Flutter SDK 已安装(flutter doctor 无错误)
  • Android Studio / Xcode 已安装
  • 已在腾讯位置服务控制台申请 API Key
  • Android 包名 / iOS Bundle ID 已在控制台正确配置
本页内容