Swift接入腾讯地图SDK

前言

腾讯地图iOS SDK目前只提供了Objective-C版本的SDK, 因此如果是Swift项目, 则需要自己通过Bridging文件来将其引入

使用场景：

Swift项目接入腾讯地图.

准备：

接入流程

1. 创建Swift项目, 本人采用的是StoryBoard创建的项目, 不过使用方法是一样的:

   
   
   image.png

2. 将SDK的framework和bundle导入项目中:

   
   
   image.png

3. 创建HeaderFile, 通常明明为"项目名称-Bridging-header", 即:TencentMapSwiftDemo-Bridging-header.h, 放在根目录(位置放在那里都可以, 区别只是路径不同):

   
   
   image.png

4. 进入项目配置, 选择TARGETS-TencentMapSwiftDemo, 然后进入到Build Setting中. 在搜索栏中搜索Bridging, 并在Objective-C Bridging Header选项中输入: $(SRCROOT)/TencentMapSwiftDemo-Bridging-header.h($(SRCROOT)为快捷指令, 可以直接识别项目的根路径):
   

   image.png

如果编译没有出错, 则进行第五步, 否则请检查路径是否正确, 是否有多余的空格/换行等等, 比如下列报错, 就是本人在输入的时候不小心在最后加了一个空格导致的路径错误:

image.png

5. 编译通过的话就可以在BridgingHeader文件中导入Objective-C的框架了:

   #ifndef TencentMapSwiftDemo_Bridging_header_h
   #define TencentMapSwiftDemo_Bridging_header_h
   
   #import 
   #import 
   
   #endif /* TencentMapSwiftDemo_Bridging_header_h */
   

6. 别忘了根据文档所示, 需要添加libsqlite3.tbd、libc++.tbd两个依赖库:
   

   image.png

7. 到此就可以使用地图SDK了, 首先在AppDelegate里面配置好Key:

   import UIKit
   
   @main
   class AppDelegate: UIResponder, UIApplicationDelegate {
   
       var window: UIWindow?
   
       func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
           
           QMapServices.shared().apiKey = "我的Key"
           QMSSearchServices.shared()?.apiKey = "我的Key"
           
           return true
       }
   }
   

8. 最后, 附加一段ViewController中的基本使用:

   import UIKit
   
   class ViewController: UIViewController, QMSSearchDelegate {
   
       var mapView : QMapView!
       lazy var tencentSearcher : QMSSearcher = {
           return QMSSearcher.init(delegate: self)
       }()
       
       
       // MARK: 配置MapView
       func setupMapView() {
           mapView = QMapView.init(frame: UIScreen.main.bounds)
           view.addSubview(mapView)
       }
       
       // MARK: 配置Searcher
       func searchCurrentPositionPois() {
           let currentCoordinate = mapView.centerCoordinate
           let searchOption = QMSPoiSearchOption()
           searchOption.keyword = "美食"
           searchOption.setBoundaryByNearbyWithCenter(currentCoordinate, radius: 1000, autoExtend: false)
           tencentSearcher.search(with: searchOption)
       }
       
       // MARK: Searcher 代理方法
       func search(with poiSearchOption: QMSPoiSearchOption, didReceive poiSearchResult: QMSPoiSearchResult) {
           print(poiSearchResult)
       }
       
       func search(with searchOption: QMSSearchOption, didFailWithError error: Error) {
           print(error)
       }
       
       // MARK: 生命周期方法
       override func viewDidLoad() {
           super.viewDidLoad()
           
           // 配置MapView
           setupMapView()
           
           // 发起POI检索
           searchCurrentPositionPois()
       }
   }
   

图片示例：展示基本地图和坐标点附近POI的检索(逼不得已才将log中的tel字段给马赛克了, 别问我为什么, 问审核大哥)

image.png

点评

1. 期待可以出Pods, 就不用手动集成这么麻烦了
2. 目前官方文档中的示例只有Objective-C版本的, 期望可以出个Swfit版本