CocoaPods
XCode7
Swift2.0

CocoaPodsの導入と利用

More than 3 years have passed since last update.

Swift2を勉強中なので備忘録備忘録。

開発を進めていく上でライブラリの利用は必要不可欠ですよね。

iOSアプリ開発においては、CocoaPodsというライブラリ管理ツールを利用するのが定番中の定番みたいです。

ということで今回はその導入、そして利用まで進めていきます。


動作環境


  • OS X El Capitan(10.11.2)

  • Xcode 7.2

  • Swift 2


インストール手順

ターミナル開いて以下のコマンドを実行しましょう。

まずはインストール

$ sudo gem install cocoapods

そしてセットアップ

$ pod setup

これで完了。とっても簡単です。


使ってみる


プロジェクトへのCocoaPods導入

インストールは終わったものの、プロジェクトで利用するにはまだ下準備が必要です。

それではターミナル上でプロジェクトフォルダ(xcodeprojファイルがある場所)へ移動しましょう。

そこで下記のコマンドを実行してくだい。

$ pod init

さすれば、ディレクトリ内に Podfile が作成されていることでしょう。


CocoaPodsを使ってライブラリの導入

Podfile を開くとこのような内容になっています。

# Uncomment this line to define a global platform for your project

# platform :ios, '8.0'
# Uncomment this line if you're using Swift
# use_frameworks!

target 'testCocoa' do

end

これを以下のように編集して、導入したいライブラリを以下のように追記しましょう。

(2行のコメントアウト解除も忘れずに!)

# Uncomment this line to define a global platform for your project

platform :ios, '8.0'
# Uncomment this line if you're using Swift
use_frameworks!

target 'testCocoa' do
pod 'SwiftyJSON', :git=> 'https://github.com/SwiftyJSON/SwiftyJSON'
end

今回はJSONを扱うためには必須とも言えるライブラリ、

SwiftyJSONを例にしてみました。

他にもたくさんライブラリがあるので、公式サイトで検索してみるのもいいのではないでしょうか。

ここにのってるのは大概 本家の方にも記述のしかたについて載ってると思います。

ここで本題に戻りますが、編集が終わったら以下のコマンドでインストールしましょう。

$ pod install

ちなみに、このインストールが永遠に終わらないこともあったりなかったり。

(当方は前者)

以下のコマンドで治ると思われます。もしこんな症状になったら試してみましょう。

$ pod repo remove master

$ pod setup
$ pod install

インストールが成功したら、プロジェクトディレクトリに

testCocoa.xcworkspaceが生成されます。

要は、<プロジェクト名>.xcworkspace ってことですね。

これを開くと、いつも通りにプロジェクトが開けて編集できます。

ここで重要なのは、

今後は生成されたxcworkspaceを開いて編集していかなければならないということです。

xcodeprojファイルから開くとライブラリは利用できないのでお気をつけて…


それではxcworkspaceを開きましょう!


Xcode上での下準備

このように、適当にディレクトリを展開していくと、

Podsが、SwiftyJSONが導入されていますね。成功です。

スクリーンショット 2016-02-07 00.58.41.png

ここで早速、swiftファイルに import … とやりたくなりますが、

一旦抑えて Command + B でビルドしましょう。

さもなければ…

スクリーンショット 2016-02-07 01.03.39.png

このように、怒られてしまいます。

(ビルドが必須なのを知らず、これでかなりの時間を浪費しました…)

気持よくビルドした後は余裕のコード補完。

スクリーンショット 2016-02-07 01.09.58.png

…胸がすく思いですね。

以上でCocoaPodsの導入、利用については終わり!

お疲れ様でした!


参考サイト様

iOSライブラリ管理ツール「CocoaPods」の使用方法

pod installが永遠に終わらない | 秋山ブログ