1. 程式人生 > >安裝 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 內容如下(以 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