fix: explicitly specify jsBundleAssetPath to fix loading of JS bundle in release mode on RN 0.81 & 0.82

[artus9033]

Summary

RN 0.81 & 0.82 have a bugged default value of the jsBundleAssetPath argument, which controls the filename to be loaded from asset://. By default, it is index, which is correct for Metro (dev mode) jsMainModulePath, but incorrect for asset bundle - it should be index.android.bundle.

The fix is present in RN upstream and included in 0.83 RC (facebook/react-native#53546), but has not been backported.

This PR passes the correct default value explicitly and also allows users to pass a custom value for this argument via the options HashMap.

Test plan

Run an app in release variant using an exported AAR & verify that the JS bundle is loaded and executed correctly.

---

Note

Explicitly sets jsBundleAssetPath (default index.android.bundle) in React host initialization and documents the option in Java/Kotlin guides.

• Android:
  • Update ReactNativeBrownfield.initialize(application, options, ...) to pass jsBundleAssetPath to getDefaultReactHost, defaulting to "index.android.bundle" and allowing override via options["bundleAssetPath"].
• Docs:
  • Clarify mainModuleName applies when loading from Metro.
  • Add jsBundleAssetPath option description for Java/Kotlin (docs/JAVA.md, docs/KOTLIN.md).

^{Written by Cursor Bugbot for commit ff9b047. This will update automatically on new commits. Configure here.}

[cursor]

This PR is being reviewed by Cursor Bugbot

Details

Your team is on the Bugbot Free tier. On this plan, Bugbot will review limited PRs each billing cycle for each member of your team.

To receive Bugbot reviews on all of your PRs, visit the Cursor dashboard to activate Pro and start your 14-day free trial.

[thymikee]

Good one