Repository navigation
Releases: HaiyueStudio/Native
Release list
@haiyue/native 0.1.4
@haiyue/native 0.1.4
本次更新提供 Native / Web 系统分享，分离系统能力与 Engine 渲染适配，并完善 iOS ATT 授权流程。npm 包只包含可复用适配代码、文档和必要资源；游戏示例从 GitHub 源码获取。
安装与兼容
npm install @haiyue/native@0.1.4- 纯系统能力按子路径导入，例如
@haiyue/native/share、/motion、/feedback、/scanner、/purchases/native，无需 Engine。 - 根入口保留渲染兼容性；新增
@haiyue/native/engine明确提供渲染适配。使用它们时需自行安装@haiyue/engine，peer 范围为^0.2.0（不包含 0.3.0 与预发布版本）。实际包安装、类型与双平台入口验证使用已发布的 Engine 0.2.0。 - NativeScript core 9.1.1、Canvas 2.1.18；npm 仍分发需要宿主构建器编译的 TypeScript 源码。Web 使用
/share或/share/web，避免导入 Native 根入口。
变更
- 系统分享支持文字、链接及单张 PNG/JPEG，接入 iOS 分享面板、Android chooser 和 Web Share API。统一能力检查、并发保护及结果处理；Android 图片分享需按文档配置包内 provider。
- 完善分享取消后立即重开、旋转和后台恢复；Native 运行时补充 AbortController 兼容。战绩卡生成与国际化仍由游戏或 Engine extensions 提供。
- 可选
iosTrackingAuthorization: "system"使用 Apple ATT：先处理地区隐私同意，付费启动不请求 ATT，年龄策略和地区拒绝会抑制 Native 请求。授权未结束时不初始化或加载广告，已拒绝或受限不会阻塞正常启动。 - 增加 ATT Debug 阶段日志、独立真机验收宿主及
restricted自动化覆盖。保留实时状态读取，避免将 ATT、地区同意和奖励资格混为一谈。
验证与适用边界
- iPhone 15 Plus 与 Android X4000 的分享面板验收已覆盖图片/文字、取消重开、横屏和后台恢复；未向外部接收者实际发布内容。详见 分享真机记录。其中战绩卡生成使用的是当时 Engine 0.2.1 本地候选；这不代表公开 Engine 0.2.0 包具有该扩展。
- iPhone ATT 已覆盖 Native 首次弹窗拒绝、设置授权/撤销、再次启动、付费/旧策略/年龄策略、地区拒绝及测试广告关闭回调。详见 ATT 验收记录。
restricted：自动化通过，真机待验收。 屏幕使用时间尝试未产生该状态；测试替身的结果不代替系统实测。此项作为已披露的后续验收事项保留。- 新版本源码门禁、全新目录安装和 npm 制包结果见 0.1.4 验收记录。历史设备结果仅对应其记录的构建，不宣称本次重跑全部游戏真机测试。
- 内购与广告继续按实验性能力提供；未新增商店购买、真实广告收益或应用商店发布验收。第三方模型不包含在 npm 或公开源码中，许可与使用路径见仓库声明。
Native 0.1.1 · 独立源码版
Native 0.1.1 源码版：游戏代码与自有素材已纳入 Native，不再依赖相邻 Games 目录。
开始使用
git clone --branch v0.1.1 --depth 1 https://github.com/HaiyueStudio/Native.git
cd Native
npm run release:verify -- --install
npm run models:check下载 GitHub 自动生成的 Source code ZIP/TAR 后，在解压根目录执行 git init，再运行验证。需要 Node 24.19.0 / npm 11.17.0；原生工具按构建指南准备。
示例与模型
PBR Orbit、蜘蛛纸牌、Sky Strike、魔方无需外部模型。AK47 Range 需要 local-assets/ak47-range/ren42.glb 和 qiang_ak47.glb；Neon Circuit 需要 local-assets/neon-circuit/wraith-raider.glb。也可通过 HAIYUE_MODEL_ASSETS 指定相同结构的外部目录。
模型来源及原始许可未能核实，本发布不提供模型、下载链接或占位模式。开发者须自行提供有权使用且结构兼容的模型。缺少模型不影响全部源码检查，仍可构建前四个示例。MIT 仅涵盖对应源码，不会重新授权第三方模型。
验证
六个 iOS Debug App 与 Neon Circuit Android Debug APK 已在 rc.4 的全新项目目录完成编译、签名和依赖锁检查；87 项测试通过。正式版运行代码、原生构建输入、素材、依赖和工具链与 rc.4 相同，追加的模型检查入口五种场景通过，并重新通过最终源码检查。
使用固定工具链与下载缓存，未复制旧 node_modules/platforms/App 产物；不声称重新进行真机交互验收。
分发范围与访问
仅发布源码、自有图片音效及固定 vendor 依赖；不附带第三方 GLB、模型转换产物、APK/IPA/AAB 或签名凭据，不上传应用商店。应用版本保持 0.1.0，源码标签为 v0.1.1，保留 v0.1.0。
仓库、正式发布页和源码下载现已公开，无需 GitHub 授权即可访问。 经维护者明确确认，保留并公开现有全部 Git 历史。标签内的访问记录保留了发布前私有状态的检查结果；发布后的公开访问结果见 后续访问验证。
@haiyue/native 0.1.0
@haiyue/native 0.1.0 已发布。根项目原名 @haiyue/native-repository，本次统一新名称、根锁文件、候选配置和冻结清单。
npm 核心包
npm install @haiyue/native@0.1.0npm 包本体为 177,192 字节（约 173 KiB），包含 NativeScript 原生能力与通用小图标；不包含 games、examples、游戏美术、模型、引擎 vendor 压缩包或源码初始化器。游戏示例仍从下方 GitHub 源码获取。Engine / NativeScript / Canvas 通过 peer dependencies 接入。
npm 的类型、双平台解析、包范围与匿名安装验证见 发布记录。
获取源码
git clone --branch native-v0.1.0 --depth 1 https://github.com/HaiyueStudio/Native.git
cd Native
npm run release:verify -- --install
npm run models:check固定 Node 24.19.0 / npm 11.17.0。ZIP/TAR 解压后先在根目录 git init。此页保留 GitHub 完整源码发布。现另提供 @haiyue/native@0.1.0 npm 核心包；根源码项目仍保持 private: true，npm 包由 npm/ 独立构建，仅包含可复用原生能力。
本次内容
六个原生示例及本仓库内的五款游戏实现、自有图片音效、固定 vendor 依赖和原生桥接均保留，无需相邻 Games 或 Engine 仓库。包含最新 Sky Strike iPad 支持与共享开屏页：首个 GPU 画面呈现后淡出开屏。
PBR Orbit、蜘蛛纸牌、Sky Strike、魔方无需外部模型。AK47 Range 需要 local-assets/ak47-range/ren42.glb 和 qiang_ak47.glb；Neon Circuit 需要 local-assets/neon-circuit/wraith-raider.glb。未知原始许可的模型及其转换产物不随源码分发，没有自动下载或占位模式。MIT 不重新授权第三方模型。
验证
683 项输入重新冻结；六个应用的源码检查、依赖检查和 88 项测试通过，依赖及工具链版本不变。验证记录 包含输入差异和实际结果。
Sky Strike 的同一实现已有 iPad 开屏页构建、签名与真机记录。此次未重复全量原生构建或真机验收；旧版本构建记录作为历史证据保留。
仓库与发布页公开。发布后的 匿名访问记录 追加到 main。新标签为 native-v0.1.0，保留旧名称下的 v0.1.0 与 v0.1.1，不覆盖历史发布。本次不附带 APK/IPA/AAB 或签名凭据，不上传应用商店。