10.2 CocoaPods

CocoaPodsはOSX, iOSの両方で使うことのできる、ライブラリマネージャです。 RubyのGem, node.jsのnpmと同等の物と考えていただいて差し支えないと思います。 このページでは、このCocoaPodsを用いたライブラリ管理の方法と、いくつか有名なライブラリを紹介します。

CocoaPodsの公式サイトは下記になります。詳細はこちらをご覧ください。

http://cocoapods.org/

CocoaPodsの導入と利用

インストール

• RubyのGemを用いてインストールします。
• RubyはおそらくCommandLineToolsを入れた時に入っていると思います
• Gemもおそらく10.8以降なら入っていると思います

コマンドラインツールで以下を実行します

[sudo] gem install cocoapods
pod setup

しばらく時間がかかると思います。

Podfileの記述

利用するライブラリやそのバージョンの指定、ターゲットごとのライブラリの振り分けなどはPodfileというファイルに記述します。

# Podfile

platform :ios, '5.0'

target 'mixi' do
  pod 'AFNetworking', '~> 0.8.0'
end

• platformは対応するプラットフォームを書きます、iosとosxが選択でき、OSのバージョンを指定する場合はコンマに続けてバージョンを書きます
• targetには適用するターゲットを指定します。ビルドするターゲットごとに使用するライブラリを変えたい場合は書きます。全てのターゲットで利用する場合は必要ありません
• 利用するライブラリを指定するには

pod 'ライブラリ名', バージョンや他のpodを指定

と書きます。

• バージョンの表記はRubyGemsのバージョン表記に準拠します。
  • http://docs.rubygems.org/read/chapter/7
• ローカルにあるライブラリを指定したい場合は

pod 'MyLibrary', :local => 'path/to/libary'

のように書きます

• gitで管理されているライブラリを利用する場合

pod 'AFNetworking', :git => 'https://github.com/gowalla/AFNetworking.git'

のように指定します。

• podspecが記述されている場合

pod 'AFNetworking', :podspec => 'https://raw.github.com/AFNetworking/AFNetworking/master/AFNetworking.podspec'

と書くことが出来ます。

インストール

ライブラリのインストールには

pod install

とします。プロジェクト配下にPodsというディレクトリができてその中にライブラリがインストールされます。

インストール後のプロジェクトファイルは hogehoge.xcodeproj から hogehoge.xcworkspace に変更になります。xcodeporjを使うとライブラリを参照できません

あとはソースコード内で

#import <AFNetworking.h>

とすれば利用できるようになります。

CocoaPodsのライブラリの紹介

• Reachability
• nimbuskit
• BlocksKit
• SDWebImage
• テストフレームワークなど
• AFNetworking