GitHub action for Permasigner, useful for CI/CD.

---

Why is this useful?

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.

How do I use it?

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/[email protected]
  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.

Can I contribute?

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

Credits

• Beerpsi for the Install Procursus action as the reference for this action
• Keto for bringing up that Procursus isn't really necessary, and removing it in favor of Set up Python decreases build times

License

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