# @rafaelaugusto/jolt-native 中文文档

规范地址：https://npmcn.com/package/%40rafaelaugusto/jolt-native/

版本：0\.1\.0-rc\.6
npm 元数据更新时间：2026-11-02T03:44:04.136Z
中文译文更新时间：2026-11-02T06:49:47.162Z
软件包许可：MIT

本文由上游 README 机器翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40rafaelaugusto/jolt-native
原文对照：https://npmcn.com/package/%40rafaelaugusto/jolt-native/?lang=original
项目主页：https://github.com/rafaelaugustos/jolt#readme
源码仓库：https://github.com/rafaelaugustos/jolt

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：51.2 kB，17 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- 运行依赖：0 个
- peer 依赖：@nativescript/core \>=8\.9\.0，@rafaelaugusto/jolt \>=0\.1\.0-rc\.6
- 首次发布：2026-10-22T21:19:15.684Z
- 最新版本发布：2026-11-02T03:44:03.816Z
- 已发布版本数：13（近 12 个月 13 个）

## 中文简介

可选的编译属性适配器为Jolt （MapKit， mapplibre和SceneKit）。

## 安装

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

也可以使用：`pnpm add @rafaelaugusto/jolt-native`、`yarn add @rafaelaugusto/jolt-native`、`bun add @rafaelaugusto/jolt-native`

## README

# Jolt原生属性运行时

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

```sh
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外观支持光强度/颜色和材料透明度/固体漫射/发射颜色；纹理被拒绝。看到 [照明指南](https://jolt.rafaelaugusto.dev/guide/scene-lighting) 用于插值和生命周期限制。

看到 [本地属性指南](https://jolt.rafaelaugusto.dev/guide/native-properties) 对于功能、创作、所有权和执行限制。

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

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

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

## 常见问题

### @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 和提交记录判断。