开发 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 内容如下: 

platform :ios, '8.0' 
target 'YourProjectTarget' do
	pod 'AMapNavi' 
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

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

升级 SDK

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

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

指定 SDK 版本

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

platform :ios, '8.0' 
target 'YourProjectTarget' do
	pod 'AMapNavi', '7.6.0' #此处指定版本号
end
返回顶部 示例中心 常见问题 智能客服 公众号
二维码