@dolami-inc/react-native-expo-unity 0.1.9 → 0.2.0

package/README.md

@@ -73,20 +73,38 @@ cp node_modules/@dolami-inc/react-native-expo-unity/plugin/NativeCallProxy.mm <U
 
 ### 2. Unity project — build iOS
 
+> 📹 **Video guide** (click to play):
+>
+> [![Xcode export settings](xcode-settings-thumb.jpg)](xcode-settings.mp4)
+
 1. Unity → File → Build Settings → iOS → Build
 2. Open generated Xcode project
 3. Select `NativeCallProxy.h` in Libraries/Plugins/iOS/
 4. Set Target Membership → `UnityFramework` → **Public**
-5. Build `UnityFramework` scheme
+5. **Select the `Data` folder** in the Project Navigator
+6. In the right panel under **Target Membership**, check **`UnityFramework`** ✅
+   > ⚠️ **This is critical.** Without this, the `Data` folder (which contains `global-metadata.dat` and all Unity assets) will NOT be included inside `UnityFramework.framework`. The app will crash at launch with: `Could not open .../global-metadata.dat — IL2CPP initialization failed`
+7. Build `UnityFramework` scheme
 
 ### 3. Copy build artifacts to your RN project
 
-Create `unity/builds/ios/` in your project root and copy all artifacts from your Unity iOS build:
+Create `unity/builds/ios/` in your project root and copy the built framework and static libraries:
 
 ```bash
 mkdir -p unity/builds/ios
-cp -R <unity-build>/UnityFramework.framework unity/builds/ios/
-cp <unity-build>/*.a unity/builds/ios/
+
+# Copy the compiled framework (should already contain Data/ inside after step 2.6)
+cp -R <xcode-build-output>/UnityFramework.framework unity/builds/ios/
+
+# Copy static libraries from the Unity Xcode project root
+cp <unity-xcode-project>/*.a unity/builds/ios/
+```
+
+Verify that `Data/` exists inside the framework:
+
+```bash
+ls unity/builds/ios/UnityFramework.framework/Data
+# Should show: Managed/  Resources/  etc.
 ```
 
 The podspec references these files **directly by path** — nothing is copied or embedded into the npm package. Updating your Unity build is as simple as replacing the contents of `unity/builds/ios/` and re-running `pod install`.

package/app.plugin.js

@@ -6,8 +6,8 @@ const fs = require('fs');
  * Expo Config Plugin for @dolami-inc/react-native-expo-unity.
  *
  * - Injects required Xcode build settings (bitcode, C++17)
- * - Embeds UnityFramework.framework into the app bundle so it's
- *   available at runtime (Unity ships as a dynamic framework)
+ * - Adds a build phase that embeds UnityFramework.framework into the app
+ *   bundle at build time (device builds only)
  *
  * @param {object} config - Expo config
  * @param {{ unityPath?: string }} options
@@ -20,7 +20,6 @@ const withExpoUnity = (config, options = {}) => {
     const xcodeProject = config.modResults;
     const projectRoot = config.modRequest.projectRoot;
 
-    // Resolve actual filesystem path for the Unity build artifacts.
     const unityPath =
       options.unityPath ||
       process.env.EXPO_UNITY_PATH ||
@@ -33,27 +32,43 @@ const withExpoUnity = (config, options = {}) => {
       if (typeof configuration !== 'object' || !configuration.buildSettings) {
         continue;
       }
-
       const settings = configuration.buildSettings;
-
-      // Unity as a Library does not support bitcode.
       settings['ENABLE_BITCODE'] = 'NO';
-
-      // Unity headers require C++17.
-      // Must be quoted — '+' causes CocoaPods' plist parser to fail if unquoted.
       settings['CLANG_CXX_LANGUAGE_STANDARD'] = '"c++17"';
     }
 
-    // -- Embed UnityFramework --
-    // UnityFramework is a dynamic framework. It must be embedded (copied) into
-    // the app bundle's Frameworks/ directory, otherwise dyld fails at launch.
-    const frameworkPath = path.join(unityPath, 'UnityFramework.framework');
-    if (fs.existsSync(frameworkPath)) {
-      xcodeProject.addFramework(frameworkPath, {
-        customFramework: true,
-        embed: true,
-        sign: true,
-      });
+    // -- Embed UnityFramework via build script phase --
+    // UnityFramework is a dynamic framework that must be embedded (copied)
+    // into the app bundle's Frameworks/ directory, otherwise dyld fails at
+    // launch. We use a shell script build phase instead of vendored_frameworks
+    // because the pod source may live in a read-only package manager cache.
+    const frameworkSrc = path.join(unityPath, 'UnityFramework.framework');
+    if (fs.existsSync(frameworkSrc)) {
+      const target = xcodeProject.getFirstTarget();
+
+      // Shell script that copies and codesigns the framework (device only).
+      const script = [
+        'if [ "${PLATFORM_NAME}" = "iphoneos" ]; then',
+        '  FRAMEWORK_SRC="' + frameworkSrc + '"',
+        '  DEST="${BUILT_PRODUCTS_DIR}/${FRAMEWORKS_FOLDER_PATH}"',
+        '  mkdir -p "${DEST}"',
+        '  rsync -av --delete "${FRAMEWORK_SRC}" "${DEST}/"',
+        '  if [ -n "${EXPANDED_CODE_SIGN_IDENTITY}" ]; then',
+        '    codesign --force --sign "${EXPANDED_CODE_SIGN_IDENTITY}" "${DEST}/UnityFramework.framework"',
+        '  fi',
+        'fi',
+      ].join('\n');
+
+      xcodeProject.addBuildPhase(
+        [],
+        'PBXShellScriptBuildPhase',
+        'Embed UnityFramework',
+        target.uuid,
+        {
+          shellPath: '/bin/sh',
+          shellScript: script,
+        }
+      );
     }
 
     return config;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dolami-inc/react-native-expo-unity",
-  "version": "0.1.9",
+  "version": "0.2.0",
   "description": "Unity as a Library (UaaL) bridge for React Native / Expo",
   "main": "src/index.ts",
   "types": "src/index.ts",