测试构建¶
每次推送到 dev 都会运行 Test builds
工作流(.github/workflows/test-builds.yml;也可以手动点击 运行工作流
来运行)。打开最近一次绿色(成功)的运行:其摘要中会链接到每个下载。
构建产物保留 14 天;下载需要登录 GitHub 且拥有该仓库的访问权限。
hex-test-<commit>-macos-arm64 // hex-test-<commit>-arm64.dmg
hex-test-<commit>-windows-x86_64 // hex-setup-<version>-windows-x64.exe + bare hex-<version>-windows-x64.exe
hex-test-<commit>-windows-aarch64 // hex-setup-<version>-windows-arm64.exe + bare hex-<version>-windows-arm64.exe
hex-test-<commit>-linux-x86_64 // hex-<version>-linux-x64
这些构建均未经过代码签名、公证或发布。它们永远不会自行更新,因此已签名的正式版不会替换你正在测试的构建。 GitHub 会将每个构建产物打包成 zip;请先解压。
macOS(Apple silicon,macOS 15 或更高版本)¶
测试应用是 Hex Test.app(Bundle ID anomaly.hex.test),使用 ad-hoc 签名,且从不检查更新。
它使用自己的名称和 Bundle ID,因此可以与已发布的 Hex.app 并存,而不会影响该应用的权限、登录项或更新。
它也保留自己的数据:设置、模型、历史记录和会议数据位于 ~/Library/Application Support/hex-test,个人命令位于
~/.config/hex-test,会议 Markdown 位于 ~/Documents/Hex Test Meetings,因此它会从首次启动引导开始,
并且绝不会读取或更改已安装 Hex 的数据。两个应用会监听同一个快捷键和麦克风,因此请每次只运行一个。
- 从菜单栏图标退出 Hex。
- 打开 DMG,将 Hex Test 拖到 Applications(应用程序)文件夹。
- 清除下载隔离属性,否则 macOS 会报告该应用无法打开或已损坏:
或者,先打开一次,然后在系统设置 → 隐私与安全性中选择仍要打开。 4. 打开 Hex Test 并重新授予麦克风和辅助功能权限。由于 ad-hoc 签名会随每次构建变化,因此每个新的测试构建都需要重新授予这些权限:在系统设置中移除旧的 Hex Test 条目,然后添加新的应用。
若要恢复使用正式版,请退出 Hex Test,删除它,然后打开 Hex。
Windows(10 或 11,x64 或 ARM64)¶
安装程序和可执行文件未签名,因此 SmartScreen 会发出警告:请选择更多信息,然后选择仍要运行。
- 从托盘图标退出 Hex。
- 运行
hex-setup-<version>-windows-<x64|arm64>.exe。它会替换通常的按用户安装布局中相同或更旧版本的已安装 Hex,并拒绝替换更新版本:请先从“应用和功能”中卸载该更新版本(设置会保留)。或者跳过安装程序,直接从任意文件夹运行独立的hex-<version>-windows-<arch>.exe。 - 测试构建永远不会自行更新。要恢复正式版,请从 https://anoma.ly/hex 运行正式版安装程序。
Linux(x86_64)¶
已安装的 Hex 通过 systemd 用户单元启动,因此正常启动测试二进制文件只会启动已安装的版本。请改为直接将测试二进制文件作为实例运行:
hex quit
chmod +x hex-*-linux-x64
./hex-*-linux-x64 service # runs Hex in the foreground; Ctrl-C quits
./hex-*-linux-x64 # in another terminal: opens the window
按 Ctrl-C 后,hex 会再次启动已安装的 Hex。
报告问题¶
请在报告中包含构建产物名称中的提交哈希、操作系统和架构,以及日志:macOS 为 ~/Library/Application Support/hex/logs/,Windows 为 %LOCALAPPDATA%\hex\logs\,Linux 为 ~/.local/share/hex/logs/。
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 hex19/hex