Files
SpineViewer/release/MAC_SpineViewer/README.md
T
2026-09-11 21:43:23 +08:00

2.7 KiB
Raw Blame History

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 官方说明。

打包前在目标 Eagle 中检查一次动画预览和自动缩略图;本目录未附带 Windows / Intel Mac 二进制,也未在这些系统上验证。

第三方许可证见 LICENSES/,分发时请保留。