猿でも解るCocoaPodsの使い方！movajeでインストールできない場合の原因や対処方法も！

2016年9月9日 2019年8月24日 13分21秒

Guttyo

CocoaPodsとは、SwiftとObjective-CによるCocoaプロジェクトで使用可能な、自分の作ろうとしているアプリケーションで、外部ライブラリ(Pod)を利用する際に必要な依存性の解決を自動的に行ってくれるソフトウェアです。

わかりやすい例で例えると、ある料理を作ろうとしているときに、プロの料理人が料理器具の準備から食材の下ごしらえまでを全部やってくれる、といった感じでしょうか。あくまでもメインで料理を行うのはあなた自身です。CocoaPodsを使ったからと言って簡単にアプリが完成するわけではありませんが、アプリの基盤を整える時短には良い方法だと考えています。

iOSやOSXアプリケーション向けであるため、WindowsやLinuxでは使用できません。

CocoaPodsをお手持ちのmacにインストールすることから始めましょう。手順を示します。https://cocoapods.org本家サイトには最新の情報がありますので、必ず確認をしてください。

CocoaPodsのインストール

ターミナルからCocoaPodsをインストール(エラー回避も)

ターミナルを起動しましょう。「アプリケーション＞ユーティリティ＞ターミナル」にあります。ターミナルとは、1行毎に命令を打っていくコマンドラインツールを使用するための端末(ターミナル)プログラムです。

Windowsで言うところのコマンドプロンプト(cmd.exe)に当たります。CocoaPodsを使用する際には必ずターミナルを使うことになると思いますので、このようにDockへ追加しておくと起動が楽ですよ。

Dockへ追加するためには、アプリのアイコンを「control + クリック」（右クリックもしくは副ボタンのクリックとも呼ぶ）し、「オプション」＞「Dockへ追加」にて追加することが出来ます。

このターミナルで下記のコマンドを打ちます。※$の後から打ちます。

$ sudo gem install cocoapods -n /usr/local/bin

コマンドの最後にはenterキーを押してください。

※追記　macOS High sierra以降では「-n /usr/local/bin」の追加が必要になります。

追加していない場合、エラーになりますので注意してくださいね！

gem install -nの-nオプションはバイナリファイルを置く場所を指定するということ。

High sierra以降のバージョンでCocoapodsがインストールできなかったのを解消

そしてパスワードを聞かれますので、現在のログインパスワードを入力しenterキーを押すと暫くしてインストールが完了します。(管理者権限を持っているアカウントでログインしている必要があります)

以上にてCocoaPodsをお使いのMacにインストールできました。次はXcodeで使うための設定ファイルであるPodfileの準備をしましょう。

Podfileの準備

CocoaPodsはPodfileと呼ばれるテキストファイルに入れたいPodの情報を記載することで使うことが出来ます。まずはPodfileを用意しましょう。ファイル名は「Podfile」です。拡張子は不要です。ファイルの配置場所はXcodeプロジェクトファイルのルートフォルダ(hogehoge.xcodeprojファイルがある場所)です。

Podfileの中身

Podfileの中身はこのようなテキストファイルになっています。

platform :ios, '8.0'
use_frameworks!

target 'MyApp' do
  pod 'AFNetworking', '~> 2.6'
  pod 'ORStackView', '~> 3.0'
  pod 'SwiftyJSON', '~> 2.3'
end

Xcodeで新規emptyファイルから作成し、0から全て手で記述してもよいのですが、より簡便で確実な方法を取りましょう。

Pod initコマンドで自動的にPodfileを生成する

ターミナルでXcodeプロジェクトのあるフォルダに移動します。ターミナルに「cd」と打ち込んだあと、1つだけスペースをいれ、目的のフォルダをドラッグアンドドロップする事でパスが入力されます。ちなみにcdとはchange directoryの略で、コマンドラインでディレクトリ(フォルダ)を移動する際に使うコマンドです。「cd 目的ディレクトリ」というように使用します。

ドラッグアンドドロップでそのフォルダ(ディレクトリ)までのパスが自動的に入力されます。

ここでenterを押すとそのフォルダに移動します。

$ ls

とタイプしenterを押すとディレクトリの中身が表示されます。

$ pod init

とタイプすることでXcodeプロジェクトから自動的にPodfileが生成されます。生成されたPodfileの中身はこのようになっています。

# Uncomment this line to define a global platform for your project
# platform :ios, '9.0'

target 'ChozaiCalcLegacy' do
 # Comment this line if you're not using Swift and don't want to use dynamic frameworks
 use_frameworks!

 # Pods for ChozaiCalcLegacy

 target 'ChozaiCalcLegacyTests' do
   inherit! :search_paths
   # Pods for testing
 end

 target 'ChozaiCalcLegacyUITests' do
   inherit! :search_paths
   # Pods for testing
 end

end

このファイルの中にはターゲット毎にPodfileを指定できる状態になっています。この内部の9行目にある# Pods for 〜〜〜の行の直下にインストールしたいPodsを書いていきます。

記載後の部分を抜粋します。

# Pods for ChozaiCalcLegacy

 pod 'AFNetworking', '~> 2.6'
 pod 'ORStackView', '~> 3.0'
 pod 'SwiftyJSON', '~> 2.3'

ここでは3つのPodsをインストールするように設定しています。なお、どのようなPodsが存在するかを調べるには、CocoaPodsの公式サイトを使いましょう。この記事の下部で紹介いたします。

pod installコマンドでPodfileを元にpodをインストール

Podfileを記述した後はインストール作業になります。そのまま続けてコマンドを打ちます。

$ pod install

このコマンドにてXcodeプロジェクトフォルダに対して変更が加えられ、Podがインストールされます。

これでCocoaPodsによるPodのプロジェクトへのインストールが完了しました。各Podの動作に必要なframewrokなどをプロジェクトに追加してくれています。

なお、Podのバージョンが上がった時などにPodをアップデートしたい場合はpod updateと打つことでプロジェクト内部のPodのバージョンアップを行うことが出来ます。ただし、必ずプロジェクトのバックアップを取ってから行うようにしてください。Podのアップデートが原因でバグを起こすことがあります。