自动部署

用户使用腾讯地图 iOS SDK 支持项目开发时，可以通过 Cocoapods 自动部署将 SDK 添加到工程当中。自动部署目前仅支持 腾讯地图 iOS SDK 4.2.6.2 及以上版本。

获取CocoaPods

CocoaPods 是一种支持 Swift 和 Objective-C 项目的第三方库资源管理器，用户可通过 Cocoapods 获取腾讯地图 iOS SDK。

如果您已安装了CocoaPods，请直接跳到第二步：通过CocoaPods安装SDK。

1. 配置 ruby 的软件源

建议通过ruby安装CocoaPods。由于默认的 ruby 的软件源 “http://mirrors.tencent.com/rubygems/” 被墙阻拦导致 CocoaPods 安装失败，因此需要更新一下 ruby 的源。依次执行如下命令：

# 添加 TUNA 源并移除默认源
gem sources --add http://mirrors.tencent.com/rubygems/ --remove https://rubygems.org/
   
#(查看当前ruby的源是否成功更换)
gem sources -l 

完成上述命令后，显示如下文字则表示更新成功

*** CURRENT SOURCES *** 
http://mirrors.tencent.com/rubygems/

2. 升级 gem

将 gem 的版本更新到最新确保 Cocoapods 安装成功

sudo gem update --system

3. 安装 Cocoapods

请使用以下命令安装 Cocoapods：

sudo gem install -n /usr/local/bin cocoapods pod setup

注：Cocoapods 安装过程可能会耗时较长，也有可能受网络的状况导致失败，如果安装失败请再次尝试

通过 CocoaPods 安装 SDK

1. 创建 Podfile

5.x.x版本：

从5.1.0版本起，腾讯地图iOS SDK按功能模块划为: ‘Tencent-MapFoundation’, ‘Tencent-MapSDK’, ‘Tencent-MapVisualPlugin’, 'Tencent-MapUtils’

Podfile示例内容如下:

source 'https://github.com/CocoaPods/Specs.git'

platform :ios, '10.0'

target 'QMapKitDemo' do
  # Comment the next line if you don't want to use dynamic frameworks
  use_frameworks!
  pod 'Tencent-MapSDK', '5.1.0'
  pod 'Tencent-MapVisualPlugin', '3.1.0'
  pod 'Tencent-MapFoundation', '>=3.3.0'
  pod 'Tencent-MapUtils', '1.2.3'
  # Pods for QMapKitDemo

end

4.x.x版本:

腾讯地图SDK pod 4.4.2版本起新增子模块模式, 目前有QMapKit、QMapVisualPlugin、QMapSDKUtils和QMapFoundation模块。

自腾讯地图SDKpod 4.5.6版本起，项目中需要同时集成QMapFoundationKit方能使用地图SDK。

在当前 工程文件 (.xcodeproj) 所在文件夹下创建一个名为 Podfile 的文件。Podfile 内容如下：

platform :ios, "8.0" 		# 手机系统版本
target "QMapKitDemo" do	        # 工程的名字
    
    pod 'Tencent-MapSDK'		# 默认添加地图SDK所有子模块

    # 如果只需要添加SDK的指定子模块，请参考下面代码：
    # pod 'Tencent-MapSDK/QMapKit'               # 添加地图SDK模块                     
    # pod 'Tencent-MapSDK/QMapVisualPlugin'      # 添加地图可视化库模块
    # pod 'Tencent-MapSDK/QMapSDKUtils'          # 添加地图工具库模块
    # pod 'Tencent-MapSDK/QMapFoundation'        # 添加地图基础库模块，在4.5.6版本后需要添加

end
   
#当有多个target时，不同的target也需要各自设置
#target "QMapKitDemo1" do		# 工程的名字
#	pod 'Tencent-MapSDK'		# 添加地图SDK所有子模块
#end
   
#target "QMapKitDemo2" do		# 工程的名字
#	pod 'Tencent-MapSDK'		# 添加地图SDK所有子模块
#end

2. 安装SDK

#用于保证本地地图相关 SDK 为最新版 
pod repo update 
   
#安装 SDK
pod install

命令执行成功后，会生成 .xcworkspace 文件，打开.xcworkspace 文件以启动工程（注意：此时不能同时开启.xcodeproj文件，示例：

3. 升级 SDK

若已通过自动部署安装了腾讯地图 iOS SDK，想要更新到最新版本，可在 Podfile 文件所在目录下执行以下指令：

pod repo update # 用于保证本地地图相关SDK为最新版 
pod update

4. 安装指定版本 SDK

自动部署目前仅支持地图 iOS SDK 4.2.6.2及以上版本，使用指定版本 SDK，需修改 Podfile 文件，示例：

platform :ios, "8.0" 				# 手机系统版本
target "QMapKitDemo" do			        # 工程的名字
pod 'Tencent-MapSDK', '~> 4.2.6.2'  	        # 在此修改或添加 3D SDK 版本号
end

然后执行命令：

#用于保证本地地图相关 SDK 为最新版 
pod repo update 

# 安装 SDK
pod install