35 lines
2.7 KiB
Markdown
35 lines
2.7 KiB
Markdown
# SpineViewer 1.1.0
|
||
|
||
Eagle 的离线 Spine 骨骼动画预览插件，支持 Spine 3.4、3.5、3.6、3.7、3.8、4.0、4.1、4.2、4.3。
|
||
|
||
## 功能与使用
|
||
|
||
1. 将同一套骨骼文件（`.skel` / `.skel.bytes` / Spine `.json`）、图集（`.atlas` / `.atlas.txt`）和配套贴图一起导入 Eagle，建议放在同一个 Eagle 文件夹内，并保留文件名配对关系。
|
||
2. 打开骨骼或图集文件即可预览。普通图片仍使用 Eagle 原生预览。
|
||
3. 支持动画和皮肤切换、播放/暂停（空格）、循环、速度、时间轴拖动、缩放适配、背景与预乘 Alpha（PMA）切换。
|
||
4. 自动生成带 Spine 标记和版本号的缩略图，也可在预览器中将当前帧设为缩略图。资源未配齐时先显示占位图，补齐后会尝试自动刷新。
|
||
|
||
所有运行时均随包提供，无需联网。缺少或不匹配的原生 Canvas 依赖会使自动缩略图降级为占位图。
|
||
|
||
## 打包与平台替换
|
||
|
||
本目录就是插件根目录，在 Eagle 中加载此目录，再使用插件的“打包插件”功能生成 `.eagleplugin`；接收者安装生成的文件即可。
|
||
|
||
当前附带 **macOS Apple 芯片** 的 `@napi-rs/canvas` **0.1.66**。清单保留源码的 `all/all` 设置，正式出包前请根据下表手动设置 `manifest.json` 的 `platform` 和 `arch`。
|
||
|
||
保留 `node_modules/@napi-rs/canvas/` 公共目录，将同级的 `canvas-darwin-arm64/` 替换为目标平台的完整包目录（不要只改目录名），所有原生包版本必须为 **0.1.66**：
|
||
|
||
| 目标平台 | `node_modules/@napi-rs/` 下的原生包目录 | platform | arch |
|
||
| --- | --- | --- | --- |
|
||
| macOS Apple 芯片 | `canvas-darwin-arm64/`（已附带） | `mac` | `arm` |
|
||
| macOS Intel | `canvas-darwin-x64/` | `mac` | `x64` |
|
||
| Windows x64 | `canvas-win32-x64-msvc/` | `win` | `x64` |
|
||
|
||
对应目录中应包含 `package.json` 和原生文件 `skia.darwin-arm64.node`、`skia.darwin-x64.node` 或 `skia.win32-x64-msvc.node`。可在目标系统的临时目录复制本包的 `package.json`、`package-lock.json`，运行 `npm ci --omit=dev`，然后将生成的整个 `node_modules/` 替换到本目录。按实际运行进程架构选择依赖；Apple 芯片上以 Rosetta 运行的 x64 进程需要 x64 依赖。
|
||
|
||
如制作包含多个平台的合并包，可将所需原生包目录并排保留，公共 `canvas/` 只保留一份；覆盖并验证所有目标平台后再使用 `all/all`。平台字段见 [Eagle 官方说明](https://developer.eagle.cool/plugin-api/tutorial/manifest)。
|
||
|
||
打包前在目标 Eagle 中检查一次动画预览和自动缩略图；本目录未附带 Windows / Intel Mac 二进制，也未在这些系统上验证。
|
||
|
||
第三方许可证见 `LICENSES/`，分发时请保留。
|