自作ライブラリのCocoaPods対応


はじめに

CocoaPodsの対応は色々なサイトにやり方が書いてあるので簡単かと思ったら意外とつまずいたのでメモ。

Carthage対応

環境

  • macOS High Sierra 10.13.2
  • Xcode9.2
  • swift4

やり方

これ(AMColorPicker)を例に導入してみます。

  1. 新規プロジェクト作成


    Cocoa Touch Frameworkを選択する。

  2. ライブラリのファイルを追加

    ライブラリのクラファイル、xib、リソースなどを追加する。

  3. 外部アクセスするクラスやプロパティにpublic修飾子をつける

    public class AMColorPickerViewController: UIViewController {
    
    public var selectedColor:UIColor = UIColor.white
    }
    

    何も修飾子をつけない場合、internalになるので外部からアクセスしたいものには全てpublic修飾子をつける必要がある。

  4. コードでリソースを読み込む場合Bundleに注意する

    xibのViewを読み込みたい場合、いつもは何も気にせず下記のように書いていたがこれではダメのよう。

    let view = Bundle.main.loadNibNamed("AMColorPickerRGBSliderView", owner: self, options: nil)?.first as! UIView
    

    上記のようにmainだとライブラリを導入したアプリのバンドルが取得されるのでライブラリ内のxibを読み込めない。下記のようにするとライブラリのバンドルが取得できる。

    let bundle = Bundle(for: AMColorPickerRGBSliderView.self)
    let view = bundle.loadNibNamed("AMColorPickerRGBSliderView", owner: self, options: nil)?.first as! UIView
    

    今回おこなった対応は下記のBundleの対応に記載する。

  5. cocoapodsのインストールする

    コマンドプロンプトで下記のコマンドを実行する。

    sudo gem install cocoapods
    
  6. ライブラリのプロジェクトに移動する

    コマンドプロンプトで下記のコマンドを実行してプロジェクトファイルに移動する。

    cd プロジェクトファイルのパス
    
  7. podspecファイルを作成する

    コマンドプロンプトで下記のコマンドを実行する。

    pod spec create AMColorPicker
    

    AMColorPickerの部分はライブラリ名
    これでプロジェクトファイルにAMColorPicker.podsecができる。

  8. podspecを編集する

    podsecファイルをXcodeなどで開き下記のように編集する。(元のコメントなどは全て削除する。)

    Pod::Spec.new do |s|
    s.name         = "AMColorPicker"
    s.version      = "1.0"
    s.summary      = "AMColorPicker can select color by three ways."
    s.license      = { :type => 'MIT', :file => 'LICENSE' }
    s.homepage     = "https://github.com/adventam10/AMColorPicker"
    s.author       = { "名前" => "メールアドレス" }
    s.source       = { :git => "https://github.com/adventam10/AMColorPicker.git", :tag => "#{s.version}" }
    s.platform     = :ios, "9.0"
    s.requires_arc = true
    s.source_files = 'AMColorPickerViewController/**/*.{swift}'
    s.resources    = 'AMColorPickerViewController/**/*.{xib,png}'
    s.swift_version = "4.0"
    end
    

    s.versionの値はgitのタグ名と合わせる必要がある。

  9. podsecを確認する

    コマンドプロンプトで下記のコマンドを実行する。

    pod lib lint
    

    問題がなければ、下記のように表示される

    AMColorPicker passed validation.
    
  10. gitにpushする

  11. gitにタグをpushする

    1.0とバージョンのタグをつけてpushする。(何もない場合エラーになる)このタグ名はpodsecのバージョンと合わせる必要がある。数字のみでver1.0とかはダメなようです。

  12. cocoapodsにユーザー登録する

    コマンドプロンプトで下記のコマンドを実行する。

    pod trunk register "メールアドレス" "名前"
    

    登録したメールアドレスにメールが届くので、リンクを開いて登録完了。

  13. 登録を確認する

    コマンドプロンプトで下記のコマンドを実行する。

    pod trunk me
    

    登録できていれば、Name:,Email:などが表示される。

  14. cocoapodsにpodspecを登録する

    コマンドプロンプトで下記のコマンドを実行する。

    pod trunk push AMColorPicker.podspec
    

    2019/04/21時点で下記エラーが発生しました。

    [!] The Pod Specification did not pass validation.
    The following validation failed:
    - Warnings: Unrecognized `swift_version` key.
    

    下記コマンドでとりあえずpushできました。

    pod trunk push AMColorPicker.podspec --allow-warnings
    

これでライブラリのcocoapods対応は完了

導入方法

  1. ライブラリを導入するプロジェクトに移動する

    コマンドプロンプトで下記のコマンドを実行してプロジェクトファイルに移動する。

    cd プロジェクトファイルのパス
    
  2. podファイルを作成する

    コマンドプロンプトで下記のコマンドを実行する。

    pod init
    
  3. podファイルを編集する

    podファイルを開いて# Pods for プロジェクト名の下の行に追加するライブラリを記入する。

    # Pods for TestProject
        pod 'AMColorPicker'
    

    バージョンは下記で指定

    pod 'AMColorPicker' // 最新
    pod 'AMColorPicker', '2.0' // 2.0
    pod 'AMColorPicker', '>= 1.0' // 1.0以上の最新 
    pod 'AMColorPicker' '~> 1.0' // 1.0以上2.0未満の最新 
    
  4. ライブラリをインストールする

    コマンドプロンプトで下記のコマンドを実行する。

    pod install
    

以上でライブラリの導入は完了(プロジェクトを開く場合はxcworkspaceを開く)

Bundleの対応

今回のライブラリでおこなったxibなどのリソースが読み込めない問題に対する対応法です。

  • view
let bundle = Bundle(for: AMColorPickerTableView.self)
let view = bundle.loadNibNamed("AMColorPickerTableView", owner: self, options: nil)?.first as! UIView
  • cell
let bundle = Bundle(for: AMColorPickerTableViewCell.self)
let nib = UINib(nibName: "AMColorPickerTableViewCell", bundle: bundle)
tableView.register(nib, forCellReuseIdentifier: "AMColorPickerTableViewCell")
  • image
let bundle = Bundle(for: AMColorPickerSlider.self)
if let imagePath = bundle.path(forResource: "AMCP_slider_thumb@2x", ofType: "png") {

   setThumbImage(UIImage(contentsOfFile: imagePath), for: .normal)
}
  • viewController
required public init(coder aDecoder: NSCoder) {
        super.init(coder: aDecoder)!
}

override init(nibName nibNameOrNil: String!, bundle nibBundleOrNil: Bundle!) {

        let bundle = Bundle(for: AMColorPickerViewController.self)
        super.init(nibName: "AMColorPickerViewController", bundle: bundle)
}

convenience init() {
        self.init(nibName: nil, bundle: nil)
}

ViewControllerはライブラリを導入したプロジェクト内で下記のように呼び出したかったので、上記のようにしたがこんな書き方でいいんだろうか?

ViewController
    let colorPickerViewController = AMColorPickerViewController()
present(colorPickerViewController, animated: true, completion: nil)

導入後の問題

  1. importでエラーになる

    xcodeproj開いている場合xcworkspaceを開く。

    pod init後に一度ビルドする。

  2. IBDesignablesとIBInspectablesが無効になる

    どうやらコンパイルされると、IBDesignableとIBInspectableの情報がなくなるようです。
    External Frameworkの@IBDesignable/@IBInspectableを有効にする方法のように有効にする方法もあるようですが、現状は公式な方法で有効にすることは無理なようです。

    追記(2019/4/21)
    下記環境でライブラリを上げ直して見た所IBDesignablesとIBInspectablesが有効になっていました。
    cocoapods 1.6.1
    Xcode 10.2.1
    ライブラリ https://github.com/adventam10/AMClockView

  3. xibのカスタムクラスの設定でエラーになる

    xibのViewのカスタムクラスにライブラリのクラスを設定すると下記のようなエラーになる。

    Unknown class AMNowClockView in Interface Builder file

    今まであまり気にしたことがなかったが、どうやらModuleもちゃんと設定しなければいけないようです。

さいごに

ライブラリ内で画像やxibを読み込んでいたので、かなりハマった。

CocoaPodsに登録すると、知らない人がgithubにstarつけてくれるので嬉しい。

参考