Run CocoaPods install
This Step uses CocoaPods' pod install or pod update command to install your dependencies.
Description
CocoaPods is a dependency manager for Swift and Objective-C projects. This Step uses CocoaPods' pod install or pod update command to install your dependencies on the virtual machine where your Bitrise build runs.
CocoaPods version is determined based on the Podfile.lock file or on the Gemfile.lock file. If your Gemfile.lock file contains the cocoapods gem, then the Step will call the pod install command with bundle exec. Otherwise, the Cocoapods version in the Podfile.lock will be installed as a global gem.
If no Cocoapods version is defined in Podfile.lock or Gemfile.lock, the preinstalled sytem Cocoapods version will be used.
Configuring the Step
-
Set the Source Code Directory path to the path of your app's source code.
-
Optionally, provide a Podfile in the Podfile path input.
Without a specific Podfile, the Step does a recursive search for the Podfile in the root of your app's directory, and uses the first Podfile it finds.
Troubleshooting
If the Step fails, check out the Podfile and the Gemfile of your app. Make sure there is no compatibility issue with the different versions of your Pods.
Check that both Podfile.lock and Gemfile.lock is committed and the Cocoapods versions defined in both match.
You can set the Execute cocoapods in verbose mode? input to true to get detailed logs of the Step.
Useful links
Related Steps
🧩 Get started
Add this step directly to your workflow in the Bitrise Workflow Editor.
You can also run this step directly with Bitrise CLI.
⚙️ Configuration
Inputs
| Key | Description | Flags | Default |
|---|---|---|---|
command |
CocoaPods command to use for installing dependencies. Available options: - install: Use pod install to download the explicit version listed in the Podfile.lock without trying to check if a newer version is available. - update: Use pod update to update every Pod listed in your Podfile to the latest version possible. |
required | install |
source_root_path |
Directory path where the project's Podfile (and optionally Gemfile) is placed. CocoaPods commands will be executed in this directory. | required | $BITRISE_SOURCE_DIR |
podfile_path |
Path of the project's Podfile. By specifying this input Workdir gets overriden by the provided file's directory path. |
||
verbose |
Execute all CocoaPods commands in verbose mode. If enabled the --verbose flag will be appended to all CocoaPods commands. |
false |
|
is_cache_disabled |
Disables automatic cache content collection. By default the Step adds the Pods directory in the Workdir to the Bitrise Build Cache. Set this input to disable automatic cache item collection for this Step. |
false |
Outputs
There are no outputs defined in this step🙋 Contributing
We welcome pull requests and issues against this repository.
For pull requests, work on your changes in a forked repository and use the Bitrise CLI to run step tests locally.
Learn more about developing steps: