From 2184d89358ece4b50c17c5c6a54b1d7fdc56a2ce Mon Sep 17 00:00:00 2001 From: Cedric Guillemet <1312968+CedricGuillemet@users.noreply.github.com> Date: Wed, 21 Oct 2026 16:16:31 +0200 Subject: [PATCH 1/6] Pin Babylon Native fork NativeXr EndFrame fix Use CedricGuillemet/BabylonNative nativexr-endframe-fix at b85d4f0b3c0735ee7c8318188095a2b78d4df2ad for staging package builds. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: 06586ce7-bc10-46c1-83b5-3334fc60600d --- Package/gulpfile.js | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/Package/gulpfile.js b/Package/gulpfile.js index 38a78b1e0..6513da3a8 100644 --- a/Package/gulpfile.js +++ b/Package/gulpfile.js @@ -253,8 +253,8 @@ const createPackage = async () => { exec('npm pack', 'Assembled'); }; -const COMMIT_ID = 'f4d9efbeeabcfec24105373b99e54fe147669fc1'; -const ZIP_URL = `https://github.com/BabylonJS/BabylonNative/archive/${COMMIT_ID}.zip`; +const COMMIT_ID = 'b85d4f0b3c0735ee7c8318188095a2b78d4df2ad'; +const ZIP_URL = `https://github.com/CedricGuillemet/BabylonNative/archive/${COMMIT_ID}.zip`; const TARGET_DIR = path.resolve(__dirname, '../Modules/@babylonjs/react-native/shared/BabylonNative'); const ZIP_PATH = path.join(TARGET_DIR, `${COMMIT_ID}.zip`); const UNZIP_FOLDER = path.join(TARGET_DIR, `Repo`); From f661dbb28f9c35cf7730355e8d0f98f2e904cd4e Mon Sep 17 00:00:00 2001 From: Cedric Guillemet <1312968+CedricGuillemet@users.noreply.github.com> Date: Thu, 22 Oct 2026 09:27:50 +0200 Subject: [PATCH 2/6] Pin merged Babylon Native EndFrame fix Use upstream BabylonNative commit 37d30f54649543290ad25c6c3626c247c1372773, the merged fix from BabylonJS/BabylonNative#1957. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: 06586ce7-bc10-46c1-83b5-3334fc60600d --- Package/gulpfile.js | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/Package/gulpfile.js b/Package/gulpfile.js index 6513da3a8..349458480 100644 --- a/Package/gulpfile.js +++ b/Package/gulpfile.js @@ -253,8 +253,8 @@ const createPackage = async () => { exec('npm pack', 'Assembled'); }; -const COMMIT_ID = 'b85d4f0b3c0735ee7c8318188095a2b78d4df2ad'; -const ZIP_URL = `https://github.com/CedricGuillemet/BabylonNative/archive/${COMMIT_ID}.zip`; +const COMMIT_ID = '37d30f54649543290ad25c6c3626c247c1372773'; +const ZIP_URL = `https://github.com/BabylonJS/BabylonNative/archive/${COMMIT_ID}.zip`; const TARGET_DIR = path.resolve(__dirname, '../Modules/@babylonjs/react-native/shared/BabylonNative'); const ZIP_PATH = path.join(TARGET_DIR, `${COMMIT_ID}.zip`); const UNZIP_FOLDER = path.join(TARGET_DIR, `Repo`); From 7ac515855ffa6791ece70246d41b0698b739bdf3 Mon Sep 17 00:00:00 2001 From: Cedric Guillemet <1312968+CedricGuillemet@users.noreply.github.com> Date: Thu, 22 Oct 2026 09:52:44 +0200 Subject: [PATCH 3/6] Document 2.0.8 preview and merged NativeXr fix Keep 2.0.7 identified as the latest stable release, document the 2.0.8 preview source pin and unchanged compatibility baselines, and leave release version assignment to the existing publishing workflow. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: 06586ce7-bc10-46c1-83b5-3334fc60600d --- Modules/@babylonjs/react-native/README.md | 14 ++++++++++---- README.md | 5 ++++- 2 files changed, 14 insertions(+), 5 deletions(-) diff --git a/Modules/@babylonjs/react-native/README.md b/Modules/@babylonjs/react-native/README.md index e7ba4869f..3b0aaac86 100644 --- a/Modules/@babylonjs/react-native/README.md +++ b/Modules/@babylonjs/react-native/README.md @@ -18,6 +18,8 @@ Use the React version required by your React Native application. React Native 0. To load formats such as glTF, also install `@babylonjs/loaders` at the same version as `@babylonjs/core` and import it in your application. +**2.0.8 is the next preview target, not a published stable release.** It includes the NativeXr EndFrame lifecycle fix described below. Preview publishing assigns the exact prerelease version; use that published version when testing rather than assuming the `preview` npm tag already contains 2.0.8. + ### Dependencies The package declares `@babylonjs/core` (>=9.0.0), `react`, `react-native`, and `react-native-permissions` (>=3.0.0) as **peer dependencies**. Add them to your application and resolve any peer dependency errors or warnings during installation. @@ -28,21 +30,23 @@ The native camera and XR plugins can be [disabled at build time](#plugins-select ### Supported Versions -These are the resolved React Native versions in the committed Playground lockfiles at each release tag, not the lower bounds of manifest ranges. The permissive `react` and `react-native` peer dependency ranges do **not** guarantee that every newer React Native version is compatible. +These are the resolved React Native versions in the committed Playground lockfiles at each release tag (or the preview branch for the unreleased 2.0.8 target), not the lower bounds of manifest ranges. The permissive `react` and `react-native` peer dependency ranges do **not** guarantee that every newer React Native version is compatible. | Babylon React Native version | React Native (iOS / Android) | React Native Windows | | ---------------------------- | --------------------------- | -------------------- | +| 2.0.8 (preview target) | 0.81.6 | 0.81.35 | | 2.0.7 / master | 0.81.6 | 0.81.35 | | 2.0.6 | 0.81.6 | 0.81.35 | | 2.0.5 | 0.81.6 | 0.81.21 | | 2.0.0 - 2.0.4 | 0.79.4 | 0.79.1 | -For 2.0.6 and 2.0.7, the Windows Playground locks React Native 0.81.6 with **React Native Windows pinned to 0.81.35** to match the published NuGet packages; 0.81.4 is only the lower bound of the manifest's `^0.81.4` React Native range. Windows project generation uses the legacy renderer and Hermes. +For 2.0.6, 2.0.7, and the 2.0.8 preview target, the Windows Playground locks React Native 0.81.6 with **React Native Windows pinned to 0.81.35** to match the published NuGet packages; 0.81.4 is only the lower bound of the manifest's `^0.81.4` React Native range. Windows project generation uses the legacy renderer and Hermes. -The Babylon.js column below records the package's `@babylonjs/core` peer dependency. The Babylon Native commits are the source pins in `Package/gulpfile.js` at the corresponding release tags. +The Babylon.js column below records the package's `@babylonjs/core` peer dependency. The Babylon Native commits are the source pins in `Package/gulpfile.js` at the corresponding release tags (or the preview branch for the unreleased 2.0.8 target). | Babylon React Native version | Babylon.js peer dependency | Babylon Native commit | | ---------------------------- | -------------------------- | --------------------- | +| 2.0.8 (preview target) | >=9.0.0 | [37d30f54649543290ad25c6c3626c247c1372773](https://github.com/BabylonJS/BabylonNative/commit/37d30f54649543290ad25c6c3626c247c1372773) | | 2.0.7 / master | >=9.0.0 | [f4d9efbeeabcfec24105373b99e54fe147669fc1](https://github.com/BabylonJS/BabylonNative/commit/f4d9efbeeabcfec24105373b99e54fe147669fc1) | | 2.0.6 | >=9.0.0 | [feb0227be8890ec5dcd28c6bfc18275a98bf8d45](https://github.com/BabylonJS/BabylonNative/commit/feb0227be8890ec5dcd28c6bfc18275a98bf8d45) | | 2.0.5 | >=9.0.0 | [ce2edf0851e0c8483559832a4f8eb9d39c6b2f53](https://github.com/BabylonJS/BabylonNative/commit/ce2edf0851e0c8483559832a4f8eb9d39c6b2f53) | @@ -52,6 +56,8 @@ The Babylon.js column below records the package's `@babylonjs/core` peer depende | 2.0.1 | >=5.53.1 | [3ccba7a6f741705ce611819aefacbbb8062393e7](https://github.com/BabylonJS/BabylonNative/commit/3ccba7a6f741705ce611819aefacbbb8062393e7) | | 2.0.0 | >=5.53.1 | [9a50d722d493524e1b315dd48fed6b0ed6d062c8](https://github.com/BabylonJS/BabylonNative/commit/9a50d722d493524e1b315dd48fed6b0ed6d062c8) | +The 2.0.8 preview target updates Babylon Native to include the [NativeXr EndFrame lifecycle fix](https://github.com/BabylonJS/BabylonNative/pull/1957). It queues EndFrame during FrameStart, preventing a late EndFrame call from consuming the next frame and causing a null-frame assertion. The Babylon.js and React Native baselines are unchanged from 2.0.7. + 2.0.7 updates Babylon Native and its JsRuntimeHost dependency, and removes obsolete `minz` library links from the iOS podspec and Windows project. The Babylon.js and React Native baselines are unchanged from 2.0.6. See the [release notes](https://github.com/BabylonJS/BabylonReactNative/releases) for changes and the [repository README](https://github.com/BabylonJS/BabylonReactNative#contributing) for local development and packaging instructions. @@ -138,7 +144,7 @@ Keep the variables set when running `pod install` and native builds. Disabling p ### Windows Configuration -Windows support is experimental. The 2.0.6 and 2.0.7 integrations use React Native Windows **0.81.35** and its matching NuGet packages. Keep the React Native Windows npm version aligned with its published NuGet version rather than allowing npm to select a newer release independently. +Windows support is experimental. The 2.0.6, 2.0.7, and 2.0.8 preview integrations use React Native Windows **0.81.35** and its matching NuGet packages. Keep the React Native Windows npm version aligned with its published NuGet version rather than allowing npm to select a newer release independently. The module's MSBuild project builds the embedded Babylon Native sources using CMake and the React Native Windows project's generated C++/WinRT projections. See the [repository's Windows instructions](https://github.com/BabylonJS/BabylonReactNative#universal-windows-platform-uwp) and [packaged-consumer build workflow](https://github.com/BabylonJS/BabylonReactNative/blob/master/.github/workflows/test_windows.yml) for the current UWP, legacy-renderer, NuGet, and C++20 configuration. diff --git a/README.md b/README.md index de563b0d9..cf7907a9d 100644 --- a/README.md +++ b/README.md @@ -29,14 +29,17 @@ Babylon React Native uses JSI for direct synchronous communication between nativ The latest stable npm release is **[@babylonjs/react-native 2.0.7](https://www.npmjs.com/package/@babylonjs/react-native/v/2.0.7)**. Since 2.0.0, a single package contains the sources for Android, iOS, and Windows; separate platform packages are no longer needed. +**2.0.8 is the next preview target, not a published stable release.** It updates Babylon Native to [37d30f54649543290ad25c6c3626c247c1372773](https://github.com/BabylonJS/BabylonNative/commit/37d30f54649543290ad25c6c3626c247c1372773), including the [NativeXr EndFrame lifecycle fix](https://github.com/BabylonJS/BabylonNative/pull/1957) that prevents EndFrame from being queued a frame late and hitting a null-frame assertion. The Babylon.js and React Native baselines are unchanged from 2.0.7. + 2.0.7 updates Babylon Native to [f4d9efbeeabcfec24105373b99e54fe147669fc1](https://github.com/BabylonJS/BabylonNative/commit/f4d9efbeeabcfec24105373b99e54fe147669fc1), including its JsRuntimeHost dependency update, and removes obsolete `minz` library links from the iOS and Windows builds. The Babylon.js and React Native baselines are unchanged from 2.0.6. | Package version | Babylon.js peer dependency | React Native (Android / iOS) | React Native Windows | | --------------- | -------------------------- | ---------------------------- | -------------------- | +| 2.0.8 (preview target) | >=9.0.0 | 0.81.6 | 0.81.35 | | 2.0.7 / master | >=9.0.0 | 0.81.6 | 0.81.35 | | 2.0.6 | >=9.0.0 | 0.81.6 | 0.81.35 | -The React Native versions above are the resolved Playground lockfile baselines, not a guarantee of compatibility with every newer release. For 2.0.6 and 2.0.7, the Windows Playground locks React Native 0.81.6 with React Native Windows 0.81.35; 0.81.4 is only the lower bound of the manifest's `^0.81.4` React Native range. Windows support remains experimental; its npm version is pinned to match the published React Native Windows NuGet packages. +The React Native versions above are the resolved Playground lockfile baselines, not a guarantee of compatibility with every newer release. For 2.0.6, 2.0.7, and the 2.0.8 preview target, the Windows Playground locks React Native 0.81.6 with React Native Windows 0.81.35; 0.81.4 is only the lower bound of the manifest's `^0.81.4` React Native range. Windows support remains experimental; its npm version is pinned to match the published React Native Windows NuGet packages. See the [package README](Modules/@babylonjs/react-native/README.md#supported-versions) for earlier releases and the Babylon Native commit used by each release, and the [release notes](https://github.com/BabylonJS/BabylonReactNative/releases) for changes. From 201bb65e240b2239a32d365c406ed4ce879962e1 Mon Sep 17 00:00:00 2001 From: Cedric Guillemet <1312968+CedricGuillemet@users.noreply.github.com> Date: Thu, 22 Oct 2026 17:05:45 +0200 Subject: [PATCH 4/6] Prepare READMEs for stable 2.0.8 release Replace preview-target framing with planned stable 2.0.8 release notes, preserving the tested Babylon Native pin and compatibility baselines without claiming publication. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: 06586ce7-bc10-46c1-83b5-3334fc60600d --- Modules/@babylonjs/react-native/README.md | 16 ++++++++-------- README.md | 6 +++--- 2 files changed, 11 insertions(+), 11 deletions(-) diff --git a/Modules/@babylonjs/react-native/README.md b/Modules/@babylonjs/react-native/README.md index 3b0aaac86..2c5277576 100644 --- a/Modules/@babylonjs/react-native/README.md +++ b/Modules/@babylonjs/react-native/README.md @@ -18,7 +18,7 @@ Use the React version required by your React Native application. React Native 0. To load formats such as glTF, also install `@babylonjs/loaders` at the same version as `@babylonjs/core` and import it in your application. -**2.0.8 is the next preview target, not a published stable release.** It includes the NativeXr EndFrame lifecycle fix described below. Preview publishing assigns the exact prerelease version; use that published version when testing rather than assuming the `preview` npm tag already contains 2.0.8. +**2.0.8 is being prepared as the next stable release; it is not yet published as stable.** It includes the NativeXr EndFrame lifecycle fix described below. Until it is published, the stable installation command above continues to use 2.0.7. ### Dependencies @@ -30,23 +30,23 @@ The native camera and XR plugins can be [disabled at build time](#plugins-select ### Supported Versions -These are the resolved React Native versions in the committed Playground lockfiles at each release tag (or the preview branch for the unreleased 2.0.8 target), not the lower bounds of manifest ranges. The permissive `react` and `react-native` peer dependency ranges do **not** guarantee that every newer React Native version is compatible. +These are the resolved React Native versions in the committed Playground lockfiles at each release tag (or the release preparation branch for the planned 2.0.8 release), not the lower bounds of manifest ranges. The permissive `react` and `react-native` peer dependency ranges do **not** guarantee that every newer React Native version is compatible. | Babylon React Native version | React Native (iOS / Android) | React Native Windows | | ---------------------------- | --------------------------- | -------------------- | -| 2.0.8 (preview target) | 0.81.6 | 0.81.35 | +| 2.0.8 (planned) | 0.81.6 | 0.81.35 | | 2.0.7 / master | 0.81.6 | 0.81.35 | | 2.0.6 | 0.81.6 | 0.81.35 | | 2.0.5 | 0.81.6 | 0.81.21 | | 2.0.0 - 2.0.4 | 0.79.4 | 0.79.1 | -For 2.0.6, 2.0.7, and the 2.0.8 preview target, the Windows Playground locks React Native 0.81.6 with **React Native Windows pinned to 0.81.35** to match the published NuGet packages; 0.81.4 is only the lower bound of the manifest's `^0.81.4` React Native range. Windows project generation uses the legacy renderer and Hermes. +For 2.0.6, 2.0.7, and the planned 2.0.8 release, the Windows Playground locks React Native 0.81.6 with **React Native Windows pinned to 0.81.35** to match the published NuGet packages; 0.81.4 is only the lower bound of the manifest's `^0.81.4` React Native range. Windows project generation uses the legacy renderer and Hermes. -The Babylon.js column below records the package's `@babylonjs/core` peer dependency. The Babylon Native commits are the source pins in `Package/gulpfile.js` at the corresponding release tags (or the preview branch for the unreleased 2.0.8 target). +The Babylon.js column below records the package's `@babylonjs/core` peer dependency. The Babylon Native commits are the source pins in `Package/gulpfile.js` at the corresponding release tags (or the release preparation branch for the planned 2.0.8 release). | Babylon React Native version | Babylon.js peer dependency | Babylon Native commit | | ---------------------------- | -------------------------- | --------------------- | -| 2.0.8 (preview target) | >=9.0.0 | [37d30f54649543290ad25c6c3626c247c1372773](https://github.com/BabylonJS/BabylonNative/commit/37d30f54649543290ad25c6c3626c247c1372773) | +| 2.0.8 (planned) | >=9.0.0 | [37d30f54649543290ad25c6c3626c247c1372773](https://github.com/BabylonJS/BabylonNative/commit/37d30f54649543290ad25c6c3626c247c1372773) | | 2.0.7 / master | >=9.0.0 | [f4d9efbeeabcfec24105373b99e54fe147669fc1](https://github.com/BabylonJS/BabylonNative/commit/f4d9efbeeabcfec24105373b99e54fe147669fc1) | | 2.0.6 | >=9.0.0 | [feb0227be8890ec5dcd28c6bfc18275a98bf8d45](https://github.com/BabylonJS/BabylonNative/commit/feb0227be8890ec5dcd28c6bfc18275a98bf8d45) | | 2.0.5 | >=9.0.0 | [ce2edf0851e0c8483559832a4f8eb9d39c6b2f53](https://github.com/BabylonJS/BabylonNative/commit/ce2edf0851e0c8483559832a4f8eb9d39c6b2f53) | @@ -56,7 +56,7 @@ The Babylon.js column below records the package's `@babylonjs/core` peer depende | 2.0.1 | >=5.53.1 | [3ccba7a6f741705ce611819aefacbbb8062393e7](https://github.com/BabylonJS/BabylonNative/commit/3ccba7a6f741705ce611819aefacbbb8062393e7) | | 2.0.0 | >=5.53.1 | [9a50d722d493524e1b315dd48fed6b0ed6d062c8](https://github.com/BabylonJS/BabylonNative/commit/9a50d722d493524e1b315dd48fed6b0ed6d062c8) | -The 2.0.8 preview target updates Babylon Native to include the [NativeXr EndFrame lifecycle fix](https://github.com/BabylonJS/BabylonNative/pull/1957). It queues EndFrame during FrameStart, preventing a late EndFrame call from consuming the next frame and causing a null-frame assertion. The Babylon.js and React Native baselines are unchanged from 2.0.7. +2.0.8 updates Babylon Native to include the [NativeXr EndFrame lifecycle fix](https://github.com/BabylonJS/BabylonNative/pull/1957). It queues EndFrame during FrameStart, preventing a late EndFrame call from consuming the next frame and causing a null-frame assertion. The Babylon.js and React Native baselines are unchanged from 2.0.7. 2.0.7 updates Babylon Native and its JsRuntimeHost dependency, and removes obsolete `minz` library links from the iOS podspec and Windows project. The Babylon.js and React Native baselines are unchanged from 2.0.6. @@ -144,7 +144,7 @@ Keep the variables set when running `pod install` and native builds. Disabling p ### Windows Configuration -Windows support is experimental. The 2.0.6, 2.0.7, and 2.0.8 preview integrations use React Native Windows **0.81.35** and its matching NuGet packages. Keep the React Native Windows npm version aligned with its published NuGet version rather than allowing npm to select a newer release independently. +Windows support is experimental. The 2.0.6 and 2.0.7 integrations and the planned 2.0.8 release use React Native Windows **0.81.35** and its matching NuGet packages. Keep the React Native Windows npm version aligned with its published NuGet version rather than allowing npm to select a newer release independently. The module's MSBuild project builds the embedded Babylon Native sources using CMake and the React Native Windows project's generated C++/WinRT projections. See the [repository's Windows instructions](https://github.com/BabylonJS/BabylonReactNative#universal-windows-platform-uwp) and [packaged-consumer build workflow](https://github.com/BabylonJS/BabylonReactNative/blob/master/.github/workflows/test_windows.yml) for the current UWP, legacy-renderer, NuGet, and C++20 configuration. diff --git a/README.md b/README.md index cf7907a9d..70e691850 100644 --- a/README.md +++ b/README.md @@ -29,17 +29,17 @@ Babylon React Native uses JSI for direct synchronous communication between nativ The latest stable npm release is **[@babylonjs/react-native 2.0.7](https://www.npmjs.com/package/@babylonjs/react-native/v/2.0.7)**. Since 2.0.0, a single package contains the sources for Android, iOS, and Windows; separate platform packages are no longer needed. -**2.0.8 is the next preview target, not a published stable release.** It updates Babylon Native to [37d30f54649543290ad25c6c3626c247c1372773](https://github.com/BabylonJS/BabylonNative/commit/37d30f54649543290ad25c6c3626c247c1372773), including the [NativeXr EndFrame lifecycle fix](https://github.com/BabylonJS/BabylonNative/pull/1957) that prevents EndFrame from being queued a frame late and hitting a null-frame assertion. The Babylon.js and React Native baselines are unchanged from 2.0.7. +**2.0.8 is being prepared as the next stable release; it is not yet published as stable.** It updates Babylon Native to [37d30f54649543290ad25c6c3626c247c1372773](https://github.com/BabylonJS/BabylonNative/commit/37d30f54649543290ad25c6c3626c247c1372773), including the [NativeXr EndFrame lifecycle fix](https://github.com/BabylonJS/BabylonNative/pull/1957) that prevents EndFrame from being queued a frame late and hitting a null-frame assertion. The Babylon.js and React Native baselines are unchanged from 2.0.7. 2.0.7 updates Babylon Native to [f4d9efbeeabcfec24105373b99e54fe147669fc1](https://github.com/BabylonJS/BabylonNative/commit/f4d9efbeeabcfec24105373b99e54fe147669fc1), including its JsRuntimeHost dependency update, and removes obsolete `minz` library links from the iOS and Windows builds. The Babylon.js and React Native baselines are unchanged from 2.0.6. | Package version | Babylon.js peer dependency | React Native (Android / iOS) | React Native Windows | | --------------- | -------------------------- | ---------------------------- | -------------------- | -| 2.0.8 (preview target) | >=9.0.0 | 0.81.6 | 0.81.35 | +| 2.0.8 (planned) | >=9.0.0 | 0.81.6 | 0.81.35 | | 2.0.7 / master | >=9.0.0 | 0.81.6 | 0.81.35 | | 2.0.6 | >=9.0.0 | 0.81.6 | 0.81.35 | -The React Native versions above are the resolved Playground lockfile baselines, not a guarantee of compatibility with every newer release. For 2.0.6, 2.0.7, and the 2.0.8 preview target, the Windows Playground locks React Native 0.81.6 with React Native Windows 0.81.35; 0.81.4 is only the lower bound of the manifest's `^0.81.4` React Native range. Windows support remains experimental; its npm version is pinned to match the published React Native Windows NuGet packages. +The React Native versions above are the resolved Playground lockfile baselines, not a guarantee of compatibility with every newer release. For 2.0.6, 2.0.7, and the planned 2.0.8 release, the Windows Playground locks React Native 0.81.6 with React Native Windows 0.81.35; 0.81.4 is only the lower bound of the manifest's `^0.81.4` React Native range. Windows support remains experimental; its npm version is pinned to match the published React Native Windows NuGet packages. See the [package README](Modules/@babylonjs/react-native/README.md#supported-versions) for earlier releases and the Babylon Native commit used by each release, and the [release notes](https://github.com/BabylonJS/BabylonReactNative/releases) for changes. From c75203cc63a0e30a16620f2ba3bbc073352ff499 Mon Sep 17 00:00:00 2001 From: Cedric Guillemet <1312968+CedricGuillemet@users.noreply.github.com> Date: Mon, 26 Oct 2026 09:37:22 +0100 Subject: [PATCH 5/6] Document 2.0.8 as the current stable release Update installation guidance and compatibility tables for released 2.0.8, removing release-preparation wording while preserving the tested Babylon Native pin and compatibility baselines. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: 06586ce7-bc10-46c1-83b5-3334fc60600d --- Modules/@babylonjs/react-native/README.md | 22 +++++++++++----------- README.md | 10 +++++----- 2 files changed, 16 insertions(+), 16 deletions(-) diff --git a/Modules/@babylonjs/react-native/README.md b/Modules/@babylonjs/react-native/README.md index 2c5277576..73864453b 100644 --- a/Modules/@babylonjs/react-native/README.md +++ b/Modules/@babylonjs/react-native/README.md @@ -8,17 +8,17 @@ This quick overview will help you understand the constructs provided by Babylon ### Installation -The latest stable release is **2.0.7**. In an existing React Native application using the [versions below](#supported-versions), install the package and its peer dependencies: +The latest stable release is **2.0.8**. In an existing React Native application using the [versions below](#supported-versions), install the package and its peer dependencies: ```sh -npm install @babylonjs/react-native@2.0.7 @babylonjs/core@^9.0.0 react-native-permissions@^5.4.1 +npm install @babylonjs/react-native@2.0.8 @babylonjs/core@^9.0.0 react-native-permissions@^5.4.1 ``` Use the React version required by your React Native application. React Native 0.81 requires **Node.js 20.19.4 or later**. Follow the platform configuration below before building the app. To load formats such as glTF, also install `@babylonjs/loaders` at the same version as `@babylonjs/core` and import it in your application. -**2.0.8 is being prepared as the next stable release; it is not yet published as stable.** It includes the NativeXr EndFrame lifecycle fix described below. Until it is published, the stable installation command above continues to use 2.0.7. +2.0.8 includes the NativeXr EndFrame lifecycle fix described below. ### Dependencies @@ -30,24 +30,24 @@ The native camera and XR plugins can be [disabled at build time](#plugins-select ### Supported Versions -These are the resolved React Native versions in the committed Playground lockfiles at each release tag (or the release preparation branch for the planned 2.0.8 release), not the lower bounds of manifest ranges. The permissive `react` and `react-native` peer dependency ranges do **not** guarantee that every newer React Native version is compatible. +These are the resolved React Native versions in the committed Playground lockfiles at each release tag, not the lower bounds of manifest ranges. The permissive `react` and `react-native` peer dependency ranges do **not** guarantee that every newer React Native version is compatible. | Babylon React Native version | React Native (iOS / Android) | React Native Windows | | ---------------------------- | --------------------------- | -------------------- | -| 2.0.8 (planned) | 0.81.6 | 0.81.35 | -| 2.0.7 / master | 0.81.6 | 0.81.35 | +| 2.0.8 / master | 0.81.6 | 0.81.35 | +| 2.0.7 | 0.81.6 | 0.81.35 | | 2.0.6 | 0.81.6 | 0.81.35 | | 2.0.5 | 0.81.6 | 0.81.21 | | 2.0.0 - 2.0.4 | 0.79.4 | 0.79.1 | -For 2.0.6, 2.0.7, and the planned 2.0.8 release, the Windows Playground locks React Native 0.81.6 with **React Native Windows pinned to 0.81.35** to match the published NuGet packages; 0.81.4 is only the lower bound of the manifest's `^0.81.4` React Native range. Windows project generation uses the legacy renderer and Hermes. +For 2.0.6 through 2.0.8, the Windows Playground locks React Native 0.81.6 with **React Native Windows pinned to 0.81.35** to match the published NuGet packages; 0.81.4 is only the lower bound of the manifest's `^0.81.4` React Native range. Windows project generation uses the legacy renderer and Hermes. -The Babylon.js column below records the package's `@babylonjs/core` peer dependency. The Babylon Native commits are the source pins in `Package/gulpfile.js` at the corresponding release tags (or the release preparation branch for the planned 2.0.8 release). +The Babylon.js column below records the package's `@babylonjs/core` peer dependency. The Babylon Native commits are the source pins in `Package/gulpfile.js` at the corresponding release tags. | Babylon React Native version | Babylon.js peer dependency | Babylon Native commit | | ---------------------------- | -------------------------- | --------------------- | -| 2.0.8 (planned) | >=9.0.0 | [37d30f54649543290ad25c6c3626c247c1372773](https://github.com/BabylonJS/BabylonNative/commit/37d30f54649543290ad25c6c3626c247c1372773) | -| 2.0.7 / master | >=9.0.0 | [f4d9efbeeabcfec24105373b99e54fe147669fc1](https://github.com/BabylonJS/BabylonNative/commit/f4d9efbeeabcfec24105373b99e54fe147669fc1) | +| 2.0.8 / master | >=9.0.0 | [37d30f54649543290ad25c6c3626c247c1372773](https://github.com/BabylonJS/BabylonNative/commit/37d30f54649543290ad25c6c3626c247c1372773) | +| 2.0.7 | >=9.0.0 | [f4d9efbeeabcfec24105373b99e54fe147669fc1](https://github.com/BabylonJS/BabylonNative/commit/f4d9efbeeabcfec24105373b99e54fe147669fc1) | | 2.0.6 | >=9.0.0 | [feb0227be8890ec5dcd28c6bfc18275a98bf8d45](https://github.com/BabylonJS/BabylonNative/commit/feb0227be8890ec5dcd28c6bfc18275a98bf8d45) | | 2.0.5 | >=9.0.0 | [ce2edf0851e0c8483559832a4f8eb9d39c6b2f53](https://github.com/BabylonJS/BabylonNative/commit/ce2edf0851e0c8483559832a4f8eb9d39c6b2f53) | | 2.0.4 | >=9.0.0 | [ce2edf0851e0c8483559832a4f8eb9d39c6b2f53](https://github.com/BabylonJS/BabylonNative/commit/ce2edf0851e0c8483559832a4f8eb9d39c6b2f53) | @@ -144,7 +144,7 @@ Keep the variables set when running `pod install` and native builds. Disabling p ### Windows Configuration -Windows support is experimental. The 2.0.6 and 2.0.7 integrations and the planned 2.0.8 release use React Native Windows **0.81.35** and its matching NuGet packages. Keep the React Native Windows npm version aligned with its published NuGet version rather than allowing npm to select a newer release independently. +Windows support is experimental. The 2.0.6 through 2.0.8 integrations use React Native Windows **0.81.35** and its matching NuGet packages. Keep the React Native Windows npm version aligned with its published NuGet version rather than allowing npm to select a newer release independently. The module's MSBuild project builds the embedded Babylon Native sources using CMake and the React Native Windows project's generated C++/WinRT projections. See the [repository's Windows instructions](https://github.com/BabylonJS/BabylonReactNative#universal-windows-platform-uwp) and [packaged-consumer build workflow](https://github.com/BabylonJS/BabylonReactNative/blob/master/.github/workflows/test_windows.yml) for the current UWP, legacy-renderer, NuGet, and C++20 configuration. diff --git a/README.md b/README.md index 70e691850..afad15426 100644 --- a/README.md +++ b/README.md @@ -27,19 +27,19 @@ Babylon React Native uses JSI for direct synchronous communication between nativ ## Supported Versions -The latest stable npm release is **[@babylonjs/react-native 2.0.7](https://www.npmjs.com/package/@babylonjs/react-native/v/2.0.7)**. Since 2.0.0, a single package contains the sources for Android, iOS, and Windows; separate platform packages are no longer needed. +The latest stable npm release is **[@babylonjs/react-native 2.0.8](https://www.npmjs.com/package/@babylonjs/react-native/v/2.0.8)**. Since 2.0.0, a single package contains the sources for Android, iOS, and Windows; separate platform packages are no longer needed. -**2.0.8 is being prepared as the next stable release; it is not yet published as stable.** It updates Babylon Native to [37d30f54649543290ad25c6c3626c247c1372773](https://github.com/BabylonJS/BabylonNative/commit/37d30f54649543290ad25c6c3626c247c1372773), including the [NativeXr EndFrame lifecycle fix](https://github.com/BabylonJS/BabylonNative/pull/1957) that prevents EndFrame from being queued a frame late and hitting a null-frame assertion. The Babylon.js and React Native baselines are unchanged from 2.0.7. +2.0.8 updates Babylon Native to [37d30f54649543290ad25c6c3626c247c1372773](https://github.com/BabylonJS/BabylonNative/commit/37d30f54649543290ad25c6c3626c247c1372773), including the [NativeXr EndFrame lifecycle fix](https://github.com/BabylonJS/BabylonNative/pull/1957) that prevents EndFrame from being queued a frame late and hitting a null-frame assertion. The Babylon.js and React Native baselines are unchanged from 2.0.7. 2.0.7 updates Babylon Native to [f4d9efbeeabcfec24105373b99e54fe147669fc1](https://github.com/BabylonJS/BabylonNative/commit/f4d9efbeeabcfec24105373b99e54fe147669fc1), including its JsRuntimeHost dependency update, and removes obsolete `minz` library links from the iOS and Windows builds. The Babylon.js and React Native baselines are unchanged from 2.0.6. | Package version | Babylon.js peer dependency | React Native (Android / iOS) | React Native Windows | | --------------- | -------------------------- | ---------------------------- | -------------------- | -| 2.0.8 (planned) | >=9.0.0 | 0.81.6 | 0.81.35 | -| 2.0.7 / master | >=9.0.0 | 0.81.6 | 0.81.35 | +| 2.0.8 / master | >=9.0.0 | 0.81.6 | 0.81.35 | +| 2.0.7 | >=9.0.0 | 0.81.6 | 0.81.35 | | 2.0.6 | >=9.0.0 | 0.81.6 | 0.81.35 | -The React Native versions above are the resolved Playground lockfile baselines, not a guarantee of compatibility with every newer release. For 2.0.6, 2.0.7, and the planned 2.0.8 release, the Windows Playground locks React Native 0.81.6 with React Native Windows 0.81.35; 0.81.4 is only the lower bound of the manifest's `^0.81.4` React Native range. Windows support remains experimental; its npm version is pinned to match the published React Native Windows NuGet packages. +The React Native versions above are the resolved Playground lockfile baselines, not a guarantee of compatibility with every newer release. For 2.0.6 through 2.0.8, the Windows Playground locks React Native 0.81.6 with React Native Windows 0.81.35; 0.81.4 is only the lower bound of the manifest's `^0.81.4` React Native range. Windows support remains experimental; its npm version is pinned to match the published React Native Windows NuGet packages. See the [package README](Modules/@babylonjs/react-native/README.md#supported-versions) for earlier releases and the Babylon Native commit used by each release, and the [release notes](https://github.com/BabylonJS/BabylonReactNative/releases) for changes. From 293851b5fb1898d7f045822249377230cee00cfb Mon Sep 17 00:00:00 2001 From: Cedric Guillemet <1312968+CedricGuillemet@users.noreply.github.com> Date: Mon, 26 Oct 2026 09:43:12 +0100 Subject: [PATCH 6/6] Remove 2.0.8 bug-fix descriptions from READMEs Keep the current release, installation, compatibility and source-pin tables while removing NativeXr fix descriptions and bug PR links. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: 06586ce7-bc10-46c1-83b5-3334fc60600d --- Modules/@babylonjs/react-native/README.md | 4 ---- README.md | 2 -- 2 files changed, 6 deletions(-) diff --git a/Modules/@babylonjs/react-native/README.md b/Modules/@babylonjs/react-native/README.md index 73864453b..edff84d0b 100644 --- a/Modules/@babylonjs/react-native/README.md +++ b/Modules/@babylonjs/react-native/README.md @@ -18,8 +18,6 @@ Use the React version required by your React Native application. React Native 0. To load formats such as glTF, also install `@babylonjs/loaders` at the same version as `@babylonjs/core` and import it in your application. -2.0.8 includes the NativeXr EndFrame lifecycle fix described below. - ### Dependencies The package declares `@babylonjs/core` (>=9.0.0), `react`, `react-native`, and `react-native-permissions` (>=3.0.0) as **peer dependencies**. Add them to your application and resolve any peer dependency errors or warnings during installation. @@ -56,8 +54,6 @@ The Babylon.js column below records the package's `@babylonjs/core` peer depende | 2.0.1 | >=5.53.1 | [3ccba7a6f741705ce611819aefacbbb8062393e7](https://github.com/BabylonJS/BabylonNative/commit/3ccba7a6f741705ce611819aefacbbb8062393e7) | | 2.0.0 | >=5.53.1 | [9a50d722d493524e1b315dd48fed6b0ed6d062c8](https://github.com/BabylonJS/BabylonNative/commit/9a50d722d493524e1b315dd48fed6b0ed6d062c8) | -2.0.8 updates Babylon Native to include the [NativeXr EndFrame lifecycle fix](https://github.com/BabylonJS/BabylonNative/pull/1957). It queues EndFrame during FrameStart, preventing a late EndFrame call from consuming the next frame and causing a null-frame assertion. The Babylon.js and React Native baselines are unchanged from 2.0.7. - 2.0.7 updates Babylon Native and its JsRuntimeHost dependency, and removes obsolete `minz` library links from the iOS podspec and Windows project. The Babylon.js and React Native baselines are unchanged from 2.0.6. See the [release notes](https://github.com/BabylonJS/BabylonReactNative/releases) for changes and the [repository README](https://github.com/BabylonJS/BabylonReactNative#contributing) for local development and packaging instructions. diff --git a/README.md b/README.md index afad15426..56bb8d686 100644 --- a/README.md +++ b/README.md @@ -29,8 +29,6 @@ Babylon React Native uses JSI for direct synchronous communication between nativ The latest stable npm release is **[@babylonjs/react-native 2.0.8](https://www.npmjs.com/package/@babylonjs/react-native/v/2.0.8)**. Since 2.0.0, a single package contains the sources for Android, iOS, and Windows; separate platform packages are no longer needed. -2.0.8 updates Babylon Native to [37d30f54649543290ad25c6c3626c247c1372773](https://github.com/BabylonJS/BabylonNative/commit/37d30f54649543290ad25c6c3626c247c1372773), including the [NativeXr EndFrame lifecycle fix](https://github.com/BabylonJS/BabylonNative/pull/1957) that prevents EndFrame from being queued a frame late and hitting a null-frame assertion. The Babylon.js and React Native baselines are unchanged from 2.0.7. - 2.0.7 updates Babylon Native to [f4d9efbeeabcfec24105373b99e54fe147669fc1](https://github.com/BabylonJS/BabylonNative/commit/f4d9efbeeabcfec24105373b99e54fe147669fc1), including its JsRuntimeHost dependency update, and removes obsolete `minz` library links from the iOS and Windows builds. The Babylon.js and React Native baselines are unchanged from 2.0.6. | Package version | Babylon.js peer dependency | React Native (Android / iOS) | React Native Windows |