jelavallee / android-runtime

Android runtime for NativeScript (based on V8)

Android-Runtime

Contains the source code for the NativeScript's Android runtime. The android-runtime is a main component used in NativeScript.

Main Projects

The repo is structured in the following projects (ordered by dependencies):

• android-metadata-generator - generates metadata necessary for the Android Runtime.
• android-binding-generator - enables Java & Android types to be dynamically created at runtime. Needed by the extend routine.
• android-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 - this is a vanilla Android Application, which contains the tests for the runtime project.

Helper Projects

• android-static-binding-generator - build tool that generates bindings based on the user's javascript code
• android-binding-generator-tester - contains the tests for the binding-generator project.
• build/project-template - this is an empty placeholder Android Application project, used by the NativeScript CLI when building an Android project.

Build Prerequisites

The source in this repo is organized in Android Studio projects.

• Install the latest Android Studio .
• Install Android API Level 22 from Android Studio -> Tools -> Android -> SDK Manager
• Install the Android NDK from Android Studio -> Tools -> Android -> SDK Manager
• Download Android Support Repository through the Android SDK Manager
• Download Build Tools 22 through the Android SDK Manager.

How to build

• Run command

gradlew build

• The result of the build will be in the dist folder.

How to run tests

• Go to subfolder test-app after you built the runtime.

• Start an emulator or connect a device.

  Note: Keep in mind the device or emulator needs to have an sdcard mounted.

• Run command

gradle runtest