Home Guides Interfaces Troubleshooting

Wrapping for the Web

Follow this guide to get started. Once you've completed the entire process once and everything is working, you can then enable the options so the almost all of the process is automated.

  1. Drag the application into the App Wrapper welcome window or select "Open" from the "File" menu and choose the application.
  2. Select the code signing identity from the menu under the code signing heading in the left hand sidebar. If the identity to use is not listed see Manage Certificates on how to install code signing identities.
  3. Select "Website" in the code signing section of the left hand sidebar.
  4. Select "Hardened" in the same section.
  5. Select "Uses Entitlements" in the code signing section.
  6. Unselect "Auto-Pack" on the "Packing" Page, as we don't want it to create archives for us just yet.
  7. Select "Wrap" from the "Process" menu at the top of the window, as the app needs to be tested.
  8. Once AW has wrapped the application, double click the icon in the right hand side of the window.

The Hardened Runtime security protocol adds restrictions to the application. If the application doesn't work, see Hardened Runtime Issues for info on solving the most common issues.

In order to complete the complete the Packing process, we need to make sure that App Wrapper has been configured for uploading to Apple's servers.

  1. Select "Packing" from the left hand sidebar.
  2. Scroll the right hand side contents till you can see "Submit to Apple".
  3. Click on the popup menu next to "Developer Account" (which may read "Select an account") and select "Add an account..".
  4. Give the account an memorable name.
  5. Enter in the e-mail address that is used to log-into Apple Developer services.
  6. Create an "App-Specific" password, by following the directions here https://support.apple.com/en-gb/HT204397.
  7. Enter the App-Specific password into the "App-Specific password" field of the account editor in App Wrapper.
  8. Click on the "Verify account" button to make sure that it is correct. If not see Submission Issues.

Once everything is working, move on to the next step.

  1. Select "Pack" from the "Process" menu at the top of the window, this will perform the packing stage.
  2. Once Packing is complete, click on the "Notarize" button next the archive in the right hand side of the window.
  3. Give it a few minutes, and the application should be Notarized.
  4. If there are problems, the error will be displayed in the window and the Notarization Issues document should help resolve those issues.

Now that the process has been performed manually and any problems been resolved, we can enable the automation options.

  1. Select "Auto-Pack" from the top right hand corner of the "Packing" page, so that App Wrapper will create the archives after wrapping.
  2. Select "Notarization" next to "Auto-Submit" in the "Submit to Apple" section of the "Packing" page.
  3. Follow the guide Integrating with Xojo so this happens when you build the application in Xojo.