Merge pull request #6743 from CDiaz-MS/arfoundation_doc

Update to ARFoundation documentation

Author: David Kline

Documentation/CameraSystem/UnityArCameraSettings.md

@@ -2,48 +2,12 @@
 
 The Unity AR camera settings provider is an experimental MRTK component that enables mixed reality applications to run on Android and iOS devices.
 
-## Prerequisites
-
-Before the Unity AR camera settings provider can be enabled in an application, the following steps need to be completed.
-
-1. Download and import the **Microsoft.MixedReality.Toolkit.Providers.UnityAR** package, from GitHub or NuGet
-1. In the Unity Package Manager, ensure the following package(s) are installed:
-
-    | Unity 2018.4 | Unity 2019.x | Comments |
-    | --- | --- | -- |
-    | AR Foundation | AR Foundation | For Unity 2018.4, this package is included as a preview |
-    | | XR Legacy Input Helpers | |
-    | AR Core | | For Android device support |
-    | AR Kit | | For iOS device support |
-
-1. If using Unity 2019.x, the assembly definition file for the Unity AR provider needs to be modified to have the **UnityEngine.SpatialTracking** reference added.
-
-    ![Unity AR assembly definition](../Images/CrossPlatform/UnityArAssemblyReferences.png)
-
-## Enabling the Unity AR camera settings provider
-
-The following steps presume use of the MixedRealityToolkit object. Steps required for other service registrars may be different.
-
-1. Select the MixedRealityToolkit object in the scene hierarchy.
-
-    ![MRTK Configured Scene Hierarchy](../Images/MRTK_ConfiguredHierarchy.png)
-
-2. Navigate the Inspector panel to the camera system section and expand the **Camera Settings Providers** section.
-
-    ![Expand settings providers](../Images/CameraSystem/ExpandProviders.png)
-
-3. Click **Add Camera Settings Provider** and expand the newly added **New camera settings** entry.
-
-    ![Expand new settings provider](../Images/CameraSystem/ExpandNewProvider.png)
-
-4. Select the Unity AR Camera Settings provider
-
-    ![Select Unity AR settings provider](../Images/CameraSystem/SelectUnityArSettings.png)
-
-## Configuring the Unity AR camera settings provider
+## Unity AR camera settings provider options
 
 ![Unity AR camera settings configuration](../Images/CameraSystem/UnityArSettingsConfiguration.png)
 
+For a guide on how to add the provider to your scene: [How to configure MRTK for iOS and Android](../CrossPlatform/UsingARFoundation.md)
+
 ### Tracking settings
 
 The Unity AR camera settings provider allows configuration options for how tracking is performed. These settings are specific to the Unity AR camera settings provider implementation.

Documentation/CrossPlatform/UsingARFoundation.md

@@ -0,0 +1,93 @@
+# How to configure MRTK for iOS and Android [Experimental]
+
+## Install Required Packages
+
+1. Download and import the **Microsoft.MixedReality.Toolkit.Providers.UnityAR** package, from [GitHub](https://github.com/microsoft/MixedRealityToolkit-Unity/releases/tag/v2.2.0) or [NuGet](../MRTKNuGetPackage.md)
+
+> [!NOTE]
+> After you import the the UnityAR package, you will see the following error: 
+> *Assembly has reference to non-existent assembly 'Unity.XR.ARFoundation' (Assets/MixedRealityToolkit.Staging/UnityAR/Microsoft.MixedReality.Toolkit.Providers.UnityAR.asmdef)*
+". To resolve, install the correct version of ARFoundation listed below.
+
+
+2. In the Unity Package Manager (UPM), install the following packages:
+
+    ### Unity 2018.4.x 
+
+    | **Android** | **iOS** | Comments |
+    | --- | --- | --- |
+    | AR Foundation  <br/> Version: 1.5.0 - preview 6 | AR Foundation  <br/> Version: 1.5.0 - preview 6 | For Unity 2018.4, this package is included as a preview. To view package: Window > Package Manager > Advanced > Show Preview Packages|
+    | ARCore XR Plugin <br/> Version: 2.1.2 | | |
+    |  | ARKit XR Plugin <br/> Version: 2.1.2  | |
+
+
+    ### Unity 2019.x 
+
+    | **Android** | **iOS** | 
+    | --- | --- |
+    | AR Foundation  <br/> Version: 2.1.4 |  AR Foundation  <br/> Version: 2.1.4 |
+    | ARCore XR Plugin <br/> Version: 2.1.2 | |
+    |  | ARKit XR Plugin <br/> Version: 2.1.2  |
+
+
+
+1. If using Unity 2019.x, the assembly definition file for the Unity AR provider needs to be modified to have the **UnityEngine.SpatialTracking** reference added.
+
+    ![Unity AR assembly definition](../Images/CrossPlatform/UnityArAssemblyReferences.png)
+
+## Enabling the Unity AR camera settings provider
+
+The following steps presume use of the MixedRealityToolkit object. Steps required for other service registrars may be different.
+
+1. Select the MixedRealityToolkit object in the scene hierarchy.
+
+    ![MRTK Configured Scene Hierarchy](../Images/MRTK_ConfiguredHierarchy.png)
+
+2. Select **Copy and Customize** to Clone the MRTK Profile to enable custom configuration.
+
+    ![Clone MRTK Profile](../Images/CameraSystem/CloneProfileARFoundation.png)
+
+3. Select **Clone** next to the Camera Profile.
+
+    ![Clone MRTK Camera Profile](../Images/CameraSystem/CloneCameraProfileARFoundation.png)
+
+4. Navigate the Inspector panel to the camera system section and expand the **Camera Settings Providers** section.
+
+    ![Expand settings providers](../Images/CameraSystem/ExpandProviders.png)
+
+5. Click **Add Camera Settings Provider** and expand the newly added **New camera settings** entry.
+
+    ![Expand new settings provider](../Images/CameraSystem/ExpandNewProvider.png)
+
+6. Select the Unity AR Camera Settings provider
+
+    ![Select Unity AR settings provider](../Images/CameraSystem/SelectUnityArSettings.png)
+
+    For more information about configuring the Unity AR camera settings provider: [Unity AR camera settings provider](../CameraSystem/UnityArCameraSettings.md).
+
+## Building a Scene for Android and iOS devices
+
+1. Make sure you have added the UnityAR Camera Settings Provider to your scene.
+
+2. Switch platform to either Android or iOS in the Unity Build Settings
+
+When you switch the platform you should see the MRTK Project Configurator Window with settings for your chosen platform.  Click Apply to enable platform specific settings.
+
+iOS Project Configurator Settings
+
+![iOS Project Configurator](../Images/CameraSystem/MRTKProjectConfigurator.png)
+
+3. There are no additional steps after switching the platform for Android. 
+
+4. If the platform is iOS, Edit > Project Settings > Player > Other Settings, under the Optimization header, **uncheck** Strip Engine Code
+
+![iOS Settings](../Images/CameraSystem/UncheckStripEngineCodeiOS.png)
+
+> [!NOTE]
+> Unchecking Strip Engine Code is the short term solution to an error in Xcode [#6646](https://github.com/microsoft/MixedRealityToolkit-Unity/issues/6646).  We are working on a long term solution for MRTK 2.3.0.
+
+5. Build and run the scene
+
+## See Also
+
+- [Unity AR Camera Settings](../CameraSystem/UnityArCameraSettings.md)

Documentation/Images/CameraSystem/CloneCameraProfileARFoundation.png

@@ -51,6 +51,10 @@
         href: CameraSystem/UnityArCameraSettings.md
       - name: Creating a camera settings provider
         href: CameraSystem/CreateSettingsProvider.md
+  - name: Cross Platform Support
+    items: 
+    - name: Configure MRTK for iOS and Android
+      href: CrossPlatform/UsingARFoundation.md
   - name: Detecting Platform Capabilities
     href: DetectingPlatformCapabilities.md
   - name: Diagnostics System