Ios ota distribution - Revision history

Jfreier at 18:28, 20 February 2015

2015-02-20T18:28:08Z

Jfreier at 18:25, 20 February 2015

2015-02-20T18:25:18Z

Jfreier at 18:24, 20 February 2015

2015-02-20T18:24:32Z

Jfreier at 18:23, 20 February 2015

2015-02-20T18:23:13Z

Jfreier at 18:22, 20 February 2015

2015-02-20T18:22:52Z

Jfreier at 18:22, 20 February 2015

2015-02-20T18:22:10Z

Jfreier at 18:21, 20 February 2015

2015-02-20T18:21:03Z

Jfreier: Created page with 'iOS OTA deployment document =============================================================================== This is to document the process to create OTA (over the air) deployme…'

2015-02-20T18:19:46Z

Created page with 'iOS OTA deployment document =============================================================================== This is to document the process to create OTA (over the air) deployme…'

New page

iOS OTA deployment document
===============================================================================

This is to document the process to create OTA (over the air) deployments for ios.

This will allow an iOS device to connect to a website and directly download an application. presumable the newest build, but could be done for multiply builds as well.

File you will need.
------------------------------------
1. application.ipa
2. image.512x512.png
3. image.57x57.png
4. manifest.plist
5. test.html

1. application.ipa

This is the actual appliation that will get installled on the device. The name of the file is not as important. Althogh a good note is that the name should not contain any spaces, this will cause problems.

2. image.512x512.png

This is the imaget that it will use when install, not sure why it is needed, but it is required. This image also does not need to be 512x512, I tested by using an image the was 114x114. Also I dont think the name is required to match this, as lons as it matches the name in the manifest.plist.

3. image.57x57.png

This is the icon is uses when trying to install the application. This is required but the name does not need to be this, only needs to match in the manifest.plist.

4. manifest.plist

This file contains all the nessecary information for the applicaiton to be installed, there are 4 main parts,

a. URL - The URL where the file is located to download from.
b. display-image - The icon to display when downloading.
c. full-size-image - The large image used by iTunes???
d. metadata - Informaiton about the applicaion.

5. test.html

This is the file that needs to contain the crazy link to the manifest.plist to download the application. This URL is not a normal URL.

<a href="itms-services://?action=download-manifest&url=https:/blah.com/ios/manifest.plist">Download</a>

Apache Setup
----------------------------------
There needs to be an additionaly type added to the apache http.conf, to correctly download the *.ipa to the device.

AddType application/octet-stream .ipa

Tips
-----------------------------------
- Make sure all links in the manifest are accessable.
- Make sure the HTTP connection is HTTPs or this will not work! It is required by Apple as of iOS 7.1
- Make sure Apache is setup to for the *.ipa type.

Example Code
-------------------------------------------------------------------------------

This is a working example of a manifest with the URL x'd out.

<!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:/blah.com/ios/application.ipa</string>
</dict>

<dict>
<key>kind</key>
<string>display-image</string>

<key>needs-shine</key>
<true/>
<key>url</key>
<string>https:/blah.com/ios/image.57x57.png</string>
</dict>

<dict>
<key>kind</key>
<string>full-size-image</string>
<key>needs-shine</key>
<true/>
<key>url</key>
<string>https:/blah.com/ios/image.512x512.png</string>
</dict>
</array>
<key>metadata</key>
<dict>

<key>bundle-identifier</key>
<string>com.application</string>

<key>kind</key>
<string>software</string>

<key>title</key>
<string>Mobile App</string>
</dict>
</dict>
</array>
</dict>
</plist>

This is an example test.html file.

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<title>OTA Test App</title>
</head>
<body>
<ul>
<li>
<a href="itms-services://?action=download-manifest&url=https:/blah.com/ios/manifest.plist"> Tap Here to Install the Application</a>
</li>
</ul>
</body>

</html>

← Older revision		Revision as of 18:28, 20 February 2015
Line 130:		Line 130:

	== Resources ==		== Resources ==
		+	* http://stackoverflow.com/questions/20276907/enterprise-app-deployment-doesnt-work-on-ios-7-1
		+	* http://nachbaur.com/blog/building-ios-apps-for-over-the-air-adhoc-distribution
		+	* http://www.informit.com/articles/article.aspx?p=1829415&seqNum=16

← Older revision		Revision as of 18:25, 20 February 2015
Line 127:		Line 127:
	</body>		</body>
	</html>		</html>
		+
		+
		+	== Resources ==

@@ Line 120: / Line 120: @@
    </head>
    <body>
-    <ul>
+  <ul>
-    <li>
+  <li>
    <a href="itms-services://?action=download-manifest&url=https:/blah.com/ios/manifest.plist"> Tap Here to Install the Application</a>
-    </li>
+  </li>
-    </ul>
+  </ul>
    </body>
    </html>

@@ Line 104: / Line 104: @@
                   <key>title</key>
                   <string>Mobile App</string>
-             </dict>
+               </dict>
-         </dict>
+           </dict>
-     </array>
+       </array>
-  </dict>
+    </dict>
-</plist>
+  </plist>
@@ Line 114: / Line 114: @@
 This is an example test.html file.
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+  <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
-<html>
+  <html>
-<head>
+  <head>
-  <title>OTA Test App</title>
+    <title>OTA Test App</title>
-</head>
+  </head>
-<body>
+  <body>
-  <ul>
+    <ul>
-  <li>
+    <li>
-     <a href="itms-services://?action=download-manifest&url=https:/blah.com/ios/manifest.plist"> Tap Here to Install the Application</a>
+       <a href="itms-services://?action=download-manifest&url=https:/blah.com/ios/manifest.plist"> Tap Here to Install the Application</a>
-  </li>
+    </li>
-  </ul>
+    </ul>
-</body>
+  </body>
+  </html>
 </html>

@@ Line 51: / Line 51: @@
-Example Code
+== Example Code ==
--------------------------------------------------------------------------------
-−
 This is a working example of a manifest with the URL x'd out.
-<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+  <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
-<plist version="1.0">
+  <plist version="1.0">
-<dict>
+  <dict>
-   <!-- array of downloads. -->
+     <!-- array of downloads. -->
-   <key>items</key>
+     <key>items</key>
-   <array>
+     <array>
-       <dict>
+         <dict>
-           <!-- an array of assets to download -->
+             <!-- an array of assets to download -->
-           <key>assets</key>
+             <key>assets</key>
-           <array>
+             <array>
-               <!-- software-package: the ipa to install. -->
+                 <!-- software-package: the ipa to install. -->
-               <dict>
+                 <dict>
-                   <!-- required.  the asset kind. -->
+                     <!-- required.  the asset kind. -->
-                   <key>kind</key>
+                     <key>kind</key>
-                   <string>software-package</string>
+                     <string>software-package</string>
-                   <!-- required.  the URL of the file to download. -->
+                     <!-- required.  the URL of the file to download. -->
-                   <key>url</key>
+                     <key>url</key>
-                   <string>https:/blah.com/ios/application.ipa</string>
+                     <string>https:/blah.com/ios/application.ipa</string>
-               </dict>
+                 </dict>
-               <!-- display-image: the icon to display during download. -->
+                 <!-- display-image: the icon to display during download. -->
-               <dict>
+                 <dict>
-                   <key>kind</key>
+                     <key>kind</key>
-                   <string>display-image</string>
+                     <string>display-image</string>
-                   <!-- optional. icon needs shine effect applied. -->
+                     <!-- optional. icon needs shine effect applied. -->
-                   <key>needs-shine</key>
+                     <key>needs-shine</key>
-                   <true/>
+                     <true/>
-                   <key>url</key>
+                     <key>url</key>
-                   <string>https:/blah.com/ios/image.57x57.png</string>
+                     <string>https:/blah.com/ios/image.57x57.png</string>
-               </dict>
+                 </dict>
-               <!-- full-size-image: the large 512Ã512 icon used by iTunes. -->
+                 <!-- full-size-image: the large 512Ã512 icon used by iTunes. -->
-               <dict>
+                 <dict>
-                   <key>kind</key>
+                     <key>kind</key>
-                   <string>full-size-image</string>
+                     <string>full-size-image</string>
-                   <key>needs-shine</key>
+                     <key>needs-shine</key>
-                   <true/>
+                     <true/>
-                   <key>url</key>
+                     <key>url</key>
-                   <string>https:/blah.com/ios/image.512x512.png</string>
+                     <string>https:/blah.com/ios/image.512x512.png</string>
-               </dict>
+                 </dict>
-           </array>
+             </array>
-           <key>metadata</key>
+             <key>metadata</key>
-           <dict>
+             <dict>
-               <!-- required -->
+                 <!-- required -->
-               <key>bundle-identifier</key>
+                 <key>bundle-identifier</key>
-               <string>com.application</string>
+                 <string>com.application</string>
-               <!-- required.  the download kind. -->
+                 <!-- required.  the download kind. -->
-               <key>kind</key>
+                 <key>kind</key>
-               <string>software</string>
+                 <string>software</string>
-               <!-- required.  the title to display during the download. -->
+                 <!-- required.  the title to display during the download. -->
-               <key>title</key>
+                 <key>title</key>
-               <string>Mobile App</string>
+                 <string>Mobile App</string>
-           </dict>
+             </dict>
-       </dict>
+         </dict>
-   </array>
+     </array>
-</dict>
+  </dict>
 </plist>

@@ Line 1: / Line 1: @@
 This is to document the process to create OTA (over the air) deployments for ios.
 This will allow an iOS device to connect to a website and directly download an application.  presumable the newest build, but could be done for multiply builds as well.
 File you will need.
-------------------------------------
+== File you will need. ==
 . application.ipa
 . image.512x512.png
@@ Line 43: / Line 40: @@
+== Apache Setup ==
-−
-−
 Apache Setup
-----------------------------------
 There needs to be an additionaly type added to the apache http.conf, to correctly download the *.ipa to the device.
    AddType application/octet-stream .ipa
+== Tips ==
+* Make sure all links in the manifest are accessable.
+* Make sure the HTTP connection is HTTPs or this will not work! It is required by Apple as of iOS 7.1
-Tips
+* Make sure Apache is setup to for the *.ipa type.
------------------------------------
-- Make sure all links in the manifest are accessable.
-- Make sure the HTTP connection is HTTPs or this will not work! It is required by Apple as of iOS 7.1
-- Make sure Apache is setup to for the *.ipa type.