Skip to content
iOS Runtime for NativeScript
JavaScript Objective-C++ C++ Objective-C CMake Shell Other
Branch: master
Clone or download

Latest commit

Latest commit dea65d2 May 21, 2020


Type Name Latest commit message Commit time
Failed to load latest commit information.
.github chore: missing bracket Oct 5, 2018
build chore: Update package versions to 6.5.1 May 20, 2020
cmake chore: Update code signing team and profile Feb 3, 2020
examples chore(Gameraww): Fix crash on startup Aug 8, 2019
plugins/TKLiveSync chore: Fix JSC build error with ambiguous `Handle` May 21, 2020
src chore: Fix JSC build error with ambiguous `Handle` May 21, 2020
tests fix(runtime): Private root classes cause infinite loop May 4, 2020
tools Remove copied BuiltInNames.cpp/h and reuse the one from WebCore Jul 11, 2018
.gitattributes Initial commit Jan 24, 2015
.gitignore chore: add .vscode/ to .gitignore Jul 17, 2019
.gitmodules chore: Clone WebKit shallowly by default Aug 14, 2018 chore: Update CHANGELOG for v6.5.1 May 20, 2020
CMakeLists.txt chore: Fix compiler errors: Nov 4, 2019 chore: update community files Jan 17, 2018 chore: Update convention URL in Apr 10, 2018
LICENSE chore: update community files Jan 7, 2019 chore: Update LLVM requirement Sep 13, 2019
blacklist.mdg feat(metadata-generator): Filter according to specified black/white l… Jan 20, 2020 fix(build): The correct option to use in is -B Feb 7, 2019 chore: Fix Jenkins build May 22, 2019

iOS Runtime for NativeScript

Contains the source code for the NativeScript's iOS Runtime. NativeScript 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 iOS Runtime may be thought of as "The Bridge" between the JavaScript and the iOS world. A NativeScript application for iOS is a standard native package (ipa) which besides the JavaScript files embed the runtime as well.

git clone --recursive


Architecture Diagram

The NativeScript iOS Runtime architecture can be summarized in the following diagram.

iOS Runtime diagram

For more details on how it works, read the documentation.

Local Development

To be able to open and build {N} iOS Runtime in Xcode you need to configure it for WebKit development and generate the Xcode project files using cmake. To do this execute the following:

sudo ./src/webkit/Tools/Scripts/configure-xcode-for-ios-development
open "cmake-build/NativeScript.xcodeproj"

After you open the newly generated project in Xcode you can run the TestRunner target or the Gameraww example app.

For more information on WebKit configuration see Building iOS Port section of WebKit's README

Building a Distribution Package

To build the tns-ios npm package run ./build/scripts/ in the root of the repository. The package contains the NativeScript Cocoa Framework, the NativeScript CLI template project and the API metadata generator.

To build the tns-ios-inspector npm package run ./build/scripts/ in the root of the repository. The package contains the Web Inspector frontend.


We love PRs! Check out the contributing guidelines. If you want to contribute, but you are not sure where to start - look for issues labeled help wanted.

Get Help

Please, use github issues strictly for reporting bugs or requesting features. For general questions and support, check out Stack Overflow or ask our experts in NativeScript community Slack channel.

You can’t perform that action at this time.