FrameSeq 应用#

FrameSeq 应用一个下载就装好 FrameSeq 需要的一切,包括 Node.js,所以不需要事先安装任何东西。它把 FrameSeq Studio 放到打开程序的地方,并提供与 npm 安装相同的 frameseq 命令。

下载页会给出适合你这台电脑的文件。所有文件也都在发布页上:

里面有什么#

• Node.js,FrameSeq 所用的运行时,只供 FrameSeq 使用。
• FrameSeq 及其全部依赖,和 npm 安装的是同一个包。
• Typst 编译器和 Tectonic,不另装它们,Typst 片段和 LaTeX 表格也能用。Tectonic 第一次编译某个片段时,会下载它需要的 TeX 文件。
• macOS 和 Linux 版附带一个无头浏览器,用于 PDF、PowerPoint 和布局检查。Windows 使用每台 Windows 电脑都有的 Microsoft Edge。
• FrameSeq Studio 的窗口,一个小程序,用系统自带的网页视图显示 Studio:Windows 上是 WebView2,macOS 和 Linux 上是 WebKit。

使用#

从开始菜单、"应用程序"或应用菜单打开 FrameSeq Studio。它从启动页开始,在那里点一下就能新建演示;见 FrameSeq Studio。

.fsq 文件(也就是 Studio 保存的演示)双击时会用 FrameSeq Studio 打开,并显示 FrameSeq 的图标:Windows 上由安装程序设置,macOS 上应用放进"应用程序"后即可,Linux 上由 install.sh 设置。已经在某个 Studio 里打开的演示,双击时会把那个窗口切到前面,而不是再打开一次;停在启动页的窗口会直接打开它;其他情况下,它在自己的窗口里打开,导出的文件放在它旁边。Windows 便携版运行过 frameseq shortcut 之后也一样。

Studio 像桌面程序一样在自己的窗口里打开。在 Windows 上,菜单栏就是标题栏:拖动它移动窗口,双击它最大化,最小化、最大化和关闭按钮在它的右端。在 macOS 上,红绿灯按钮在菜单栏的左端。在 Linux 上,窗口保留桌面自己的标题栏,并且需要 WebKitGTK 4.1(libwebkit2gtk-4.1),大多数桌面都已经装了。关闭窗口会停止 Studio,有未保存的修改时会先询问。窗口打不开时,比如 Windows 上没有 WebView2、Linux 上没有 WebKitGTK,Studio 会改在浏览器的应用窗口里打开;设置 FRAMESEQ_NO_STUDIO_WINDOW=1 也会这样做。

frameseq 命令能做 CLI 参考里描述的所有事情:

frameseq new talk.fsq
frameseq studio talk.fsq
frameseq pdf talk.fsq

从应用里运行时,frameseq studio 打开的也是这个窗口。

在 macOS 上,这个命令在应用内部。想把它放进 PATH:

sudo ln -s "/Applications/FrameSeq Studio.app/Contents/Resources/frameseq/bin/frameseq" /usr/local/bin/frameseq

VS Code 扩展会在 PATH 上找到应用的 frameseq 命令,就像它找到全局的 npm 安装一样。

导出与浏览器#

PDF、PowerPoint 和 frameseq check 用 Chromium 浏览器渲染。应用按这个顺序寻找浏览器:

1. 环境变量 FRAMESEQ_BROWSER 指定的那个;
2. 应用自带的那个;
3. 电脑上安装的 Chrome、Edge、Chromium 或 Brave。

更新#

应用会自己保持最新。FrameSeq Studio 每天检查一次有没有更新的 FrameSeq,而大多数新版本只改动 FrameSeq 本身,这样的版本应用会自己安装:它从 npm 仓库下载 FrameSeq 的包(几百 KB),验证仓库对它的签名,然后放在应用自己的依赖旁边:Windows 上是 %LOCALAPPDATA%\FrameSeq\updates,macOS 上是 ~/Library/Application Support/FrameSeq/updates,Linux 上是 ~/.local/state/frameseq/updates。新版本从下次启动 FrameSeq Studio 或 frameseq 时开始运行,Studio 也会提示。更新不带任何新程序,只有 FrameSeq 的脚本,由应用自带的 Node.js 运行,所以智能应用控制和 Gatekeeper 没有新东西要检查。应用本身保持安装时的样子。

如果一个版本还改动了应用在 FrameSeq 之外附带的东西,比如 Node.js、Studio 的窗口或某个依赖,它就以新应用的形式发布:Studio 会提示,提示里的 下载 按钮打开发布页。把新版本装在旧版本上即可,装好后之前的更新也就不再使用。

帮助 › 检查更新… 立即检查,帮助 › 自动更新 关闭每天的检查,在终端里用 frameseq update 也能做同样的事;另见 Studio 里的更新。frameseq update --revert 回到安装时的版本,设置 FRAMESEQ_APP_LAYER=installed 则只在这一次启动时运行安装时的版本。

卸载#

在 Windows 上,从 设置 › 应用 卸载 FrameSeq,更新会一起删除。在 macOS 上,把 FrameSeq Studio 移到废纸篓,再删除 ~/Library/Application Support/FrameSeq/updates。在 Linux 上,先运行 frameseq shortcut --remove 把 Studio 从菜单里移除,再删除 ~/.local/share/frameseq、~/.local/bin/frameseq 和 ~/.local/state/frameseq。

用应用还是用 npm?#

两者运行的是同一个 FrameSeq。当演示放在一个有自己依赖的项目里,或者希望编程代理和 CI 像运行其他东西一样运行它时,按快速上手用 npm 安装。如果只想写演示,而不想搭建开发环境,就安装应用。

安装程序目前还没有签名。在开启了智能应用控制的 Windows 11 上,Windows 偶尔会拒绝启动未签名的安装程序,取决于微软在线检查当时的结果;稍后再试一次,或者改用便携版 zip。Studio 的窗口同样没有签名,也可能这样被拒绝。所以开始菜单的快捷方式运行的是有 OpenJS 基金会签名的 Node.js,再由 Node.js 打开窗口;Windows 拒绝窗口时,Studio 改在浏览器的应用窗口里打开,而且在窗口程序改变之前(比如更新之后),FrameSeq 不会再尝试它。在其他 Windows 电脑上,SmartScreen 可能会在运行安装程序前询问(更多信息 › 仍要运行)。macOS 会要求确认第一次打开(在访达里 按住 Control 点按 › 打开)。给安装程序和窗口签名后,这些情况都会消失。

安装程序没有签名,是因为 FrameSeq 是免费的,而代码签名证书要花钱。每个应用都由 Desktop app 工作流从版本标签公开构建,每个版本都在 SHA256SUMS.txt 里列出它的文件的 SHA-256。要核对下载的文件,把它的哈希和这份列表比对:在 PowerShell 里用 Get-FileHash <文件>,在 macOS 上用 shasum -a 256 <文件>;在 Linux 上,在同时放着两者的文件夹里运行 sha256sum --check --ignore-missing SHA256SUMS.txt。

构建应用#

在仓库的检出目录里,node scripts/app-bundle.mjs 为这台电脑构建应用;--platform 和 --arch 为其他平台构建。Windows 安装程序需要 Inno Setup 6,可以用它自己的安装程序、Chocolatey 或 Scoop(scoop install extras/inno-setup)安装;没有它时只生成 zip。

Studio 的窗口是 desktop/ 里的 Tauri 程序,由 node scripts/desktop-build.mjs 用 Rust 构建,构建应用时会自动运行;在 Linux 上还需要 WebKitGTK 的开发文件(libwebkit2gtk-4.1-dev)。它只能在目标系统上构建,所以为其他系统构建的应用、没有 Rust 时构建的应用,或者加了 --no-window 的应用,会在浏览器的应用窗口里打开 Studio。想在检出目录里试用这个窗口,就让它使用检出目录里的命令:

node scripts/desktop-build.mjs
FRAMESEQ_DESKTOP_CLI=scripts/frameseq.mjs desktop/target/release/frameseq-studio talk.slides.ts

推送版本标签时,GitHub Actions 会构建所有平台,并把下载附加到发布页上。见 Release automation(英文)。