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. 

Note: It is ONLY possible to test the ad hoc version of the iOS app on a registered device. 
The UDIDs of the registered devices are displayed in the menu Publish > iOS App > Certificates  in the List of authorized devices.
Here is a tutorial on how to get the UDID of a test device


1

Host the the ad hoc .ipa file on a server

The ad hoc .ipa file can be downloaded from your back office: https://[PROJECTNAME].goodbarber.com/apiv3/build/iphone/adhoc

For example, if the name used to create my GoodBarber project is "infocorsica", the URL to download the ad hoc .ipa file is: https://infocorsica.goodbarber.com/apiv3/build/iphone/adhoc
 
Warning: 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.  


2

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" "http://www.apple.com/DTDs/PropertyList-1.0.dtd "> 
<plist version="1.0"> 
<dict> 
   <key>items</key> 
   <array> 
       <dict> 
           <key>assets</key> 
           <array> 
               <dict> 
                   <key>kind</key> 
                   <string>software-package</string> 
                   <key>url</key> 
                   <string>[https link to the IPA file]</string> 
               </dict> 
           </array> 
           <key>metadata</key> 
           <dict> 
               <key>bundle-identifier</key> 
               <string>[Bundle ID]</string> 
               <key>bundle-version</key> 
               <string>1.0</string> 
               <key>kind</key> 
               <string>software</string> 
               <key>title</key> 
               <string>[App Name]</string> 
           </dict> 
       </dict> 
   </array> 
</dict> 
</plist> 

 
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 : Publish > iOS App > Certificates
[App name]: The name of your app 


3

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.  

TipYou can host the .ipa file and the manifest (.plist file) in the folder Settings > My Files  in your back office. 

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.