@nativescript/android 8.9.0-napi-jsc.11 → 8.9.0-napi-v8.12

package/README.md

@@ -1,13 +1,28 @@
-# Node-API Android Runtime for NativeScript
-[![Build Status](https://travis-ci.org/NativeScript/android-runtime.svg?branch=master)](https://travis-ci.org/NativeScript/android-runtime)
+<p align="center" >
+  <img src="https://raw.githubusercontent.com/NativeScript/artwork/refs/heads/main/logo/export/NativeScript_Logo_White_Blue_Rounded.png" alt="NativeScript Logo" width="20%" height="20%">
+</p>
 
-Contains the source code for the NativeScript's Android Runtime. [NativeScript](https://www.nativescript.org/) is a framework which enables developers to write truly native mobile applications for Android and iOS using JavaScript and CSS. Each mobile platform has its own ecosystem and offers completely different development tools and language(s) - Java for Android and Objective C (Swift) for iOS. In order to translate JavaScript code to the corresponding native APIs some kind of proxy mechanism is needed. This is exactly what the "Runtime" parts of NativeScript are responsible for. The Android Runtime may be thought of as "The Bridge" between the JavaScript and Android worlds. A NativeScript application for Android is a standard native package (apk) which besides the JavaScript files embed the runtime as well.
+<h1 align="center">Node-API Android Runtime for NativeScript</h1>
+
+<div align  = "center">
+
+![NPM Version (with dist tag)](https://img.shields.io/npm/v/%40nativescript%2Fandroid/napi-v8?style=for-the-badge&logo=nativescript)
+![NPM Version (with dist tag)](https://img.shields.io/npm/v/%40nativescript%2Fandroid/napi-quickjs?style=for-the-badge&logo=nativescript)
+![NPM Version (with dist tag)](https://img.shields.io/npm/v/%40nativescript%2Fandroid/napi-hermes?style=for-the-badge&logo=nativescript)
+![NPM Version (with dist tag)](https://img.shields.io/npm/v/%40nativescript%2Fandroid/napi-jsc?style=for-the-badge&logo=nativescript)
+
+</div>
+
+[NativeScript](https://www.nativescript.org/) is an open-source framework for building truly native mobile applications using JavaScript. This repository contains the source code for the Node-API based Android Runtime used by NativeScript.
+
+The Android Runtime is a key component of the NativeScript framework. It is responsible for executing JavaScript code on Android devices. The runtime is built on top of [Node-API](https://nodejs.org/api/n-api.html) and provides a way to interact with the Android platform APIs from JavaScript.
+
+The new runtime is based on the Node-API and is designed to be more stable, faster, and easier to maintain. It also supports multiple JavaScript engines, including [V8](https://v8.dev/), [QuickJS](https://github.com/quickjs-ng/quickjs/), [Hermes](https://github.com/facebook/hermes), and [JavaScriptCore](https://docs.webkit.org/Deep%20Dive/JSC/JavaScriptCore.html).
 
 <!-- TOC depthFrom:2 -->
 
 - [Main Projects](#main-projects)
 - [Helper Projects](#helper-projects)
-- [Architecture Diagram](#architecture-diagram)
 - [Build Prerequisites](#build-prerequisites)
 - [How to build](#how-to-build)
 - [How to run tests](#how-to-run-tests)
@@ -16,118 +31,102 @@ Contains the source code for the NativeScript's Android Runtime. [NativeScript](
 
 <!-- /TOC -->
 
-## Additional docs
-Several Wiki pages describe some internal topics about the runtime [here](https://github.com/NativeScript/android-runtime/wiki)
+## Project structure
 
-## Main Projects
 The repo is structured in the following projects (ordered by dependencies):
 
-* [**android-metadata-generator**](android-metadata-generator) - generates metadata necessary for the Android Runtime.
-* [**android-binding-generator**](test-app/runtime-binding-generator) - enables Java & Android types to be dynamically created at runtime. Needed by the `extend` routine.
-* [**android-runtime**](test-app/runtime) - contains the core logic behind the NativeScript's Android Runtime. This project contains native C++ code and needs the Android NDK to build properly.
-* [**android-runtime-testapp**](test-app/app) - this is a vanilla Android Application, which contains the tests for the runtime project.
+- [**android-metadata-generator**](android-metadata-generator) - generates metadata necessary for the Android Runtime.
+- [**android-binding-generator**](test-app/runtime-binding-generator) - enables Java & Android types to be dynamically created at runtime. Needed by the `extend` routine.
+- [**android-runtime**](test-app/runtime) - contains the core logic behind the NativeScript's Android Runtime. This project contains native C++ code and needs the Android NDK to build properly.
+- [**android-runtime-testapp**](test-app/app) - this is a vanilla Android Application, which contains the tests for the runtime project.
+- [**napi-implementations**](test-app/runtime/src/main//cpp/napi/) - contains the implementation of the Node-API for each supported JS engine.
 
 ## Helper Projects
 
-* [**android-static-binding-generator**](android-static-binding-generator) - build tool that generates bindings based on the user's javascript code.
-* [**project-template**](build-artifacts/project-template-gradle) - this is an empty placeholder Android Application project, used by the [NativeScript CLI](https://github.com/NativeScript/nativescript-cli) when building an Android project.
+- [**android-static-binding-generator**](android-static-binding-generator) - build tool that generates bindings based on the user's javascript code.
+- [**project-template**](build-artifacts/project-template-gradle) - this is an empty placeholder Android Application project, used by the [NativeScript CLI](https://github.com/NativeScript/nativescript-cli) when building an Android project.
 
-## Architecture Diagram
-The NativeScript Android Runtime architecture can be summarized in the following diagram. 
+### Build Prerequisites
 
-![Android Runtime diagram](https://github.com/NativeScript/docs/blob/master/docs/img/ns-runtime-android.png)
+Following are the minimal prerequisites to build the runtime package.
 
-For more details on how it works, read the [documentation](https://v7.docs.nativescript.org/core-concepts/android-runtime/overview). 
+- Install the latest [Android Studio](https://developer.android.com/studio/index.html).
+- From the SDK Manager (Android Studio -> Tools -> Android -> SDK Manager) install the following components:
 
-## Build Prerequisites
-Following are the minimal prerequisites to build the runtime package.
+  - Android API Level 23, 24, 25, 26, 27
+  - Android NDK
+  - Android Support Repository
+  - Download Build Tools
+  - CMake
+  - LLDB
 
-* Install the latest [Android Studio](https://developer.android.com/studio/index.html).
-* From the SDK Manager (Android Studio -> Tools -> Android -> SDK Manager) install the following components:
-    * Android API Level 23, 24, 25, 26, 27
-    * Android NDK 
-    * Android Support Repository
-    * Download Build Tools 
-    * CMake
-    * LLDB
-* Clone this repository as well as the submodules: `git clone --recurse-submodules git@github.com:NativeScript/android-runtime.git`
+## How to Build
 
-## Working with the Runtime in Android Studio
+Clone the repo:
 
-* Open the test-app folder in Android Studio. It represents a valid Android project and you are able to build and run a test application working with the Runtime from the source.
+```Shell
+git clone https://github.com/NativeScript/napi-android.git
+```
 
-Note: You might need to run the Android Studio from the command line in order to preserve the environment variables. This is in case you get errors like "missing npm" if starting the studio the usual way.
+Install the jsparser dependencies:
 
-## How to Build
+```Shell
+cd test-app/build-tools/jsparser
+npm install
+```
 
-* Install dependencies from NPM:
+Set the following environment variables:
 
-  ```Shell
-  cd test-app/build-tools/jsparser
-  npm install
-  ```
+- `JAVA_HOME` such that `$JAVA_HOME/bin/java` points to your Java executable
+- `ANDROID_HOME` pointing to where you have installed the Android SDK
+- `ANDROID_NDK_HOME` pointing to the version of the Android NDK needed for this version of NativeScript
 
-* Set environment variables:
-  - `JAVA_HOME` such that `$JAVA_HOME/bin/java` points to your Java executable
-  - `ANDROID_HOME` pointing to where you have installed the Android SDK
-  - `ANDROID_NDK_HOME` pointing to the version of the Android NDK needed for this version of NativeScript
+Run command
 
-* Run command 
+Windows:
 
-  Windows: 
+```Shell
+gradlew -Pengine=V8
+```
 
-  ```Shell
-  gradlew -Pengine=V8
-  ```
+Mac/Linux:
 
-  Mac/Linux:
+```Shell
+./gradlew -Pengine=V8
+```
 
-  ```Shell
-  ./gradlew -Pengine=V8
-  ```
 You can pass in `QUICKJS`, `HERMES`, `JSC` or `V8` to compile the runtime with the respective JS engine.
 
-* The build process includes building of the runtime package (both optimized and with unstripped v8 symbol table), as well as all supplementary tools used for the android builds: metadata-generator, binding-generator, metadata-generator, static-binding-generator
-* The result of the build will be in the dist folder.
-
-  `Note:` To cut the build time in half and package only the optimized (stripped) version of the runtime package comment out 'tasks.generateRuntimeAar.execute()' in the [build.gradle](https://github.com/NativeScript/android-runtime/blob/v3.0.0-rc.1/build.gradle#L114) script.
+- The build process includes building of the runtime package (both optimized and with unstripped v8 symbol table), as well as all supplementary tools used for the android builds: metadata-generator, binding-generator, metadata-generator, static-binding-generator
+- The result of the build will be in the dist\_[engine] folder. For example if you are building with V8, the result will be in the dist_v8 folder.
 
 ## How to Run Tests
 
-* Go to subfolder test-app after you built the runtime.
-* Start an emulator or connect a device.
+- Go to subfolder test-app after you built the runtime.
+- Start an emulator or connect a device.
+
+- Run command
 
-  ``Note: Keep in mind the device or emulator needs to have an sdcard mounted.``
-* Run command
 ```Shell
 gradlew runtests
 ```
 
-## How to Connect the Inspector
+## Working with the Runtime in Android Studio
 
-* Install dependencies: run command
-```Shell
-cd test-app
-npm install
-```
-* Run the test app in Android Studio, or manually in the emulator.
-* Run command
-```Shell
-npx ns debug android --start
-```
-  (If you instead have the `nativescript` NPM module installed globally,
-  you can omit the `npm install` and the `npx` prefix.)
-* This will print out a URL, such as
-  `devtools://devtools/bundled/inspector.html?ws=localhost:40000`.
-  Open this URL in Chrome or Chromium.
+- Open the test-app folder in Android Studio. It represents a valid Android project and you are able to build and run a test application working with the Runtime from the source.
 
-## Contribute
-We love PRs! Check out the [contributing guidelines](CONTRIBUTING.md). If you want to contribute, but you are not sure where to start - look for [issues labeled `help wanted`](https://github.com/NativeScript/android-runtime/issues?q=is%3Aopen+is%3Aissue+label%3A%22help+wanted%22).
+Note: You might need to run the Android Studio from the command line in order to preserve the environment variables. This is in case you get errors like "missing npm" if starting the studio the usual way.
 
+You can change the JS engine used by the runtime by setting the `jsEngine` property in the [`build.gradle`](test-app/runtime/build.gradle) file in the root of the project. The possible values are `QUICKJS`, `HERMES`, `JSC` or `V8`.
 
-## Misc
+## Contribute
 
-* [Implementing additional Chrome DevTools protocol Domains](docs/extending-inspector.md)
+We love PRs! Check out the [contributing guidelines](CONTRIBUTING.md). If you want to contribute, but you are not sure where to start - look for [issues labeled `help wanted`](https://github.com/NativeScript/napi-android/issues?q=is%3Aopen+is%3Aissue+label%3A%22help+wanted%22).
 
 ## Get Help
-Please, use [github issues](https://github.com/NativeScript/android-runtime/issues) strictly for [reporting bugs](CONTRIBUTING.md#reporting-bugs) or [requesting features](CONTRIBUTING.md#requesting-new-features). For general questions and support, check out [Stack Overflow](https://stackoverflow.com/questions/tagged/nativescript) or ask our experts in [NativeScript community Slack channel](http://developer.telerik.com/wp-login.php?action=slack-invitation).
+
+Please, use [github issues](https://github.com/NativeScript/napi-android/issues) strictly for [reporting bugs](CONTRIBUTING.md#reporting-bugs) or [requesting features](CONTRIBUTING.md#requesting-new-features). For general questions and support, check out [Stack Overflow](https://stackoverflow.com/questions/tagged/nativescript) or ask our experts in [NativeScript community on Discord](https://nativescript.org/discord).
+
+## License
+
+This project is licensed under the Apache License Version 2.0. See the [LICENSE file](LICENSE) for more info.

package/framework/app/src/main/assets/internal/ts_helpers.js

@@ -92,13 +92,13 @@
             Array.prototype.slice.call(arguments, 1)
           );
         } else {
-          thiz  = new (Function.prototype.bind.apply(
+          thiz = new (Function.prototype.bind.apply(
             Extended,
             [null].concat(Array.prototype.slice.call(arguments, 1))
           ))();
         }
       } else {
-        thiz  = new Extended();
+        thiz = new Extended();
       }
       return thiz;
     };
@@ -107,17 +107,14 @@
       var Extended = extend(thiz);
       thiz.__container__ = true;
       if (args && args.length > 0) {
-       if (typeof Extended !== "function") {
-                thiz = Reflect.construct(
-                  Extended,
-                  [null].concat(args)
-                );
-         } else {
-              thiz  = new (Function.prototype.bind.apply(
-                        Extended,
-                        [null].concat(args)
-                      ))();
-         }
+        if (typeof Extended !== "function") {
+          thiz = Reflect.construct(Extended, [null].concat(args));
+        } else {
+          thiz = new (Function.prototype.bind.apply(
+            Extended,
+            [null].concat(args)
+          ))();
+        }
       } else {
         thiz = new Extended();
       }
@@ -279,14 +276,14 @@
     return undefined;
   }
 
-globalThis.__prepareHostObject = function (hostObject, jsThis) {
-//    const prototype = Object.getPrototypeOf(jsThis);
-//    Object.setPrototypeOf(hostObject, prototype);
-     Object.defineProperty(hostObject, "super", {
-              get: () => jsThis["super"],
+  globalThis.__prepareHostObject = function (hostObject, jsThis) {
+    //    const prototype = Object.getPrototypeOf(jsThis);
+    //    Object.setPrototypeOf(hostObject, prototype);
+    Object.defineProperty(hostObject, "super", {
+      get: () => jsThis["super"],
     });
-};
- 
+  };
+
   const EXTERNAL_PROP = "[[external]]";
   const REFERENCE_PROP_JSC = "[[jsc_reference_info]]";
 
@@ -331,4 +328,66 @@ globalThis.__prepareHostObject = function (hostObject, jsThis) {
     lines[2] = "  at extend(native)";
     return lines.join("\n");
   };
+
+  if (globalThis.URL) {
+    const BLOB_STORE = new Map();
+    URL.createObjectURL = function (object, options = null) {
+      try {
+        if (object instanceof Blob || object instanceof File) {
+          const id = java.util.UUID.randomUUID().toString();
+          const ret = `blob:nativescript/${id}`;
+          BLOB_STORE.set(ret, {
+            blob: object,
+            type: object?.type,
+            ext: options?.ext,
+          });
+          return ret;
+        }
+      } catch (error) {
+        return null;
+      }
+      return null;
+    };
+    URL.revokeObjectURL = function (url) {
+      BLOB_STORE.delete(url);
+    };
+    const InternalAccessor = class {};
+    InternalAccessor.getData = function (url) {
+      return BLOB_STORE.get(url);
+    };
+    URL.InternalAccessor = InternalAccessor;
+    Object.defineProperty(URL.prototype, "searchParams", {
+      get() {
+        if (this._searchParams == null) {
+          this._searchParams = new URLSearchParams(this.search);
+          Object.defineProperty(this._searchParams, "_url", {
+            enumerable: false,
+            writable: false,
+            value: this,
+          });
+          this._searchParams._append = this._searchParams.append;
+          this._searchParams.append = function (name, value) {
+            this._append(name, value);
+            this._url.search = this.toString();
+          };
+          this._searchParams._delete = this._searchParams.delete;
+          this._searchParams.delete = function (name) {
+            this._delete(name);
+            this._url.search = this.toString();
+          };
+          this._searchParams._set = this._searchParams.set;
+          this._searchParams.set = function (name, value) {
+            this._set(name, value);
+            this._url.search = this.toString();
+          };
+          this._searchParams._sort = this._searchParams.sort;
+          this._searchParams.sort = function () {
+            this._sort();
+            this._url.search = this.toString();
+          };
+        }
+        return this._searchParams;
+      },
+    });
+  }
 })();

package/framework/app/src/main/java/com/tns/RuntimeHelper.java

@@ -23,7 +23,7 @@ public final class RuntimeHelper {
     private RuntimeHelper() {
     }
 
-    // private static AndroidJsV8Inspector v8Inspector;
+    private static AndroidJsV8Inspector v8Inspector;
 
     // hasErrorIntent tells you if there was an event (with an uncaught
     // exception) raised from ErrorReport
@@ -151,8 +151,8 @@ public final class RuntimeHelper {
                 runtime = Runtime.initializeRuntimeWithConfiguration(config);
                 if (isDebuggable) {
                     try {
-                        // v8Inspector = new AndroidJsV8Inspector(context.getFilesDir().getAbsolutePath(), context.getPackageName());
-                        // v8Inspector.start();
+                        v8Inspector = new AndroidJsV8Inspector(context.getFilesDir().getAbsolutePath(), context.getPackageName());
+                        v8Inspector.start();
 
                         // the following snippet is used as means to notify the VSCode extension
                         // debugger that the debugger agent has started
@@ -176,7 +176,7 @@ public final class RuntimeHelper {
                             shouldBreak = true;
                         }
 
-                        // v8Inspector.waitForDebugger(shouldBreak);
+                        v8Inspector.waitForDebugger(shouldBreak);
                     } catch (IOException e) {
                         if (Util.isDebuggableApp(context)) {
                             e.printStackTrace();

package/framework/gradle.properties

@@ -1,4 +1,4 @@
-#Wed, 26 Feb 2025 12:42:21 -0800
+#Wed, 19 Mar 2025 19:07:59 -0700
 # Project-wide Gradle settings.
 
 # IDE (e.g. Android Studio) users:
@@ -45,4 +45,4 @@ ns_default_kotlinx_metadata_jvm_version=2.0.0
 ns_default_mockito_core_version=3.0.0
 ns_default_spotbugs_version=3.1.12
 
-ns_engine=JSC
+ns_engine=V8

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@nativescript/android",
     "description": "NativeScript for Android using Node-API",
-    "version": "8.9.0-napi-jsc.11",
+    "version": "8.9.0-napi-v8.12",
     "repository": {
         "type": "git",
         "url": "https://github.com/NativeScript/android.git"