6月产品上新｜Flutter SDK 正式上线，一份Dart 代码，双端跑通定位与地图！

位置服务跨端开发者久等啦！

过去开发者们在 Flutter 里做定位和地图，要么自己用 MethodChannel 手写桥接，容易踩平台差异的坑，要么依赖第三方方案，能力完整度和长期维护都难有保障。

腾讯位置服务正式发布官方 Flutter 插件，定位 SDK 与地图 SDK 现已全面完成 Flutter 适配。开发者只需编写一套 Dart 代码，即可在 Android 与 iOS 双端直接调用原生级能力，无需额外适配。

这不仅大幅降低了Flutter 开发者的接入门槛，更让开发者能以最小成本获得与原生 SDK 对齐的定位和地图功能。且该插件由腾讯位置服务官方团队持续维护，确保长期稳定更新与技术支持，为您的跨端应用提供可靠的位置服务底座。

PART 01

腾讯位置服务定位 SDK：跨端定位能力一站式打包

定位插件 （tencent_location_flutter_plugin） 为同一份 Dart 代码提供跨平台的定位、地理围栏、设备朝向、坐标工具等完整能力。

# 核心能力一览

# 一段代码看懂接入

DART CODE
import 'package:tencent_location_flutter_plugin/tencent_location_flutter_plugin.dart';

Future<void> main() async {
  // ① 隐私合规同意
  await TencentLocationSDK.setPrivacyPolicyAgreement(true);

  // ② 初始化（双端各自的 Key）
  await TencentLocationSDK.init(
    androidApiKey: 'YOUR_ANDROID_API_KEY',
    iosApiKey: 'YOUR_IOS_API_KEY',
  );

  // ③ 发起一次单次定位
  final manager = TencentLocationManager();
  final loc = await manager.startSingleLocation(
    TencentLocationRequest.create()..setRequestLevel(RequestLevel.adminArea),
  );
  print('当前位置：${loc.latitude}, ${loc.longitude}');
}

PART 02

腾讯位置服务地图 SDK：核心功能对齐原生

PART 03

腾讯位置服务Flutter插件亮点

腾讯位置服务Flutter插件不是简单地把原生 API「翻译」一遍，而是围绕 Flutter 的声明式范式做了系统性的工程设计。

# 亮点 1 · 接入快

双端零配置接入，开箱即用

无论 Android 还是 iOS 都无需手动配 SDK 依赖、无需改原生工程文件，双端统一零配置，把接入成本压到最低。

● Android：工具包已发布至 Maven 中央仓库，构建工具自动拉取，无需手动配置

● IOS ：依赖声明文件自动处理，执行依赖安装即用

● Key 与隐私合规：统一在 Dart 层传入

# 亮点 2 · 代码省

声明式 API，贴合 Flutter 范式

覆盖物（点标记 / 折线 / 多边形 / 圆形）采用声明式管理，只需描述"想要什么状态"，插件自动对比差异、只同步变化部分，状态清晰、性能更好、代码更简洁。

同时数据模型均为不可变设计，契合 Flutter 习惯。

# 亮点 3 ·走得远

Compat分层架构，从容应对多版本

用户设备上的地图工具包版本可能不一样，而插件则是以最低版本为编译基准（Android 5.9.0 / iOS 5.7.7），通过 Compat 分层 + 启动时能力检测缓存兼容到最新版：

TECH NOTE

业务代码

→ XxxCompat（统一接口，按版本分支）                     

→ SdkCompat（启动时检测一次并缓存）                    

→ TencentMap SDK（5.9.0 ~ 最新版）

检测只在启动时做一次，运行时走纯 if/else，零反射开销；新增差异点只需改 Compat 文件，不污染业务代码。

# 亮点 4 · 适配准

渲染模式自动选择，用户可选

不必纠结Android 的两种渲染方式怎么选，插件默认自动按系统版本为你选择最优模式，同时也支持强制指定——既兼顾性能与兼容性，又把选择权交回开发者手中，灵活适配各类机型与场景。

DART CODE

enum AndroidViewMode { auto, surfaceView, textureView }

# 亮点5 · 跑得稳

初始化时序内部封装，平台细节双端一致

地图工具包初始化步骤有严格顺序要求，顺序错误会导致白屏或崩溃等问题。

从隐私合规➡️SDK启动➡️ API key➡️创建地图，插件将正确的初始化时序封装在内部，开发者无需操心。同时坐标系、覆盖物渲染等双端差异也一并细致封装与对齐，同一份代码彻底双端一致。

PART 04

接入前后，开发者省了什么

# 告别6件烦心事，Flutter插件提高开发者生产力

💡一句话总结：你写业务，跨端的复杂度交给官方插件。

您在使用过程中有任何问题

都可前往腾讯位置服务官网「提交工单」