(DOCSP-17079): Mac Catalyst Support - React Native

source/includes/steps-mac-catalyst.yaml

@@ -0,0 +1,63 @@
+title: Update Your Build Phase Settings
+ref: update-build-phase-settings
+content: |
+  Before you can use Mac Catalyst in your React Native application, you must
+  specify the platform name. Click :guilabel:`Build Phases` in XCode, and within
+  the :guilabel:`Bundle React Native code and images` tab, add the following to
+  specify "ios" as the platform name.
+
+  .. code-block:: none
+
+   export PLATFORM_NAME=ios
+---
+title: Update Your Podfile
+ref: update-podfile
+content: |
+
+  .. note:: 
+
+   This is a temporary step that will not be necessary when the following Cocoapods issue is solved:
+   :github:`[Catalyst] Podspec Resource Bundle requires a development team <CocoaPods/CocoaPods/issues/8891>`
+
+  Currently, there is a :github:`Cocoapods bug
+  <CocoaPods/CocoaPods/issues/8891>` that causes XCode to require a development
+  team when building for Mac Catalyst. This bug prevents signing locally. As a
+  workaround, you can alter your Podfile to fix your bundle target's signing
+  certificate to sign to run locally.
+
+  Replace the post-install script in your Podfile by removing the following lines:
+
+  .. code-block:: none
+     :caption: /ios/Podfile
+
+   post_install do |installer|
+     react_native_post_install(installer)
+   end
+
+  And copy the following lines where your previous post-install script was:
+
+  .. code-block:: none
+     :caption: /ios/Podfile
+
+   post_install do |installer|
+     react_native_post_install(installer)
+     installer.pods_project.targets.each do |target|
+       # Fix bundle targets' 'Signing Certificate' to 'Sign to Run Locally'
+       if target.respond_to?(:product_type) and target.product_type == "com.apple.product-type.bundle"
+         target.build_configurations.each do |config|
+           config.build_settings['CODE_SIGN_IDENTITY[sdk=macosx*]'] = '-'
+         end
+       end
+     end
+   end
+---
+title: Activate and Test Catalyst in Your Project
+ref: activate-catalyst
+content: |
+  To test out Catalyst in your project, activate Mac in the :guilabel:`general`
+  tab of your XCode project workspace. To do this, click :guilabel:`Mac` in the
+  :guilabel:`Deployment Info` section. Select :guilabel:`"Scale Interface to Match iPad"`.  
+  This makes "My Mac" selectable, allowing you to run your application on your Mac.
+
+  .. figure:: /images/activate-my-mac-xcode-catalyst.png
+     :alt: Activate your Mac in Xcode Project Workspace

source/sdk/react-native.txt

@@ -14,6 +14,7 @@ MongoDB Realm React Native SDK
    Fundamentals </sdk/react-native/fundamentals>
    Data Types </sdk/react-native/data-types>
    Usage Examples </sdk/react-native/examples>
+   Integration Guides </sdk/react-native/integrations>
    Advanced Guides </sdk/react-native/advanced>
 
    Javascript SDK Reference Manual <https://docs.mongodb.com/realm-sdks/js/latest/>

source/sdk/react-native/install.txt

@@ -41,6 +41,11 @@ meets the following prerequisites:
    "eject" your Expo project to use {+service-short+}. The installation
    steps on this page do not use the Expo CLI.
 
+.. note:: Realm JS version 10.6.0 Supports Mac Catalyst
+
+   Building your {+service-short+} React Native application requires additional
+   steps in order to :doc:`build your application when using Mac Catalyst
+   </sdk/react-native/integrations/mac-catalyst>`.
 
 Installation
 ------------

source/sdk/react-native/integrations.txt

@@ -0,0 +1,13 @@
+=====================================
+Realm Integrations - React Native SDK
+=====================================
+
+.. toctree::
+   :titlesonly:
+   :hidden:
+
+   Build using Mac Catalyst </sdk/react-native/integrations/mac-catalyst>
+
+- :doc:`Build using Mac Catalyst </sdk/react-native/integrations/mac-catalyst>`
+
+

source/sdk/react-native/integrations/mac-catalyst.txt

@@ -0,0 +1,32 @@
+.. _react-native-mac-catalyst:
+
+========================
+Build using Mac Catalyst
+========================
+
+.. default-domain:: mongodb
+
+.. contents:: On this page
+   :local:
+   :backlinks: none
+   :depth: 2
+   :class: singlecol
+
+Overview
+--------
+
+This page details steps for building your {+service+} application when using `Mac Catalyst <https://developer.apple.com/mac-catalyst/>`_.
+
+.. note::
+
+   Version 10.6.0 and above of the {+service+} React Native SDK supports Mac Catalyst.
+
+
+.. seealso::
+
+   :ref:`react-native-install`
+
+Procedure
+---------
+
+.. include:: /includes/steps/mac-catalyst.rst