You are here:   Table of contents / Ios Submission Process / Test The Ios Native App In Ad Hoc Version

iOS - Test the ad hoc version in white label

The following tutorial will show you how to host your ad hoc version of your iOS app to white label the install. 

It is ONLY possible to test the ad hoc version of the iOS app on a registered device. 

The UDIDs of the registered devices have been added during the GoodBarber iOS review process .
If you wish to add more devices, you can make a request to authorize new UDID  to your ad hoc version.


Host the ad hoc .ipa file on a server

Download the ad hoc .ipa file from your back office: https://[PROJECTNAME]

For example, if the name used to create my GoodBarber project is "myproject", the URL to download the ad hoc .ipa file is:
Make sure that the ad hoc .ipa file is hosted on a secure server (the URL must contain https://). 

Otherwise, it won't be possible to install your app on your users' devices.  


Create a manifest associated with this binary file

A manifest is a file that contains metadata related to the other files it describes. For example, in our case, the manifest will indicate the URL of your app's .ipa file, the bundle ID, and the name of the app

You must manually build this file (see the example below). You can create the manifest in any text editor. When saving it, give it the .plist extension. 
<?xml version="1.0" encoding="UTF-8"?> 
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" " "> 
<plist version="1.0"> 
                   <string>[https link to the IPA file]</string> 
               <string>[Bundle ID]</string> 
               <string>[App Name]</string> 

Don't forget to replace the following elements in brackets : 

[Https link to the IPA file]: Your .ipa file's URL after it's been hosted on a secure server 
[Bundle ID]: Your app ID available on this page: Sales channels > iOS App > Certificates
[App name]: The name of your app 


After the the .plist file has been uploaded on a secure server, you can then create a web page with a link to download your app like in the example below: 
<a href="itms-services://?action=download-manifest&url=URL_OF_THE_PLIST_FILE" id="text">Download our application</a> 

Don't forget to replace "URL_OF_THE_PLIST_FILE" with your .plist file's URL. 
You can also replace the text "Download our application" with another message.  

Your app can be downloaded from the link created on your web page opened on an iOS device.

Note: the users may have to accept the developer in their phone Settings > General > Profiles and Devices (or "Device Management") before being able to install it.