はじめに

本記事では、ライブラリ管理ツールであるCarthageをMacにインストールし、SVProgressHUDをプロジェクトにインポートして、HUDを表示するところまでをやっていきます。

環境

macOS 10.12.1 (Sierra)
Xcode 8.1
Homebrew 1.1.1
Carthage 0.18.1

Homebrewのインストール

Homebrewの公式ページの最初に書いているコマンドをターミナルにコピペします。

該当のコマンドがこちら

/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

fishshellなどをお使いで、そのまま使えない方は、bashとターミナルで打って、bashにしてから使用してください。

これでHomebrew(以下、brew)のインストールは完了です。

Carthageのインストール

続いて、brewを使用して、Carthageをインストールします。
CarthageのREADMEに従って、以下のコマンドをターミナルで打ちます。

brew install carthage

ここまでなら、Cocoapodsよりも簡単です。（同じくらい簡単かも）
これだけで、carthageのインストールも完了です。

ライブラリの導入

では、これからCarthageを使って、ライブラリを導入します。
手順として、以下の4つのステップを踏みます。

Cartfileを生成
Cartfileの編集
Cartfileに記述したライブラリのインストール
Xcodeのプロジェクトにビルドしたライブラリの導入

Cartfileを生成する前に、該当のプロジェクトのフォルダまでディレクトリ移動しましょう。

1. Cartfileの生成

移動したところで、touchを使ってCartfileを生成します。

touch Cartfile

これで、まっさらなCartfileがつくられたので、Cartfileを編集していきます。

2. Cartfileの編集

SVProgressHUDのREADMEに記述されているように、Cartfileに以下のように記述します。

Cartfile

github "SVProgressHUD/SVProgressHUD"

Carthageは公開されているライブラリしか使えないため、github "ライブラリのOwner/repository"のように記述します。
大体READMEに記述してくれていますので、それに従いましょう。

続いて、編集してCartfileに従って、ライブラリを落とします。

3. Cartfileに記述したライブラリのインストール

Cartfileに従って、ライブラリをインストールする方法は以下のコマンドを打つだけです。

carthage update

OSなどを指定したい場合は、--platformでiosなどを指定してください。

carthage update --platform ios

これで、githubからクローンしてきたプロジェクトから、〇〇.frameworkを生成してくれます。
クローンしてきたプロジェクトはプロジェクトフォルダのCarthage/Checkoutsに、生成したバイナリはCarthage/Buildにそれぞれ入れてくれます。

Checkoutsしたもののうまくバイナリにできなかった場合などは、以下のコマンドを打ってあげると、Checkoutsからバイナリを生成し直してくれます。

carthage build

Checkoutsされたライブラリは、Cartfile.resolvedに記述されますので、Cartfile.resolvedに記述されているライブラリは個別にupdateやbuildをかけることができます。

例えば、以下のようにすることができます。

carthage update SVProgressHUD

4. Xcodeのプロジェクトにビルドしたライブラリの導入

作成したバイナリをXcodeプロジェクトに追加していきます。
まず
プロジェクトファイル > General > Linked Frameworks and Libraries
のプラスボタンから、Carthage/Buildに入っているframeworkを追加します。

Add Other...を選択

その後、FinderからCarthage > Build > 該当のライブラリ.frameworkを追加します。

そうすると以下のようになります。

続いて
プロジェクトファイル > Build Phases
の左上のプラスボタンからNew Run Script Phaseを選択し、新しいRun Scriptを作成します。

そうすると、以下のように新しいRun Scriptがつくられます。

そして、Run Scriptの黒い部分に以下のスクリプトを追記します。

script

/usr/local/bin/carthage copy-frameworks

その後、該当のライブラリをInput Filesにプラスボタンから追加していきます。
プラスボタンを押すと、$(SRCROOT)/myfilesとなっているので、myfilesにCarthage/Build/iOS/SVProgressHUD.frameworkのように該当のライブラリのディレクトリを指定します。

$(SRCROOT)/Carthage/Build/該当のOS/該当のライブラリ.frameworkはライブラリごとに追加していかなれけばなりません。

今回の場合は以下のようになります。

以上でライブラリの導入は完了です。
あとは、Swiftファイルにimportとコードを書いていけばOKです。

コード

SVProgressHUDを導入する今回はViewController.swiftを以下のように編集します。

ViewController.swift

import UIKit
import SVProgressHUD // 追記

class ViewController: UIViewController {

    override func viewDidLoad() {
        super.viewDidLoad()
        // Do any additional setup after loading the view, typically from a nib.
        SVProgressHUD.show() // 追記
    }

    override func didReceiveMemoryWarning() {
        super.didReceiveMemoryWarning()
        // Dispose of any resources that can be recreated.
    }


}

サンプルプロジェクト

以下のURLにサンプルプロジェクトを上げていますので、参考にしていただければと思います。

参考URL

ブランチやバージョンの管理の仕方
ライブラリ管理ツールCarthageのCartfileの書き方

Carthageのコマンドや、そもそもCarthageって？的なスライド
Carthageについて知りたいn個のこと

その他

わかりにくい点などございましたら、編集リクエストをお願いします。
また間違っている点がございましたら、コメントをいただけると幸いです。

【Swift】Carthage導入手順