下载

本页提供腾讯地图 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 插件。

---

Demo 工程

版本	发布日期	下载链接
1.0.0	2026-07-17	flutter_tencent_map_demo_1.0.0_20260717.zip

Demo 覆盖的功能场景包括：

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

---

运行 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