update provisioning profiles

admin_manual/enterprise_ios_app/publishing_ios_app.rst

@@ -11,7 +11,10 @@ Prerequisites
 =============
 
 * A Mac OS X computer with Xcode (free download) and Keychain Access 
-  (included in Utilities)
+  (included in Utilities). This computer is essential to the entire process 
+  and will be linked to to your iOS Developer account. You will use it 
+  create and store distribution certificates, and to upload your app to iTunes 
+  Connect.
 * An iOS developer account on 
   `Developer.Apple.com/ios <https://developer.apple.com/ios/>`_, 
   which costs $99 per year. Or an Enterprise account for $299/yr. The 
@@ -29,23 +32,25 @@ Prerequisites
 Procedure
 =========
   
-You need the Apple tools to build three provisioning profiles and a P12 
-certificate, which you will email to branding@owncloud.com after building your 
-app with the ownBrander app on `Customer.owncloud.com 
-<https://customer.owncloud.com/owncloud>`_. It is best to create the 
-provisioning profiles and P12 certificate first, before building your app, 
-because you must supply a unique **bundle ID** and an **app group** to build 
-your app. These are created in your account on `Developer.Apple.com 
-<https://developer.apple.com>`_, and with Keychain Access on your Mac computer.
+You need the Apple tools to build eight provisioning profiles (4 Ad Hoc and 4 
+App Store) and a P12 certificate. You will email the four Ad Hoc profiles and 
+P12 certificate to branding@owncloud.com after building your app with the 
+ownBrander app on `Customer.owncloud.com 
+<https://customer.owncloud.com/owncloud>`_. You must create the provisioning 
+profiles and P12 certificate first, before building your app, because you must 
+supply a unique **bundle ID** and an **app group** to build your app. These are 
+created in your account on `Developer.Apple.com 
+<https://developer.apple.com>`_, 
+and with Keychain Access on your Mac computer.
 
-We use the provisioning profiles and P12 certificate to complete building your 
-app, and then in 24-48 hours your new branded app is loaded into your account 
-on `Customer.owncloud.com <https://customer.owncloud.com/owncloud>`_.
+We use the 4 Ad Hoc provisioning profiles and P12 certificate to complete 
+building your app, and then in 24-48 hours your new branded app is loaded into 
+your account on `Customer.owncloud.com 
+<https://customer.owncloud.com/owncloud>`_.
 
-The next step is to test your app on your registered iOS devices. When it 
-passes testing, the final step is to upload it to your iTunes account for 
-distribution.
+The next step is to test your app. When it passes testing, the final step is to 
+upload it to your iTunes Connect account for distribution.
 
 You will need a lot of graphics for building your app, and for your iTunes 
 store listing, in specific sizes and file formats. The ownBrander app and 
-iTunes detail all the image specifications you will need.
+iTunes detail all the image specifications you will need.

admin_manual/enterprise_ios_app/publishing_ios_app_2.rst

@@ -2,8 +2,9 @@
 Create Certificate Signing Request
 ==================================
 
-Create a :file:`.certSigningRequest` (CSR) file on your Mac, using Keychain 
-Access. Open Finder, and then open Keychain Access from the Utilities folder.
+Start by creating a :file:`.certSigningRequest` (CSR) file on your Mac, using 
+Keychain Access. Open Finder, and then open Keychain Access from the Utilities 
+folder.
     
 .. figure:: ../images/mac-1.png
 
@@ -50,8 +51,7 @@ Then click **iOS Apps > Certificates**.
 
 .. figure:: ../images/cert-2.png
 
-Next, click the add button (the little plus sign) in the top right corner of 
-the 
+Next, click the add button (the little plus sign) in the top right corner of the 
 **iOS Certificate** page.
 
 .. figure:: ../images/cert-3.png

admin_manual/enterprise_ios_app/publishing_ios_app_3.rst

@@ -2,7 +2,7 @@
 Create Bundle IDs
 =================
 
-The next step is to create three **Bundle IDs**. These are unique identifiers 
+The next step is to create four **Bundle IDs**. These are unique identifiers 
 for your branded iOS app. You must also create an **App Group** and place your 
 three **Bundle IDs** in your **App Group**. You will need your base **Bundle 
 ID** and **App Group** when you build your app with the ownBrander app on 
@@ -49,7 +49,7 @@ The next step is to create an App Group and put your App ID in it. Go to
 .. figure:: ../images/cert-13.png
      
 Create a description for your app group, and a unique identifier in the format 
-*group.com.MyCompany.MyAppGroup*. Then click **Continue**.    
+*group.com.MyCompany.MyAppGroup*. Then click **Continue**
 
 .. figure:: ../images/cert-14.png
    
@@ -151,7 +151,43 @@ Select your group and click **Continue**.
 On the confirmation screen click **Assign**, and you'll see the message "You 
 have successfully updated the App Groups associations with your App ID." 
 
-Now you should have three new App IDs, and all three of them should belong to 
+Create a ShareExtApp Bundle ID
+------------------------------
+
+This supports Apple's ShareIN extension. 
+
+Yet again, go to **Identifiers > App IDs** and click the plus button to create a 
+ShareExtApp Bundle ID. Follow the same naming conventions as for your App ID, 
+then click **Continue**.
+
+.. figure:: ../images/cert-53.png
+   
+Confirm your new App ID and click **Submit**.
+
+.. figure:: ../images/cert-54.png
+
+You will see one more confirmation; review it and click **Done**. Now you need 
+to add it to your App Group. Go to **Identifiers > App IDs** and click on your 
+new ShareExtApp Bundle ID to open its configuration window, and 
+then click the **Edit** button. 
+
+.. figure:: ../images/cert-55.png
+   
+Select **App Groups** and click the **Edit** button.   
+
+.. figure:: ../images/cert-56.png
+
+Select your group and click **Continue**.
+
+.. figure:: ../images/cert-57.png
+    
+On the confirmation screen click **Assign**, and you'll see the message "You 
+have successfully updated the App Groups associations with your App ID." 
+
+Four Completed App IDs
+----------------------
+
+Now you should have four new App IDs, and all of them should belong to 
 your App Group.
 
-.. figure:: ../images/cert-37.png
+.. figure:: ../images/cert-37.png

admin_manual/enterprise_ios_app/publishing_ios_app_5.rst

@@ -2,13 +2,16 @@
 Create Provisioning Profiles
 ============================
 
-The next phase of this glorious journey is to create three provisioning 
-profiles. These are the profiles that you will email to branding@owncloud.com 
-after building your branded app with the ownBrander app on 
-`Customer.owncloud.com <https://customer.owncloud.com/owncloud>`_.
+The next phase of this glorious journey is to create eight provisioning 
+profiles: 4 Ad Hoc and 4 App Store. You will email the four Ad Hoc profiles, 
+and your :doc:`P12 certificate <publishing_ios_app_6>` (which you will create 
+after your provisioning profiles), to branding@owncloud.com after building your 
+branded app with the ownBrander app on `Customer.owncloud.com 
+<https://customer.owncloud.com/owncloud>`_. Do not send us the App Store 
+profiles. All eight of these profiles must be stored on your Mac PC.
 
-First Provisioning Profile
---------------------------
+First Ad Hoc Provisioning Profile
+---------------------------------
 
 Go to **Provisioning Profiles > All**, then click the plus button (top right) 
 to open the *Add iOS Provisioning Profile* screen. Select **Ad Hoc** and click 
@@ -46,8 +49,8 @@ it in Xcode.
 
 .. figure:: ../images/cert-41.png
 
-Second Provisioning Profile
----------------------------
+Second Ad Hoc Provisioning Profile
+----------------------------------
 
 Return to the "Your provision profile is ready" screen, scroll to the bottom 
 and click **Add Another**. On the following screen select **Ad Hoc** and click 
@@ -55,8 +58,7 @@ and click **Add Another**. On the following screen select **Ad Hoc** and click
 
 .. figure:: ../images/cert-35.png
   
-This time select the Select the **.DocumentProvider** app ID and click 
-**Continue**.
+This time select the **.DocumentProvider** app ID and click **Continue**.
 
 .. figure:: ../images/cert-42.png
 
@@ -79,8 +81,8 @@ plus **.DocumentProvider** and click **Generate**.
 Just like the first provisioning profile, download it to your Mac computer, and 
 then double-click to install it in Xcode.
  
-Third Provisioning Profile
---------------------------
+Third Ad Hoc Provisioning Profile
+---------------------------------
 
 Return to the "Your provision profile is ready" screen, scroll to the bottom 
 and click **Add Another**. On the following screen select **Ad Hoc** and click 
@@ -88,10 +90,10 @@ and click **Add Another**. On the following screen select **Ad Hoc** and click
 
 .. figure:: ../images/cert-35.png
 
-This time select the Select the **.DocumentProviderFileProvider** app ID and 
-click **Continue**.
+This time select the **.DocumentProviderFileProvider** app ID and click 
+**Continue**.
 
-.. figure:: ../images/cert-46.png  
+.. figure:: ../images/cert-60.png  
    
 Select the certificate that you created at the beginning of this process and 
 click **Continue**.
@@ -111,11 +113,60 @@ be automatically truncated if you go over.
 
 .. figure:: ../images/cert-47.png
       
+Download it to your Mac computer, and then double-click to install it in Xcode.
+
+Fourth Ad Hoc Provisioning Profile
+----------------------------------
+
+Return to the "Your provision profile is ready" screen, scroll to the bottom 
+and click **Add Another**. On the following screen select **Ad Hoc** and click 
+**Continue**.
+
+.. figure:: ../images/cert-35.png
+
+This time select the **.ShareExtApp** app ID and click **Continue**.
+
+.. figure:: ../images/cert-46.png  
+   
+Select the certificate that you created at the beginning of this process and 
+click **Continue**.
+
+.. figure:: ../images/cert-43.png
+
+Select the devices that you want to install and test your app on, then click 
+**Continue**. These must be the same devices you selected for the first 
+provisioning profile.
+
+.. figure:: ../images/cert-39.png
+   
+Give this provisioning profile the same name as your first profile 
+plus **.ShareExtApp** and click **Generate**. There is a 
+50-character limit, but don't worry about counting characters because it will 
+be automatically truncated if you go over.  
+
+.. figure:: ../images/cert-58.png
+      
 Download it to your Mac computer, and then double-click to install it in Xcode. 
-You should now see all of your provisioning profiles listed in your "iOS 
+You should now see all of your Ad Hoc provisioning profiles listed in your "iOS 
 Provisioning Profiles".
 
-.. figure:: ../images/cert-52.png
+.. figure:: ../images/cert-59.png
 
-You have one more certificate to create, and that is your P12 certificate.   
+Create Four App Store Profiles
+------------------------------
+
+Creating your four App Store profiles is the same as creating your Ad Hoc 
+profiles, except that when you start you check the App Store checkbox, and you 
+won't select testing devices.
+
+.. figure:: ../images/cert-62.png
+
+When you're finished, you'll have eight new provisioning profiles. Remember, 
+when you build your app on ownBuilder you only send in the four Ad Hoc 
+profiles, plus your P12 certificate.
+
+.. figure:: ../images/cert-61.png
+
+Go to the next page to learn how to create your :doc:`P12 certificate 
+<publishing_ios_app_6>`.   
   

admin_manual/enterprise_ios_app/publishing_ios_app_6.rst

@@ -2,7 +2,7 @@
 Creating a P12 Certificate
 ==========================
 
-In addition to emailing your three provisioning profiles to 
+In addition to emailing your four Ad Hoc provisioning profiles to 
 branding@owncloud.com, you must also include your P12 certificate. To create 
 this, return to Keychain Access on your Mac computer and find your private key 
 that you created at the beginning (see 

admin_manual/enterprise_ios_app/publishing_ios_app_7.rst

@@ -119,7 +119,7 @@ Generate iOS App
 
 When you have uploaded all of your images and completed your customizations, 
 click the **Generate iOS App** button and take a well-deserved break. Remember 
-to email your three provisioning profiles and P12 certificate to 
+to email your four Ad Hoc provisioning profiles and P12 certificate to 
 branding@owncloud.com.
 
 .. figure:: ../images/ownbrander-28.png