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で依存関係をインストールするには、次の手順に従います。
- Workflow Editor
- Configuration YAML
-
CocoaPodsの特定のバージョンが必要な場合は、
Gemfile.lockまたはPodfile.lockファイルのいずれかで必ず定義してください。Stepは、まず
Gemfile.lockファイル内のcocoapodsgemを探します。そこにcocoapodsgemがない場合、StepはPodfile.lockファイルで定義されているCocoaPodsバージョンを使用します。どちらのファイルにもバージョンが定義されていない場合は、プリインストールされているシステムバージョンが使用されます。これはシステムレ ポートで確認できます。 -
アプリをビルドするXcode Stepが
.xcworkspaceファイルを使用するようにしてください。StepのProject path入力には、.xcworkspaceのパスを指定する必要があります。 -
Run CocoaPods Install StepをWorkflowに追加します。
これは、build cacheからプルするStepの後に配置する必要があります。キャッシュStepsがない場合は、Git Clone Repository Stepの直後にStepを追加してください。
-
CocoaPods command入力で、実行したいコマンドを選択します。
install: 各ポッドについて
Podfileで指定されたバージョンをインストールします。update:
Podfileに記載されている各ポッドについてlatest versionをインストールします。
-
必要に応じて、Podfile path入力に
Podfileのパスを指定できます。これは必須ではありません。入力を空のままにした場合、Stepはアプリのルートディレクトリを再帰的に検索し、最初に見つかった
Podfileを使用します。
-
CocoaPodsの特定のバージョンが必要な場合は、
Gemfile.lockまたはPodfile.lockファイルのいずれかで必ず定義してください。Stepは、まず
Gemfile.lockファイル内のcocoapodsgemを探します。そこにcocoapodsgemがない場合、StepはPodfile.lockファイルで定義されているCocoaPodsバージョンを使用します。どちらのファイルにもバージョンが定義されていない場合は、プリインストールされているシステムバージョンが使用されます。これはスタックレポートで確認できます。 -
アプリをビルドするXcode Stepが
.xcworkspaceファイルを使用するようにしてください。Stepのproject_path入力には、.xcworkspaceのパスを指定する必要があります。 -
cocoapods-installStepをWorkflowに追加します。これは、build cacheからプルするStepの後に配置する必要があります。キャッシュStepsがない場合は、
git-cloneStepの直後にStepを追加してください。my-workflow:steps:- activate-ssh-key: {}- git-clone: {}- restore-cocoapods-cache: {}- cocoapods-install:is_always_run: true- save-cocoapods-cache: {} -
command入力で、実行したいコマンドを選択します。install: 各ポッドについて
Podfileで指定されたバージョンをインストールします。update:
Podfileに記載されている各ポッドについてlatest versionをインストールします。my-workflow:steps:- activate-ssh-key: {}- git-clone: {}- restore-cocoapods-cache: {}- cocoapods-install:is_always_run: trueinputs:- command: update- save-cocoapods-cache: {} -
必要に応じて、
podfile_path入力にPodfileのパスを指定できます。my-workflow:steps:- activate-ssh-key: {}- git-clone: {}- restore-cocoapods-cache: {}- cocoapods-install:is_always_run: trueinputs:- command: update- podfile_path: ./path/to/podfile/- save-cocoapods-cache: {}これは必須ではありません。入力を空のままにした場合、Stepはアプリのルートディレクトリを再帰的に検索し、最初に見つかった
Podfileを使用します。
CocoaPodsの依存関係をキャッシュするClick to copy link
キーベースのキャッシュを使用する場合、ポッドをキャッシュするために必要なのはRestore CocoaPods cacheとSave CocoaPods cache Stepsだけです。これらのStepsは、依存関係に必要なcache keysを自動的に設定するため、設定は不要です。
-
Restore CocoaPods cache StepをWorkflowに追加します
これは、Run CocoaPods install Step、またはXcode Archive & Export for iOSのようにアプリをビルドするために依存関係が必要なStepよりも前に配置する必要があります。

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