Troubleshooting

If you need to request support, you can run make troubleshoot-jailed PROFILE=<your profile>, to upload the output of make clean package messages=yes to Ghostbin and copy the link to your clipboard.

Before creating an issue, see if any of the solutions listed below fixes your problem.

General

• make is whitespace sensitive, so don't leave any space after a variable's value, and don't have any spaces in your directory/file names

Issue with Theos

Diagnosis

You get an error which occurs even if you don't run package or install (i.e. even if you run make by itself).

Solution

• Create an issue in the theos/theos repo. Please read Troubleshooting on the Theos wiki before doing so

Codesigning

Diagnosis

You get an error message containing the word "codesign", "sign", "entitlements", or "profile".

Solutions

• Make sure that you are setting the PROFILE variable correctly, as described in make info
• Unless you are using a wildcard profile, make sure that BUNDLE_ID matches the one used in PROFILE
• Set DEV_CERT_NAME to your certificate's name if you need to use a particular certificate, although this isn't required anymore because the certificate is extracted from the profile
• Set CODESIGN_IPA=0 to disable codesigning completely. If this solves the problem, you can use Cydia Impactor to install your app, or iOS App Signer along with Xcode to do the same. If either of the two apps works, it is still recommended that you create an issue so that the problem within Theos Jailed can be resolved

Note: If you use Cydia Impactor to install the app, you must disable CydiaSubstrate by setting <tweak name>_USE_SUBSTRATE=0. This seems to be a bug with Impactor itself.

Make requires ios-deploy

Diagnosis

You get an error saying "/Applications/Xcode.app/Contents/Developer/usr/bin/make requires ios-deploy"

Solutions

• Install ios-deploy
• Add ios-deploy to your PATH