1. 程式人生 > >cocoapods 安裝並引入高德地圖

cocoapods 安裝並引入高德地圖

安裝 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時,操作的所有步驟,上面大部分步驟都是高德指南中寫到的,僅此做個記錄。