@rafaelaugusto/jolt-native

中文文档
0.1.0-rc.6发布于 2026/11/02MITES Module零依赖构建来源已验证

可选的编译属性适配器为Jolt (MapKit, mapplibre和SceneKit)。

中文使用文档

Jolt原生属性运行时

可选的NativeScript插件 @rafaelaugusto/jolt/native. 安装这个包与Jolt和重建应用程序。核心Jolt不依赖于这个插件。

npm install @rafaelaugusto/jolt @rafaelaugusto/jolt-native

包括编译标量/复合播放,MapKit和SceneKit姿势/光/材料在iOS上的水槽,并在Android上的MapLibre水槽。它不安装MapLibre;应用程序选择它的SDK版本。参考演示:MapLibre Android 11.8.0, NativeScript 9.1, iOS 26 / Android 16。最小原生脚本8.9;原生助手API需要iOS 13+ / Android API 23+(应用/运行时或SDK可能需要更新)。

SceneKit外观支持光强度/颜色和材料透明度/固体漫射/发射颜色;纹理被拒绝。看到 照明指南 用于插值和生命周期限制。

看到 本地属性指南 对于功能、创作、所有权和执行限制。

发布维护者:将此可选包与兼容的核心版本一起发布(npm publish 从这个目录)。在存储库根目录下构建并打包核心。演示使用本地文件依赖项,不需要发布包进行验证。

使用SceneKit透视相机视场绑定 sceneKitFieldOfView(camera) 从核心开始 /native 条目。看到 相机指导 对于投影,镜头所有权和生命周期限制。从beta.15开始提供。安装匹配的核心/原生版本,并重新构建原生应用以包含此适配器。

从测试版17开始提供: sceneKitEnvironmentIntensity(scene) 和 sceneKitUniform(target, name, options) 在iOS 13+上添加原生环境和文字金属着色修改器输入。它们需要新的编译运行时和原生应用程序重建。这个 环境/着色器指南 文档浮动/矢量模式,范围,所有权,减少运动和不支持的活动源/SCNProgram缓冲区。

版本与发布记录

@rafaelaugusto/jolt-native 共发布 13 个版本,首次发布于 2026/10/23;过去 12 个月发布了 13 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.1.0-rc.6latest2026/11/021 天前
0.1.0-rc.52026/11/021 天前
0.1.0-rc.42026/10/313 天前
0.1.0-rc.32026/10/313 天前
0.1.0-rc.22026/10/304 天前
0.1.0-rc.12026/10/286 天前

关于 @rafaelaugusto/jolt-native 的常见问题

@rafaelaugusto/jolt-native 是什么?

可选的编译属性适配器为Jolt (MapKit, mapplibre和SceneKit)。

如何安装 @rafaelaugusto/jolt-native?

在项目目录运行 npm install @rafaelaugusto/jolt-native,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:@nativescript/core(>=8.9.0)、@rafaelaugusto/jolt(>=0.1.0-rc.6)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@rafaelaugusto/jolt-native 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/rafaelaugusto__jolt-native 是否存在。

@rafaelaugusto/jolt-native 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@rafaelaugusto/jolt-native 可以商用吗?

@rafaelaugusto/jolt-native 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@rafaelaugusto/jolt-native 还在维护吗?

最新版本 0.1.0-rc.6 发布于 2026/11/02(1 天前);至今共发布 13 个版本,其中过去 12 个月发布了 13 个;首次发布于 2026/10/23。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。