cocoaPodsを使って、SnapKitをプロジェクトに導入する

import SnapKit
と書いて

No such module 'SnapKit'
と怒られてしまった人のためのメモです


2017年9月26日時点で成功した方法を記述しています。

■cocoapods とは

ライブラリを管理するためのライブラリです。


cocoapods 導入した時に生成される Podfile の中身を
編集して、 pod install のコマンドを打つだけで
設定したライブラリを自動的に導入してくれます。


2017年10月時点では、iOSアプリ開発では
一般的に使われているツールのようです。

■cocoapodsのインストール

以下を実行して、Rubyを最新にします
$ sudo gem update --system
RubyGems system software updated


以下を実行して、インストールをします
$ sudo gem install -n /usr/local/bin cocoapods


$ pod setup
CocoaPods 1.4.0.beta.1 is available.
To update use: `sudo gem install cocoapods --pre`
[!] This is a test version we'd love you to try.

For more information, see https://blog.cocoapods.org and the CHANGELOG for this version at https://github.com/CocoaPods/CocoaPods/releases/tag/1.4.0.beta.1

Setup completed




■Podfileの作成
プロジェクトフォルダに移動し、以下を実行します
$pod init

この操作で　Podfile　は自動的に生成されます




■Podfileを編集
アプリ名/Podfileを以下のように編集します

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

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

  # ここにimportで使うライブラリを記述します
  pod 'SnapKit', '>=3.2.0'

  # Pods for Omikuji

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

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

end
```


※　このファイルを編集する際は（このファイルに限りませんが）、
mac OS標準のテキストエディットを使わないようにしてください。

スマート引用符の自動置換により、無効な文字が混入される可能性が高くなります。
混入された場合は、大体以下のようなエラーメッセージが出ます

[!] Smart quotes were detected and ignored in your Podfile. To avoid issues in the future, you should not use TextEdit for editing it. If you are not using TextEdit, you should turn off smart quotes in your editor of choice.

※　cocoapodのバージョン管理
ライブラリのバージョンの指定方法は、以下を参考にしてみてください
https://hacknote.jp/archives/15217/

SnapKitの最新バージョン
https://github.com/SnapKit/SnapKit/releases




■ライブラリのインストール
以下をプロジェクトフォルダ内で実行します

$ pod install
Analyzing dependencies
Downloading dependencies
Installing SnapKit (3.2.0)
Generating Pods project
Integrating client project

[!] Please close any current Xcode sessions and use `Omikuji.xcworkspace` for this project from now on.
Sending stats
Pod installation complete! There is 1 dependency from the Podfile and 1 total pod installed.

[!] Automatically assigning platform ios with version 10.3 on target Omikuji because no platform was specified. Please specify a platform for this target in your Podfile. See `https://guides.cocoapods.org/syntax/podfile.html#platform`.

※　エラーパターン

下記が出た場合は、記述内容に誤りがある可能性があるので、もう一度内容を確認してみてください。
改行コードも問題になる場合があるそうなので、改行を削除して新たに入力し直して実行もしてみてください
[!] Invalid `Podfile` file: syntax error, unexpected tCONSTANT, expecting end-of-input.


下記が出た場合はメソッド名のミスですので Pod　→　pod　と修正するといいです
[!] Invalid `Podfile` file: undefined method `Pod' for #.

# from /Users/Shared/sko-fsf/X-Project/TransView/Podfile:8
# -------------------------------------------
#
> Pod 'SnapKit','>=3.2.0'
#
# -------------------------------------------

■xcworkspaceを開く
一度Xcodeを閉じて、プロジェクトフォルダ内に作成された
『アプリ名.xcworkspace』でプロジェクトを開きます

ターミナルでは、プロジェクトフォルダまで移動し、以下を実行することで開けます

$ open /Applications/Xcode.app/ アプリ名.xcworkspace


pod installを実行すると
『アプリ名.xcworkspace』ができるので
今までアプリを開発する際は
『アプリ名.xcodeproj』
を開いていましたが、
『アプリ名.xcworkspace』
を開くようにします




■ビルド
プロジェクトを開いたら、cmd + B　でビルドを実行しましょう
import SnapKit　部分のエラーが消えることが確認できます

参考

cocoapodsのインストール方法
https://qiita.com/satoken0417/items/479bcdf91cff2634ffb1

cocoapodsの削除方法
https://qiita.com/ka0ru19/items/fe2611de71bb363c9537

全体の流れ
http://programming-beginner-memo.com/?p=101

podfile内のライブラリの追加の仕方
http://programming-beginner-memo.com/?p=606

ビルドを忘れずに
https://qiita.com/fksk/items/9e5fdc201af4f03f2dec

cocoaPodsを使って、SnapKitをプロジェクトに導入する
http://shigemon.jp/%E6%9C%AA%E5%88%86%E9%A1%9E/cocoapods-snapkit/