Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/nativescript/ios-jsc
NativeScript for iOS using JavaScriptCore
https://github.com/nativescript/ios-jsc
ios javascriptcore nativescript runtime
Last synced: about 1 month ago
JSON representation
NativeScript for iOS using JavaScriptCore
- Host: GitHub
- URL: https://github.com/nativescript/ios-jsc
- Owner: NativeScript
- License: apache-2.0
- Created: 2015-01-22T11:21:31.000Z (almost 10 years ago)
- Default Branch: master
- Last Pushed: 2023-01-13T17:56:45.000Z (almost 2 years ago)
- Last Synced: 2024-04-14T04:51:28.672Z (7 months ago)
- Topics: ios, javascriptcore, nativescript, runtime
- Language: JavaScript
- Homepage: http://docs.nativescript.org/runtimes/ios
- Size: 188 MB
- Stars: 297
- Watchers: 62
- Forks: 59
- Open Issues: 110
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# iOS Runtime for NativeScript
Contains the source code for the NativeScript's iOS 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 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.
```shell
git clone --recursive [email protected]:NativeScript/ios-runtime.git
```
- [Requirements](#requirements)
- [Architecture Diagram](#architecture-diagram)
- [Local Development](#local-development)
- [Building a Distribution Package](#building-a-distribution-package)
- [Contribute](#contribute)
- [Get Help](#get-help)
## Requirements
- OS X 10.11+
- [Xcode 10+](https://developer.apple.com/xcode/)
- 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 in `usr/local/bin` using the following command `ln -s /Applications/CMake.app/Contents/bin/cmake /usr/local/bin`
- [LLVM 8.0](http://releases.llvm.org/download.html#8.0.0) - used to build the [metadata generator](https://github.com/NativeScript/ios-metadata-generator) submodule. Be sure to have the folder containing `llvm-config` in `PATH` or make a symlink to in `/usr/local/bin/`.
- [Automake](https://www.gnu.org/software/automake/) - available in [Homebrew](http://brew.sh) as `automake`.
- [GNU Libtool](http://www.gnu.org/software/libtool/) - available in [Homebrew](http://brew.sh) as `libtool`.
- [Perl (installed on macOS by default but deprecated since macOS X 10.15)](https://www.perl.org/get.html#osx)
- Checkout all git submodules using `git submodule update --init`.
## Architecture Diagram
The NativeScript iOS Runtime architecture can be summarized in the following diagram.
For more details on how it works, read the [documentation](https://docs.nativescript.org/runtimes/ios/overview).
## 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:
```shell
sudo ./src/webkit/Tools/Scripts/configure-xcode-for-ios-development
./cmake-gen.sh
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](https://github.com/WebKit/webkit/blob/master/ReadMe.md#building-ios-port)
## Building a Distribution Package
To build the [`tns-ios` npm package](https://www.npmjs.com/package/tns-ios) run `./build/scripts/package-tns-ios.sh` 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](https://www.npmjs.com/package/tns-ios-inspector) run `./build/scripts/package-tns-ios-inspector.sh` in the **root** of the repository. The package contains the Web Inspector frontend.
## 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/ios-runtime/issues?q=is%3Aopen+is%3Aissue+label%3A%22help+wanted%22).
## Get Help
Please, use [github issues](https://github.com/NativeScript/ios-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).