开发 iOS 地图SDK 开发指南 创建工程 自动部署

自动部署 最后更新时间: 2024年03月18日

自动部署省去您配置工程的时间,更高效的完成您的应用。自动部署引导流程在入门指南中做了详细的介绍,您可前往去查看。这里仅对一些注意事项进行着重说明。

安装 CocoaPods

1、设置 ruby 的软件源。

由于默认的 ruby 的软件源(https://rubygems.org/)被墙阻拦导致 CocoaPods 安装失败,因此需要更新一下 ruby 的源。依次执行如下命令:

gem sources -l #(查看当前ruby的源)
gem sources --remove https://rubygems.org/ #(移除当前ruby的源)
gem sources -a https://ruby.taobao.org/ #(设置当前ruby源为淘宝源)
gem sources -l #(再次查看当前ruby的源)

显示如下文字表示更新成功。

*** CURRENT SOURCES ***

https://ruby.taobao.org/

2、升级 gem。

gem 版本较低也可能导致安装或者升级失败,所以需要升级 gem。使用以下命令:

sudo gem update --system

3、安装 CocoaPods

检查一下您的 OS X 的版本。

若您的 OS X 版本小于等于 10.11,依次执行下面的命令安装 CocoaPods。

sudo gem install cocoapods
pod setup

大于 10.11,使用如下命令安装。

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

注意:安装过程可能会耗时比较长,也有可能受网络状况影响造成失败,需要多次尝试直到成功。

使用 CocoaPods 安装 SDK

1、在您当前工程文件(.xcodeproj)所在文件夹下创建一个名为 Podfile 的文件。如果您尚未创建 Xcode 项目,请立即创建一个并将其保存到您的本地计算机。 Podfile 内容如下(以 3D 地图 SDK 为例,其他 SDK 的 Pod 库名称参考下表):

platform :ios, '7.0' #手机的系统
target 'YourProjectTarget' do #工程名字
     pod 'AMap3DMap'  #3D地图 SDK
end

高德 iOS SDK 的 Pod 库的名称如下表:


IFDA版本

NO IDFA版本

备注

3D地图SDK

AMap3DMap

AMap3DMap-NO-IDFA

3D地图与2D地图不能同时使用

2D地图SDK

AMap2DMap

AMap2DMap-NO-IDFA

3D地图与2D地图不能同时使用

搜索功能

AMapSearch

AMapSearch-NO-IDFA


定位SDK

AMapLocation

AMapLocation-NO-IDFA


导航SDK

AMapNavi

AMapNavi-NO-IDFA

已包含3D地图,无需单独引入3D地图

2、然后执行下面命令进行配置并安装 SDK。

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

注意:$pod 'AMapLocation' 命令还会引入基础 SDK ,涉及到提交AppStore成功与否,请点我查看基础 SDK 的介绍

3、命令执行成功后,会生成 .xcworkspace 文件,打开.xcworkspace 文件以启动工程(注意:此时不能同时开启.xcodeproj文件),如下所示。

升级 SDK

若已经安装了高德 iOS 地图 SDK,想更新到最新版本。在 Podfile 文件的目录下使用以下命令:

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

注意:pod update 命令会连带更新基础 SDK ,涉及到提交AppStore成功与否,请点我查看基础 SDK 的介绍

指定 SDK 版本

使用指定版本 SDK,需要修改 Podfile 文件,添加版本相关信息,其文件内容如下:

platform :ios, '7.0' #手机的系统
target 'YourProjectTarget' do  #工程名字
   pod 'AMap3DMap', '~>4.4.1'#此处指定版本号
end

再执行命令:

pod repo update #用于保证本地地图相关SDK为最新版
pod install
返回顶部 示例中心 常见问题 智能客服 公众号
二维码