跳转至

安装

▶视频教程 —— 即将推出

Octo Scene Assembler 是一个 Toon Boom Harmony 工具。它按用户安装，不需要提权。

Octo Tools 安装器

整个 Octo Tools 套件只有一个安装器。下载一次，勾上你买的产品 —— 这里是 Octo Scene Assembler —— 勾上要部署到的 Harmony 安装，然后按 Install。

平台 你要运行的东西
Windows Octo-Tools-Installer.exe
macOS Install Octo Tools.command

macOS 版是脚本，不是签名过的 app

Install Octo Tools.command 是一个普通 shell 脚本，跑的 Python 和 Windows 版一样 —— 没有 .app，没有代码签名，也没有公证。双击它即可。如果 macOS 拒绝运行，执行一次这个把它设为可执行：

chmod +x "Install Octo Tools.command"

窗口分三部分：

  1. Detected hosts —— 本机上找到的 Harmony 安装。
  2. Products —— 每个产品一行，每个应用一个复选框。默认什么都不勾。若某个应用未被检测到，对应复选框会被禁用。
  3. Licence key (optional) —— 每个产品行一个输入框。留空也行，之后在应用里激活。

每一个勾上的目标都会部署到它的原生位置，安装器会把它写下的东西精确记录在一份卸载清单里。

许可证按产品发放

一个 key 永远解锁不了整套。Octo Scene Assembler 有自己的许可证 —— 见 授权与激活。

卸载

勾上该产品那一行，按 Uninstall。卸载是按产品、精确执行的：只移除为该产品记录过的路径，机器上其他 Octo 工具毫发无损。

什么装到哪

形态 位置
OctoSceneAssembler.js 散放在 scripts 根目录，旁边是 octoSceneAssembler/ 包 Windows %APPDATA%\Toon Boom Animation\<product>\<version>-scripts\ · macOS ~/Library/Preferences/Toon Boom Animation/<product>/<version>-scripts/

Harmony 只登记 scripts 根目录里的脚本

这个 .js 必须散放在 <version>-scripts/ 里，绝不能放进子文件夹，而 Python 包必须在一个名字正好是 octoSceneAssembler 的文件夹里 —— 那正是 .js 解析的名字。安装器会处理对；如果你手动部署，请严格照做。

Harmony 需要系统级 Python 3.9

Harmony 通过 PATH 上的系统 Python 3.9 启动用户脚本。这对每个 Octo Tools 产品都适用。

3.10 及更新版本会被悄悄忽略 —— 脚本就是不运行，连一点报错都没有。安装器会检测 Python 3.9，缺失时会警告；它绝不阻断，所以你可以之后再装 Python。

手动安装

在受限的机器上就手动部署 —— 上面的布局就是全部约定：

  1. 把 OctoSceneAssembler.js 拷进 <version>-scripts/。
  2. 把 Python 包拷进 <version>-scripts/octoSceneAssembler/。
  3. 重启 Harmony。

打开它

从 Harmony 的 Scripts 菜单运行 Octo Scene Assembler，或者把它加到工具栏上。

首次启动会开始免费试用 —— 完整工具，没有限制。

OSA 把数据放在哪

%APPDATA%/Toon Boom Animation/Toon Boom Harmony Premium/octo_scene_assembler/
    license.json     the licence
    sessions/        one saved staging tree per scene
    osa.log          the log

要备份的是这一个文件夹，要清理的是这一个文件夹，报 bug 时要发的是这里的一个文件。见 会话与崩溃恢复。

下一步