CocoaPods インストール方法 - shirajira/family-account-ios GitHub Wiki

CocoaPods インストール方法

CocoaPods とは

公式:
https://cocoapods.org/

Objective-C や Swift におけるライブラリ管理サービスおよびツールのこと。
アプリ開発に必要なライブラリをかんたんに導入することができる。

また,自分で開発したライブラリを公開することもできる。

関連:
CocoaPods 自作ライブラリを公開する

操作手順

1. 導入

公式ドキュメント:
CocoaPods Guides - Getting Started

ターミナルを起動し,以下コマンドを実行する。

$ sudo gem install cocoapods

プロキシが邪魔してインストールできない場合は -p オプションで回避してください。

2. 初期化

公式ドキュメント:
CocoaPods Guides - Using CocoaPods

プロジェクトのルートに移動し,以下コマンドを順次実行していく。

$ cd your_project/
$ pod setup
$ pod init

プロジェクトのルートに Podfile というテキストファイルが生成されていると思われる。
開発中に何かライブラリを導入したくなった場合,このファイルにライブラリ名を記載していくことになる。

どうにかして Podfile を開く。

$ vim Podfile

その後,導入したいライブラリを書き足していけばよい。
以下は NovelStudioLint を導入した例。

target 'project_name' do
  # Comment the next line if you don't want to use dynamic frameworks
  use_frameworks!

  # Pods for project_name
  pod 'NovelStudioLint'

  ...

追加したら,保存(Vim の場合 :wq)して以下コマンドでインストールする。

$ pod install

以降,新しい Pod を追加するたびに pod install すればOK。

関連:
NovelStudioLint - GitHub

3. プロジェクトの立ち上げ方

以降,Xcode で当該プロジェクトを立ち上げるときは your_project.xcodeproj ではなく your_project.xcworkspace を開いてください。

トラブルシューティング

ビルドできない

プロジェクトを Git 管理していて,他の開発者が新しい Pod を追加した場合,自分の環境と整合性がとれなくなってビルドできなくなる。
再度 pod install するよう促されるので,従いましょう。


参考:
CocoaPods.org
CocoaPods Guides - Getting Started
CocoaPods Guides - Using CocoaPods