安装 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 内容如下(以高德地图2D SDK 为例):
platform :ios, '9.0' target 'PodTest' do pod 'AMapSearch-NO-IDFA'#地图SDK搜索功能 pod 'AMap2DMap-NO-IDFA'#2D地图SDK end
2、然后执行下面命令进行配置并安装 SDK。
pod repo update #用于保证本地地图相关SDK为最新版
pod install
3、命令执行成功后,会生成 .xcworkspace 文件,打开.xcworkspace 文件以启动工程(注意:此时不能同时开启.xcodeproj文件),如下所示。
4、下次更新时直接执行以下命令即可:
pod repo update #用于保证本地地图相关SDK为最新版
pod update
异常情况处理
执行install时,提示如下失败信息
[!] Unable to add a source with url `https://github.com/CocoaPods/Specs.git` named `master`.You can try adding it manually in `~/.cocoapods/repos` or via `pod repo add`.
可能是由于安装了两个xcode导致的,需要指定xcode路径
xcode-select -p
输出:
/Applications/Xcode.app/Contents/Developer
执行以下命令,指定xcode路径
sudo xcode-select -switch /Applications/Xcode.app/
再执行pod install,就可以了
小结:Profile文件不能有后缀,否则会报错:[!] No `Podfile' found in the project directory.
去掉文件后缀的方法
1、点击上方Fileder->偏好设置->显示所有文件扩展名 打勾
2、重命名文件,将文件后面的扩展名去掉就可以了
以上是我在引入高德sdk时,操作的所有步骤,上面大部分步骤都是高德指南中写到的,仅此做个记录。
高德指南路径:http://lbs.amap.com/api/ios-sdk/guide/create-project/cocoapods