Nucleus Powered Mitochondria


    0.64.2-patch.0 • Public • Published

    npm version CircleCI

    React Native with V8 Runtime

    The aim of this project is to support V8 runtime for React Native. Designed as opt-in package, it should easy to integrate with existing React Native projects.

    Integration with React Native

    To make RN integration easier, we publish prebuilt AAR into npm.

    The versioning is aligned with React Native but suffixed with a -patch.N in version E.g. If your React Native version is 0.60.0, you should use react-native-v8 >=0.60.0-patch.0 <0.60.1.

    Following steps will take 0.60.0 as example.

    1. Install react-native-v8
    yarn add 'react-native-v8@>=0.60.0-patch.0 <0.60.1'
    # [OPTIONAL] If to use different V8 version
    # yarn add 'v8-android@7.8.1'
    1. Modify your React Native build.gradle
    --- a/android/app/build.gradle
    +++ b/android/app/build.gradle
    @@ -161,11 +161,18 @@ android {
    +    packagingOptions {
    +        // Make sure does not packed in APK
    +        exclude "**/"
    +    }
     dependencies {
         implementation fileTree(dir: "libs", include: ["*.jar"])
         implementation "com.facebook.react:react-native:+"  // From node_modules
    +    // Add v8-android - prebuilt into APK
    +    implementation 'org.chromium:v8-android:+'
         // JSC from node_modules
         if (useIntlJsc) {
    --- a/android/build.gradle
    +++ b/android/build.gradle
    @@ -24,8 +24,12 @@ allprojects {
         repositories {
             maven {
    -            // All of React Native (JS, Obj-C sources, Android binaries) is installed from npm
    -            url("$rootDir/../node_modules/react-native/android")
    +            // Replace AAR from original RN with AAR from react-native-v8
    +            url("$rootDir/../node_modules/react-native-v8/dist")
    +        }
    +        maven {
    +            // prebuilt
    +            url("$rootDir/../node_modules/v8-android/dist")
             maven {
                 // Android JSC is installed from npm
    1. Gradle rebuild or react-native run-android

    2. Start application and could verify by JS global._v8runtime().version which expected to return V8 version.

    Builtin JavaScript object

    global._v8runtime() has some builtin information such as v8 version.

    console.log(`V8 version is ${global._v8runtime().version}`);

    Please note that global._v8runtime() existed only for V8 enabled environment but not React Native remote debugging mode. For remote debugging mode, the JavaScript actually runs on Chrome from your host and there is no V8Runtime.

    V8 Features Flags

    V8 provides many feature flags and the most important one should be JIT. Currently JIT is disabled for V8 lite mode

    react-native-v8 use the V8 shared libray from v8-android-buildscripts. For detailed V8 features, please check there.

    You can do the following to use one of these features in place of V8 lite mode which is packaged as the default for this repository:

    1. Add v8-android-jit via yarn or npm
    $ npm i v8-android-jit
    $ yarn add v8-android-jit
    1. Modify the gradle dependency to use v8-android-jit or other variants
    --- a/android/build.gradle
    +++ b/android/build.gradle
    @@ -29,7 +29,7 @@ allprojects {
             maven {
                 // prebuilt
    -            url("$rootDir/../node_modules/v8-android/dist")
    +            url("$rootDir/../node_modules/v8-android-jit/dist")
             maven {
                 // Android JSC is installed from npm

    This method can also be used to swap to other variants of V8. All possible variants include:

    • v8-android
    • v8-android-nointl
    • v8-android-jit
    • v8-android-jit-nointl

    Simply switch out v8-android-jit in the steps provided with the variant that you would like to use.

    iOS Support (Experimented)

    We did have experimented iOS support. To adopt V8 for Xcodeproj gets a little complicated, so we have a pre-shaped template. Please check react-native-template-v8 for more information.


    How to reduce APK size ?

    The V8 currently bundled by default supports Intl and the ICU data costs about 7MiB per ABI. If you are not going to use Intl, you could use no-Intl version to reduce APK size. (jsc-android and Hermes have no Intl by default)



    npm i react-native-v8

    DownloadsWeekly Downloads






    Unpacked Size

    34.1 MB

    Total Files


    Last publish


    • avatar