From ba2a26fd9801f6cef84e403617d2a3ebe2dc865f Mon Sep 17 00:00:00 2001
From: David Rifkin <50370157+davidlawrencer@users.noreply.github.com>
Date: Wed, 27 Nov 2024 16:29:06 -0600
Subject: [PATCH] Update configure-embrace-ios.md (#103)

---
 docs/unity/integration/configure-embrace-ios.md | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/docs/unity/integration/configure-embrace-ios.md b/docs/unity/integration/configure-embrace-ios.md
index 2167c0ee..ad237dc7 100644
--- a/docs/unity/integration/configure-embrace-ios.md
+++ b/docs/unity/integration/configure-embrace-ios.md
@@ -8,7 +8,7 @@ sidebar_position: 3
 
 The Embrace Unity SDK includes an editor script to assist with properly linking the SDK, and collecting and uploading debug information for symbolication. That component requires configuration prior to building. If your project ships on both Android and iOS make sure to configure both platforms using the Embrace editor window.
 
-# Configure the iOS platform
+## Configure the iOS platform
 
 Go to Tools -> Embrace -> Getting Started and click on it to reveal the Embrace editor window. Select the iOS tab and fill in the missing `App ID` and `Symbol Upload API Token`. You can get the correct values from the settings page in your dash.
 
@@ -23,6 +23,12 @@ Embrace.Instance.StartSDK(args);
 
 Now when you build and run your project, our editor script will use those values to correctly setup the final IPA to work with Embrace.
 
+## Known Issues
+
+Our Apple SDK and the Unity iOS SDK use Swift, which has a known issue with the current Unity build pipeline. To handle this issue, after creating your XCode project, add a Dummy Swift file to the UnityFramework target. This will adjust the linker pipeline to invoke Swift appropriately.
+
+For further information, please refer to this discussion: https://github.com/CocoaPods/CocoaPods/issues/11960
+
 ---
 
 In the next section, we'll learn how to configure the Android Platform.