The open source codesigndoc tool runs a clean Xcode/Xamarin Studio Archive on your Mac, and analyzes the generated archive file. It collects the code signing settings that Xcode or Xamarin Studio used during the archive process, and prints the list of the required code signing files. You can also search for, export and upload these files using
If your project contains UITest targets, codesigndoc can scan for that, too. It runs the
xcodebuild build-for-testing action to create a test-Runner.app, and exports the necessary code signing files.
Collecting the files with codesigndoc ⚓
You can use codesigndoc for:
- Xamarin projects.
- Xcode projects.
- Open the
- Go to your project’s folder.
- Enter the appropriate one-liner command, depending on your project type.
For an Xcode project:
bash -l -c "$(curl -sfL https://raw.githubusercontent.com/bitrise-tools/codesigndoc/master/_scripts/install_wrap-xcode.sh)"
For a Xamarin project:
bash -l -c "$(curl -sfL https://raw.githubusercontent.com/bitrise-tools/codesigndoc/master/_scripts/install_wrap-xamarin.sh)"
The tool will automatically scan your project and look for a
.xcworkspacefile and do the rest.
If the scanner does not find the files, open your
Finder.appand drag-and-drop your project’s
.xcworkspacefile into the command line in your Terminal.
Uploading the files to Bitrise with codesigndoc ⚓
Once the code signing files are collected,
codesigndocwill ask if you wish to upload the files to Bitrise:
Do you want to upload the provisioning profiles and certificates to Bitrise? [yes/no] :
If you wish to upload the files with
Provide your Bitrise access token.
Please copy your personal access token to Bitrise. (To acquire a Personal Access Token for your user, sign in with that user on bitrise.io, go to your Account Settings page, and select the Security tab on the left side.) :
Select the Bitrise project as a target for the collected files:
Fetching your application list from Bitrise... Select the app which you want to upload the provisioning profiles Please select from the list:
That’s all, you are done!
If you wish to use automatic provisioning with our
iOS Auto Provisioning step, you only need to collect the certificate file(s). You can run
codesigndoc scan with the
--certs-only flag to do that.
You can also install and run
codesigndoc manually. For more information, check out the tool’s Readme!
Scanning for UITest targets ⚓
If your Xcode project has UITest targets, you can use codesigndoc to export the necessary code signing files and generate an
.xctestrun file. You need to do this if you want to run UI tests on real devices with the help of Bitrise - for example, with the `iOS Device Testing` Step.
To take advantage of codesigndoc’s UI test scanner, you need a scheme that has a valid UITest target that is enabled.
If your project is set up correctly on your machine, you can start scanning!
- Open the
Use our one-liner to launch the scanner and export the required code signing files:
bash -l -c "$(curl -sfL https://raw.githubusercontent.com/bitrise-tools/codesigndoc/master/_scripts/install_wrap-xcode-uitests.sh)"
This command runs the
xcodebuild build-for-testingaction to create a UITest runner .app file, and exports the necessary code signing files.
- Upload your files to Bitrise with codesigndoc.
Troubleshooting the UITest scanner ⚓
If the UITest scanner cannot find the desired scheme, follow these steps:
Make sure your scheme is valid for running a UITest.
It has to contain a UITest target that is enabled to run.
- Refresh your project settings:
- Select the
Generic iOS Devicetarget for your scheme in Xcode.
- Clean your project:
⌘ Cmd + ↑ Shift + K.
- Run a build for testing:
⌘ Cmd + ↑ Shift + U.
- Select the
Best practices ⚓
You get the most accurate result if you run
codesigndoc on the same state of your repository/code which is available after a clean
git clone, as that will be the state of the code after the build server checks it out (for example, you might have files on your Mac which are in
.gitignore, so it exists on your Mac but not in the repository or after a
git clone on a new Mac).
So, for the best results, we recommend you to:
- Do a clean
git cloneof the repository (into a new directory) on your Mac.
codesigndocin this directory (not in the directory where you usually work on the project).
It’s also advised to do a full Archive + Export (until you get a signed
.ipa) of your project from
Xcode.app first, and run
codesigndoc after that. The reason is that
Xcode.app might download or update profiles in the background during the IPA export. If you run
codesigndoc after you exported an
.ipa from Xcode,
codesigndoc will able to collect all the files.