GitHub action for Permasigner, useful for CI/CD.

If you're an iOS developer, and your app has a jailbroken and jailed version, you may want to create a permasigned version of the jailbroken one with necessary entitlements to run correctly jailed (as if the device was in a jailbroken state).

For example, Santander has an IPA along as a permasigned deb. The IPA will work both jailed and jailbroken, but will be limited to a sandboxed directory when not in a jailbroken state. The deb on the other hand, will work the same jaied and jailbroken, and will not be constrained to a sandboxed directory when jailed.

First of all, make sure you're using a Linux or macOS runner, Windows will not work! Then, you'll want to add it to your CI/CD workflow like this:

- name: Run Permasigner
  uses: permasigner/action@v1
  with:
    # Specify your IPA as an input
    input: "${GITHUB_WORKSPACE}/MyApp.ipa"

    # Optional: Run the latest version of Permasigner instead of the PyPi package
    # source: true

    # Optional: Set the output directory (default is ${GITHUB_WORKSPACE}/permasigner-out)
    # output: "${GITHUB_WORKSPACE}/a-cooler-output"

    # Optional: Specify your custom entitlements
    # entitlements: "${GITHUB_WORKSPACE}/entitlements.plist"

    # Optional: Pass more args to Permasigner
    # args: "--ldidfork ProcursusTeam --author Nebula --name 'My Cool App'"

An example workflow is here, we use it to test the action and make sure it works correctly for users.

Of course, make a fork, make your changes, and make a pull request as usual!

• Beerpsi for the Install Procursus action

The Permasigner action is licensed under the BSD-3-Clause license, and can be found here.