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 Permasigneruses: permasigner/action@v1.1.0with:
# Specify your IPA as an inputinput: "${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.