fastlane for iOS – cert
- PDF for offline use
Let us know how you feel about this
last updated: 2017-01
fastlane recommends using the
matchtool for generating and maintaining certificates. Use
certdirectly only if you want full control and know enough about code signing. Use this action to download the latest code signing identity.
Traditionally, device provisioning is performed by each member of a development team via Xcode or on the Apple Developer Portal. It consists of several steps:
- Requesting a development certificate
- Adding a device to the portal
- Creating an App ID
- Creating a provisioning profile
- Downloading profiles and certificates
Each of these steps contains variables that need to be addressed, which depend on the type of application you are developing. More information on the steps required to set up a device for development either manually or via Xcode can be found in the Device Povisioning guide.
This guide introduces fastlane tools as an alternative to using Xcode, and explains the following:
For information on installing and updating fastlane, refer to the Introduction to fastlane guide.
What is cert?
cert provides a terminal interface that creates new code signing identities (often known as a developer certificate) for both development and distribution environments.
To use the cert utility, enter the following command into the terminal CLI:
By default, this will create a distribution certificate. To create a development certificate, pass the
fastlane cert --development
cert will prompt for your Apple ID and password, so enter this now:
The first time your password is entered it is saved to the local macOS Keychain. Alternatively, Environment Variables can be used to store the username and password, or you can use
export fastlane_DONT_STORE_PASSWORD=1if you do not wish to have your password stored in the keychain. For more information on managing credentials with fastlane, refer to fastlane's credentials manager guide.
The Apple ID can also be passed as an argument by using the following command:
fastlane cert -u email@example.com
If your Apple ID is connected to multiple teams, they will be displayed here. Select the number that corresponds to the team that you wish to use:
The Team ID can also be passed by using the following flag:
fastlane cert -l 2TU993NY9J
fastlane will check if any of the available signing certificates is installed on your local machine, and if there is it will use it.
If there is no signing certificate, cert will:
- Create a new private key and signing request
- Generate, download, and install the certificate
- Import the certificate and private key into the keychain
When the max number of signing identities allowed for your account has been reached, an exception will be raised. If you wish to create a new signing identity, you must manually revoke one of the existing certificates via the Developer Center and try again.
fastlane cannot download existing signing identities from the Developer Center if they are not already in your keychain. This is because the private key only ever exists on your computer, or in exported(*.p12) version of the certificate, and never in the developer center.
The following options can be used to give additional support when using cert:
-–helpflag for a list of all available commands:
fastlane cert --help
-–verboseflag to increase the verbosity of the output
fastlane cert --development --verbose