メインコンテンツまでスキップ

CocoaPodsによる依存関係の管理

CocoaPodsは、SwiftおよびObjective-CのCocoaプロジェクト向けの依存関係管理ツールです。CocoaPodsの依存関係があるiOSアプリには、ポッドを列挙したPodfileが必要です。これらのポッドは、アプリのビルド時にインストールされます。

もちろん、Bitriseのビルド中にCocoaPodsの依存関係を簡単にインストールできます。専用のStepであるRun CocoaPods Installを使用するだけです。このStepは、pod installコマンドとpod updateコマンドの両方を実行できます。

CocoaPodsの依存関係をインストールするClick to copy link​

CocoaPodsで依存関係をインストールするには、次の手順に従います。

  1. CocoaPodsの特定のバージョンが必要な場合は、Gemfile.lockまたはPodfile.lockファイルのいずれかで必ず定義してください。

    Stepは、まずGemfile.lockファイル内のcocoapodsgemを探します。そこにcocoapodsgemがない場合、StepはPodfile.lockファイルで定義されているCocoaPodsバージョンを使用します。どちらのファイルにもバージョンが定義されていない場合は、プリインストールされているシステムバージョンが使用されます。これはシステムレポートで確認できます。

  2. アプリをビルドするXcode Stepが.xcworkspaceファイルを使用するようにしてください。StepのProject path入力には、.xcworkspaceのパスを指定する必要があります。

  3. Run CocoaPods Install StepをWorkflowに追加します。

    これは、build cacheからプルするStepの後に配置する必要があります。キャッシュStepsがない場合は、Git Clone Repository Stepの直後にStepを追加してください。

  4. CocoaPods command入力で、実行したいコマンドを選択します。

    install: 各ポッドについてPodfileで指定されたバージョンをインストールします。

    update: Podfileに記載されている各ポッドについてlatest versionをインストールします。

    pod-install.png

  5. 必要に応じて、Podfile path入力にPodfileのパスを指定できます。

    これは必須ではありません。入力を空のままにした場合、Stepはアプリのルートディレクトリを再帰的に検索し、最初に見つかったPodfileを使用します。

CocoaPodsの依存関係をキャッシュするClick to copy link​

キーベースのキャッシュを使用する場合、ポッドをキャッシュするために必要なのはRestore CocoaPods cacheとSave CocoaPods cache Stepsだけです。これらのStepsは、依存関係に必要なcache keysを自動的に設定するため、設定は不要です。

  1. Restore CocoaPods cache StepをWorkflowに追加します

    これは、Run CocoaPods install Step、またはXcode Archive & Export for iOSのようにアプリをビルドするために依存関係が必要なStepよりも前に配置する必要があります。

    restore-pods.png

  2. Save CocoaPods cache StepをWorkflowの最後に追加します。