resign

Codesign an existing ipa file

resign
Supported platforms ios
Author @lmirosevic

2 Examples

resign(
  ipa: "path/to/ipa", # can omit if using the `ipa` action
  signing_identity: "iPhone Distribution: Luka Mirosevic (0123456789)",
  provisioning_profile: "path/to/profile", # can omit if using the _sigh_ action
)
# You may provide multiple provisioning profiles if the application contains nested
# applications or app extensions, which need their own provisioning profile.
# You can do so by passing an array of provisioning profile strings or a hash
# that associates provisioning profile values to bundle identifier keys.
resign(
  ipa: "path/to/ipa", # can omit if using the `ipa` action
  signing_identity: "iPhone Distribution: Luka Mirosevic (0123456789)",
  provisioning_profile: {
    "com.example.awesome-app" => "path/to/profile",
    "com.example.awesome-app.app-extension" => "path/to/app-extension/profile"
  }
)

Parameters

Key Description Default
ipa Path to the ipa file to resign. Optional if you use the gym or xcodebuild action *
signing_identity Code signing identity to use. e.g. iPhone Distribution: Luka Mirosevic (0123456789)
entitlements Path to the entitlement file to use, e.g. myApp/MyApp.entitlements
provisioning_profile Path to your provisioning_profile. Optional if you use sigh *
version Version number to force resigned ipa to use. Updates both CFBundleShortVersionString and CFBundleVersion values in Info.plist. Applies for main app and all nested apps or extensions
display_name Display name to force resigned ipa to use
short_version Short version string to force resigned ipa to use (CFBundleShortVersionString)
bundle_version Bundle version to force resigned ipa to use (CFBundleVersion)
bundle_id Set new bundle ID during resign (CFBundleIdentifier)
use_app_entitlements Extract app bundle codesigning entitlements and combine with entitlements from new provisioning profile
keychain_path Provide a path to a keychain file that should be used by /usr/bin/codesign

* = default value is dependent on the user's system


Documentation

To show the documentation in your terminal, run

fastlane action resign

CLI

It is recommended to add the above action into your Fastfile, however sometimes you might want to run one-offs. To do so, you can run the following command from your terminal

fastlane run resign

To pass parameters, make use of the : symbol, for example

fastlane run resign parameter1:"value1" parameter2:"value2"

It's important to note that the CLI supports primitive types like integers, floats, booleans, and strings. Arrays can be passed as a comma delimited string (e.g. param:"1,2,3"). Hashes are not currently supported.

It is recommended to add all fastlane actions you use to your Fastfile.


Source code

This action, just like the rest of fastlane, is fully open source, view the source code on GitHub


Back to actions