tns-ios
NativeScript iOS 运行时
npm i --save tns-ios

NativeScript iOS 运行时

包含 NativeScript iOS 运行时的源代码。NativeScript 是一个框架,允许开发者使用 JavaScript 和 CSS 编写真正的原生移动应用程序。每个移动平台都有自己的生态系统,并提供完全不同的开发工具和语言 - Android 使用 Java,iOS 使用 Objective C(Swift)。为了将 JavaScript 代码转换为相应的原生 API,需要某种代理机制。这正是 NativeScript 的“运行时”部分负责的。iOS 运行时可以看作是 JavaScript 和 iOS 世界的“桥梁”。iOS 的 NativeScript 应用程序是一个标准的原生包(ipa),除了 JavaScript 文件外,还包含了运行时。

git clone --recursive [email protected]:NativeScript/ios-runtime.git

要求

  • OS X 10.11+
  • Xcode 10+
  • CMake 3.12 或更高版本。已测试到版本 3.14.4(https://github.com/Kitware/CMake/releases/download/v3.14.4/cmake-3.14.4-Darwin-x86_64.dmg) - 安装 CMake.app 后,使用以下命令在 usr/local/bin 中创建对 cmake 的符号链接:ln -s /Applications/CMake.app/Contents/bin/cmake /usr/local/bin
  • LLVM 8.0 - 用于构建 元数据生成器 子模块。请确保在 PATH 中包含包含 llvm-config 的文件夹,或者将其符号链接到 /usr/local/bin/
  • Automake - 在 Homebrew 中作为 automake 可用。
  • GNU Libtool - 在 Homebrew 中作为 libtool 可用。
  • Perl(macOS 上默认安装,但自 macOS X 10.15 起已弃用)
  • 使用 git submodule update --init 检出所有 git 子模块。

架构图

NativeScript iOS 运行时架构可以用以下图表概括。

iOS Runtime diagram

有关其工作原理的更多详细信息,请参阅文档

本地开发

要能够在 Xcode 中打开和构建 {N} iOS 运行时,您需要将其配置为 WebKit 开发,并使用 cmake 生成 Xcode 项目文件。为此,请执行以下操作

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

在您打开新创建的项目后,可以在 Xcode 中运行 TestRunner 目标或 Gameraww 示例应用程序。

有关 WebKit 配置的更多信息,请参阅 WebKit README 中的构建 iOS 端部分

构建发行包

要构建 tns-ios npm 包,请在存储库的 根目录 中运行 ./build/scripts/package-tns-ios.sh。该包包含 NativeScript Cocoa 框架、NativeScript CLI 模板项目和 API 元数据生成器。

要构建 tns-ios-inspector npm 包,请在存储库的 根目录 中运行 ./build/scripts/package-tns-ios-inspector.sh。该包包含 Web 检查器前端。

贡献

我们欢迎 PRs!请查看贡献指南。如果您想贡献,但不确定从哪里开始 - 查找标记为 help wanted 的问题。

获取帮助

请严格使用GitHub issues报告错误请求新功能。对于一般性问题和支持,请查看Stack Overflow或在我们的NativeScript社区Slack频道中咨询专家。