下载

本页提供腾讯地图 Flutter 插件的获取方式及 Demo 工程运行说明。

---

插件本身

插件已发布至 pub.dev，无需手动下载。在项目的 pubspec.yaml 中添加依赖即可：

dependencies:
  flutter_tencent_map: ^1.0.0

然后执行：

flutter pub get

安装完成后，在 Dart 代码中引入：

import 'package:flutter_tencent_map/flutter_tencent_map.dart';

执行 flutter pub get 后才能在 Dart 代码中通过 import 使用插件全部公开 API。

详细的依赖配置与平台设置请参考集成 Flutter 插件。

HarmonyOS 鸿蒙专项版

HarmonyOS 通过专项版（pre-release）提供，需使用 flutter-ohos 编译，并精确锁定版本（不能写 ^）：

dependencies:
  flutter_tencent_map: 1.0.1-ohos.1

flutter-ohos pub get

Android / iOS 请继续使用上面的 ^1.0.0。鸿蒙专项版的完整安装与配置见 HarmonyOS 专项指南。

---

Demo 工程

名称	适用平台	插件版本	发布日期	下载链接
flutter_tencent_map_demo	Android / iOS	^1.0.0	2026-07-17	flutter_tencent_map_demo_1.0.0_20260717.zip
flutter_tencent_map_demo_ohos	Android / iOS / HarmonyOS	1.0.1-ohos.1	2026-10-08	flutter_tencent_map_demo_ohos_1.0.1-ohos.1_20261008.zip

两个 Demo 的区别：第一个使用主线 Flutter 构建，只含 Android / iOS；第二个依赖鸿蒙专项版，三端都需使用 flutter-ohos 构建，并额外提供 HarmonyOS 端。只开发 Android / iOS 请使用第一个。

Demo 覆盖的功能场景包括：

• 地图显示与配置（地图类型、UI 控件、手势控制）
• 相机控制（移动、缩放、动画、区域限制）
• 地图事件（点击、长按、POI 点击、相机回调）
• 覆盖物（Marker / Polyline / Polygon / Circle / Arc）
• 定位图层（小蓝点、自定义图标、定位模式）
• 个性化地图样式
• 自定义纹理与 BitmapDescriptor
• Marker 碰撞控制
• 手势冲突处理
• Android 渲染模式（SurfaceView / TextureView）
• 多地图实例

---

运行 Demo

以下步骤适用于 flutter_tencent_map_demo（Android / iOS，主线 Flutter）。运行鸿蒙 Demo 请看本节末尾的「运行鸿蒙 Demo」。

前置条件

• 已安装 Flutter SDK（≥ 3.27，推荐 3.41）
• 已安装 JDK 17（Flutter 3.27+ 通常已自带）
• 已申请腾讯地图 API Key（腾讯位置服务开放平台）

步骤

1. 下载并解压压缩包后，进入解压出的项目根目录，执行：

   flutter pub get
   

2. 打开 lib/const_config.dart，将示例中占位的 API Key 替换为你申请到的 Android / iOS Key：

   const kApiKey = TencentMapApiKey(
     iosKey: 'YOUR_IOS_KEY',
     androidKey: 'YOUR_ANDROID_KEY',
   );
   

3. 安卓也可以打开 android/app/src/main/AndroidManifest.xml，将 <meta-data> 中的占位值替换为你申请到的 Android Key：

   <meta-data
       android:name="TencentMapSDK"
       android:value="YOUR_ANDROID_KEY" />
   

4. 连接真机，运行 Demo：

   flutter run -d YOUR_DEVICE_ID
   

   ⚠️ 建议使用真机测试。模拟器可能无法正常渲染地图或获取定位。

iOS 额外步骤

首次运行 iOS 端前，需进入 ios/ 目录执行 CocoaPods 安装：

cd ios
pod install --repo-update

详细的 iOS 工程配置（权限声明、Info.plist 用途字符串等）请参考集成 Flutter 插件。

使用 FVM（可选）

如果项目使用 FVM 管理 Flutter 版本，所有命令前加 fvm 前缀：

fvm flutter pub get
fvm flutter run -d YOUR_DEVICE_ID

运行鸿蒙 Demo

flutter_tencent_map_demo_ohos 包含 Android / iOS / HarmonyOS 三端，三端统一使用 flutter-ohos（Flutter 3.22.1-ohos-1.0.9）构建。

1. 下载并解压压缩包，进入项目根目录，执行 flutter-ohos pub get。
2. 打开 lib/const_config.dart，填入三个平台各自的 Key（androidKey / iosKey / ohosKey）。Android 另需在 AndroidManifest.xml 中替换 Key 占位值。
3. HarmonyOS：用 DevEco Studio 打开 ohos/ 目录配置签名，并将 ohos/AppScope/app.json5 的 bundleName 改为与控制台绑定一致的值。
4. 运行：flutter-ohos run -d YOUR_DEVICE_ID。

⚠️ 注意：Android 构建需要 JDK 11，HarmonyOS 构建需要 JDK 17 与 DEVECO_SDK_HOME。完整步骤与常见问题见 Demo 根目录的 README.md 与 HarmonyOS 专项指南。