Repository files navigation

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 git@github.com:NativeScript/ios-runtime.git

• Requirements
• Architecture Diagram
• Local Development
• Building a Distribution Package
• Contribute
• Get Help

• OS X 10.11+
• Xcode 10+
• CMake 3.12 or later. Tested with versions up to 3.14.4 (https://github.com/Kitware/CMake/releases/download/v3.14.4/cmake-3.14.4-Darwin-x86_64.dmg) - after installing CMake.app add a symlink to cmake inusr/local/bin using the following commandln -s /Applications/CMake.app/Contents/bin/cmake /usr/local/bin
• LLVM 8.0 - used to build themetadata generator submodule. Be sure to have the folder containingllvm-config inPATH or make a symlink to in/usr/local/bin/.
• Automake - available inHomebrew asautomake.
• GNU Libtool - available inHomebrew aslibtool.
• Perl (installed on macOS by default but deprecated since macOS X 10.15)
• Checkout all git submodules usinggit submodule update --init.

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

For more details on how it works, read thedocumentation.

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./cmake-gen.shopen"cmake-build/NativeScript.xcodeproj"

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

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

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

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

We love PRs! Check out thecontributing guidelines. If you want to contribute, but you are not sure where to start - look forissues labeledhelp wanted.

Please, usegithub issues strictly forreporting bugs orrequesting features. For general questions and support, check outStack Overflow or ask our experts inNativeScript community Slack channel.