npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

@exodus/jsc-android

v0.0.1

Published

Pre-build version of JavaScriptCore to be used by React Native apps

Downloads

21

Readme

npm version GitHub Actions CI

JSC build scripts for Android

The aim of this project is to provide maintainable build scripts for the JavaScriptCore JavaScript engine and allow the React Native project to incorporate up-to-date releases of JSC into the framework on Android.

This project is based on facebook/android-jsc but instead of rewriting JSC's build scripts into BUCK files, it relies on CMake build scripts maintained in a GTK branch of WebKit maintained by the WebKitGTK team (great work btw!). Thanks to that, with just a small amount of work we should be able to build not only current but also future releases of JSC. An obvious benefit for everyone using React Native is that this will allow us to update JSC for React Native on Android much more often than before (note that facebook/android-jsc uses JSC version from Nov 2014), which is especially helpful since React Native on iOS uses the built-in copy of JSC that is updated with each major iOS release (see this as a reference).

Requirements

  • Homebrew (https://brew.sh/)
  • GNU coreutils brew install coreutils
  • Node brew install node
  • Java 8: brew tap caskroom/versions && brew cask install java8
  • Android SDK: brew cask install android-sdk
    • Run sdkmanager --list and install all platforms, tools, buildtool v28.0.3, cmake (android images are not needed)
    • Set $ANDROID_HOME to the correct path (in ~/.bashrc or similar)
    • Set export PATH=$PATH:$ANDROID_HOME/platform-tools:$ANDROID_HOME/tools/bin
  • Android NDK r19c: download from NDK Archives
    • Set export ANDROID_NDK=/path/to/android-ndk-r19c
  • Make sure you have Ruby (>2.3), Python (>2.7), Git, SVN, gperf

Build instructions

  1. Clone this repo
  2. npm run clean will clean everything (artifacts, downloaded sources)
  3. Update the version in package.json. The version will be printed by JSC lib as soon as it loads.
  4. Update the config section under package.json to the desired build configuration
  5. Update patches if needed (don't forget to update the printVersion patch in jsc.patch)
  6. npm run download: downloads all needed sources
  7. npm run start: builds jsc (this might take some time...)

The zipfile containing the android-jsc AAR will be available at /dist. The library is packaged as a local Maven repository containing AAR files that include the binaries.

Distribution

JSC library built using this project is distributed over npm: npm/jsc-android. The library is packaged as a local Maven repository containing AAR files that include the binaries. Please refer to the section below in order to learn how your app can consume this format.

On load, JSC prints the version out to logcat, under "JavaScriptCore.Version" tag.

How to use it with my React Native app

Follow steps below in order for your React Native app to use new version of JSC VM on android:

For React Native version 0.60 and newer

  1. Update jsc-android:
yarn add jsc-android

# Or if you would like to try latest version
# yarn add 'jsc-android@next'
  1. You're done, rebuild your app and enjoy updated version of JSC on android!

For React Native version 0.59

  1. Add jsc-android:
yarn add jsc-android

# Or if you would like to try latest version
# yarn add 'jsc-android@next'
  1. Modify android/build.gradle file to add the new local maven repository packaged in the jsc-android package to the search path:
allprojects {
    repositories {
        mavenLocal()
        jcenter()
        maven {
            // All of React Native (JS, Obj-C sources, Android binaries) is installed from npm
            url "$rootDir/../node_modules/react-native/android"
        }
+       maven {
+           // Local Maven repo containing AARs with JSC library built for Android
+           url "$rootDir/../node_modules/jsc-android/dist"
+       }
    }
}
  1. Update your app's build.gradle file located in android/app/build.gradle to add the JSC dependency. Please make sure the dependency is before the React Native dependency.

dependencies {
+   // Make sure to put android-jsc at the top
+   implementation "org.webkit:android-jsc:+"
+
    compile fileTree(dir: "libs", include: ["*.jar"])
    implementation "com.android.support:appcompat-v7:${rootProject.ext.supportLibVersion}"
    implementation "com.facebook.react:react-native:+"  // From node_modules
}
  1. Update your app's build.gradle file located in android/app/build.gradle to use first matched JSC library.
android {
    // ...
+   packagingOptions {
+       pickFirst '**/libjsc.so'
+       pickFirst '**/libc++_shared.so'
+    }
}
  1. You're done - rebuild your app and enjoy the updated version of JSC on Android!

For React Native version 0.58 below

  1. Add jsc-android:
yarn add jsc-android

# Or if you would like to try latest version
# yarn add 'jsc-android@next'
  1. Modify android/build.gradle file to add new local maven repository packaged in the jsc-android package to the search path:
allprojects {
    repositories {
        mavenLocal()
        jcenter()
        maven {
            // All of React Native (JS, Obj-C sources, Android binaries) is installed from npm
            url "$rootDir/../node_modules/react-native/android"
        }
+       maven {
+           // Local Maven repo containing AARs with JSC library built for Android
+           url "$rootDir/../node_modules/jsc-android/dist"
+       }
    }
}
  1. Update your app's build.gradle file located in android/app/build.gradle to force app builds to use new version of the JSC library as opposed to the version specified in react-native gradle module as a dependency:
}

+configurations.all {
+    resolutionStrategy {
+        force 'org.webkit:android-jsc:+'
+    }
+}

dependencies {
    compile fileTree(dir: "libs", include: ["*.jar"])
+   // ...
+   implementation 'org.webkit:android-jsc-cppruntime:+'
+   // For even older gradle
+   // compile 'org.webkit:android-jsc-cppruntime:+'
  1. You're done, rebuild your app and enjoy updated version of JSC on android!

International variant

International variant includes ICU i18n library and necessary data allowing to use e.g. Date.toLocaleString and String.localeCompare that give correct results when using with locales other than en-US. Note that this variant is about 6MiB larger per architecture than default.

To use this variant instead replace the third installation step with:

For React Native version 0.60 and newer, your build.gradle should have a flag to enable this feature.

  /**
   * Use the international variant of JavaScriptCore
   * This variant includes the ICU i18n library to make APIs like `Date.toLocaleString`
   * and `String.localeCompare` work when using with locales other than en-US.
   * Note that this variant is about 6MiB larger per architecture than the default.
   */
-  def useIntlJsc = false
+  def useIntlJsc = true

For React Native version 0.59, replace original artifact id with android-jsc-intl


dependencies {
+   // Make sure to put android-jsc at the the first
+   implementation "org.webkit:android-jsc-intl:+"
+
    compile fileTree(dir: "libs", include: ["*.jar"])
    implementation "com.android.support:appcompat-v7:${rootProject.ext.supportLibVersion}"
    implementation "com.facebook.react:react-native:+"  // From node_modules
}

For React Native version 0.58 below, replace original resolutionStrategy with this.

+configurations.all {
+    resolutionStrategy {
+        eachDependency { DependencyResolveDetails details ->
+            if (details.requested.name == 'android-jsc') {
+                details.useTarget group: details.requested.group, name: 'android-jsc-intl', version: 'r241213'
+            }
+        }
+    }
+}

Testing

See Measurements page that contains synthetic perf test results for the most notable versions of JSC we have tried.

Troubleshooting

Compile errors of the sort:

More than one file was found with OS independent path 'lib/armeabi-v7a/libgnustl_shared.so'

Add the following to your app/build.gradle, under android:

packagingOptions {
    pickFirst '**/libgnustl_shared.so'
}

Resources

Credits

Check the list of contributors here. This project is supported by:

expo Expo.io

swm Software Mansion

wix Wix