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