Before we begin…

If you are using Xcode 7 or above, you do not need this tutorial. Just use Xcode with your iOS device normally.


  1. A jailbroken iOS device with AppSync Unified installed.
  2. A computer running OS X
  3. Xcode 6 or below
  4. My patch-ios-sdk tool
  5. Your Apple ID must be registered as an Apple Developer — to check, log in to the Member Center. If your Apple ID is not an Apple Developer, it will prompt you to agree to the EULA and create your Apple Developer account.

Let's start.

  1. Open a Terminal instance, and run "patch-ios-sdk". You make need to make it executable first with chmod +x patch-ios-sdk.
  2. Open Xcode and let it do its initial setup, then quit Xcode.
  3. Open Keychain Access, click on the Keychain Access item in the menubar, go to Certificate Assistant, then "Create New Certificate"
  4. Enter your name in if OS X didn't already fill it in, then change Certificate Type to "Code Signing" and check "Let me override defaults"
  5. For the serial number, just bash your head into your keyboard a bit. Or just leave it at 1, it doesn't really matter.
  6. Change the validity period to something longer than one year (or if you really want, you can just leave it at 365 days).
  7. Then just click Continue for the rest of the steps until you have a shiny new certificate.
  8. Quit Keychain Access, and open Xcode.
  9. Either create a new Xcode Project, or open an already-existing one.
  10. Download asu_pid.entitlements and add it to your Xcode project.
  11. On the Xcode sidebar, click on the project, and go to "Build Settings."
  12. Scroll down to "Code Signing," and change all the options under "Code Signing Identity" to "Ad Hoc Code Sign."
  13. Then change "Code Signing Entitlements" to "YOUR_PROJECT_NAME_HERE/asu_pid.entitlements" (no quotes) — assuming that you placed asu_pid.entitlements inside your project folder.
  14. Repeat changing the build settings in the Test target, or just delete the Test target if you aren't using it.
  15. Select your iOS device from the dropdown in the Xcode toolbar, and run your app.
  16. Have fun developing!