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