安装 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