0.62.1 Release APK: Unable to load script. Make sure you're either running a Metro server
  • 07-May-2023
Lightrun Team
Author Lightrun Team
0.62.1 Release APK: Unable to load script. Make sure you're either running a Metro server

0.62.1 Release APK: Unable to load script. Make sure you’re either running a Metro server (run ‘react-native start’) or that your bundle ‘index.android.bundle’ is packaged correctly for release.

Lightrun Team
Lightrun Team

Explanation of the problem

This issue occurs when building an app for release on Android, where the build succeeds but launching the app generates a runtime error stating that the script cannot be loaded. This error message suggests that the app may not be packaged correctly for release, or that a Metro server is not running. The problem is reproducible, and other users have reported similar issues.

The build process is initiated by running the command “./gradlew assembleRelease” from within the “android” directory. However, the error suggests that the “index.android.bundle” file is not being packaged correctly. To resolve this issue, it is recommended to ensure that a Metro server is running and that the bundle is correctly packaged for release. The error message indicates that the app is unable to load the script, so this should be the focus of any potential solution.

The app’s “build.gradle” and “app/build.gradle” files, as well as the “package.json” and “index.js” files, are provided via links to GitHub gists. These files contain the configuration settings and dependencies required to build and run the app. Reviewing these files may provide insight into potential issues or conflicts that could be causing the runtime error. Additionally, the linked issue on the React Native GitHub repository contains potential solutions that other users have found to be successful in resolving similar issues.


Troubleshooting with the Lightrun Developer Observability Platform

Getting a sense of what’s actually happening inside a live application is a frustrating experience, one that relies mostly on querying and observing whatever logs were written during development.
Lightrun is a Developer Observability Platform, allowing developers to add telemetry to live applications in real-time, on-demand, and right from the IDE.

  • Instantly add logs to, set metrics in, and take snapshots of live applications
  • Insights delivered straight to your IDE or CLI
  • Works where you do: dev, QA, staging, CI/CD, and production

Start for free today

Problem solution for 0.62.1 Release APK: Unable to load script. Make sure you’re either running a Metro server (run ‘react-native start’) or that your bundle ‘index.android.bundle’ is packaged correctly for release.

If you are facing an issue where your React Native application’s Android build is failing to include the JavaScript bundle in the APK or AAB, there are a couple of workarounds that you can try. One solution is to manually run the command “npx react-native bundle” before each build, which creates the JavaScript bundle and places it in the appropriate directory. Then, you can run the “assembleRelease” command to build the APK or AAB. However, adding the “–assets-dest” option to the “react-native bundle” command can result in a duplicate assets error, so it’s best to skip that option.

Another workaround is to modify the “build.gradle” file in the “android/app” directory. Specifically, you can add a code snippet that forces the “copyReleaseBundledJs” task to run before the “merge assets into the apk” task. This ensures that the JavaScript bundle is copied to the assets directory before the assets are merged into the APK. Note that this solution may not work for more complex build variants.

It’s worth noting that these workarounds are necessary due to a task ordering issue with the Android Gradle plugin 4+. In some cases, the plugin may pick up all the assets before the JavaScript bundle has been copied to the appropriate directory, resulting in a build failure. While these solutions may not be ideal, they can help you overcome this issue and successfully build your React Native Android application.

Other popular problems with React Native Community CLI

Problem: Slow Build Times:

One of the most common complaints among React Native developers is slow build times. This can be caused by a variety of factors such as large project size, outdated hardware, and inefficient build processes. The slow build times can significantly impact developer productivity and lead to frustration.


There are several ways to mitigate slow build times in React Native projects. One approach is to optimize the project size by removing unused dependencies and optimizing the code. Another solution is to upgrade the development environment, including hardware and software, to ensure that it is able to handle the demands of the project. Additionally, implementing a faster build system, such as Fastlane, can also help speed up the build process.

Problem: Compatibility Issues with Native Modules

React Native uses native modules to access native functionality on different platforms. However, compatibility issues can arise when trying to use a module that was developed for one platform on another platform. This can result in unexpected behavior or errors.


One solution is to use a library that is well-maintained and widely used in the React Native community, as these libraries are more likely to be compatible across platforms. Another solution is to thoroughly test the native module on all target platforms before deployment to ensure that it is compatible. In some cases, it may also be necessary to modify the native module code to ensure compatibility.

Problem: Debugging Complex Issues

Debugging complex issues can be challenging in React Native, as the JavaScript code is executed on a separate thread from the native platform code. This can make it difficult to track down the source of a problem.


A number of tools and strategies can be used to help with debugging in React Native. For example, using the React Native Debugger and the React Developer Tools browser extension can provide additional insight into the React Native code. Additionally, logging information to the console and using remote debugging can also help to pinpoint the source of an issue. Regular code review and testing can also help to catch and prevent issues before they become problems.

A brief introduction to React Native Community CLI

React Native Community CLI is a command line interface tool for developing and building React Native applications. It provides developers with a set of commands and tools for creating, building, and deploying React Native projects, allowing them to streamline the development process and focus on writing code. The React Native Community CLI is designed to be flexible and customizable, allowing developers to configure their development environment to meet their specific needs.

The React Native Community CLI is built on top of the React Native framework and provides a number of benefits to developers. For example, it provides a simple and straightforward way to create new projects, manage dependencies, and run builds and tests. Additionally, it integrates with popular development tools, such as Xcode and Android Studio, making it easy to debug and deploy applications. The CLI also includes built-in support for popular React Native libraries and components, reducing the amount of time and effort required to set up a new project and get started with development.

Most popular use cases for React Native Community CLI

  1. Creating and Configuring React Native Projects: React Native Community CLI provides a convenient command line interface for creating new React Native projects, making it easy to get started with development. The CLI also provides a number of options for customizing the project configuration, allowing developers to specify the desired target platforms, project structure, and other settings.


react-native init MyApp
  1. Managing Dependencies and Packages: React Native Community CLI includes built-in support for managing dependencies and packages, including adding and removing packages, updating packages, and managing the project’s package.json file. This makes it easy to add and manage the libraries and components required for a project, ensuring that dependencies are up-to-date and consistent across different environments.


react-native add-package react-navigation
  1. Building and Deploying Applications: React Native Community CLI provides a set of commands for building and deploying React Native applications, making it easy to compile the code and generate the required binary files for distribution. The CLI also provides options for specifying the target platform and release channel, allowing developers to build and deploy applications to different environments and platforms with ease.


react-native run-androi

It’s Really not that Complicated.

You can actually understand what’s going on inside your live applications.

Try Lightrun’s Playground

Lets Talk!

Looking for more information about Lightrun and debugging?
We’d love to hear from you!
Drop us a line and we’ll get back to you shortly.

By submitting this form, I agree to Lightrun’s Privacy Policy and Terms of Use.