跳转至

测试构建

每次推送到 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 的数据。两个应用会监听同一个快捷键和麦克风,因此请每次只运行一个。

  1. 从菜单栏图标退出 Hex。
  2. 打开 DMG,将 Hex Test 拖到 Applications(应用程序)文件夹。
  3. 清除下载隔离属性,否则 macOS 会报告该应用无法打开或已损坏:
xattr -dr com.apple.quarantine "/Applications/Hex Test.app"

或者,先打开一次,然后在系统设置 → 隐私与安全性中选择仍要打开。 4. 打开 Hex Test 并重新授予麦克风和辅助功能权限。由于 ad-hoc 签名会随每次构建变化,因此每个新的测试构建都需要重新授予这些权限:在系统设置中移除旧的 Hex Test 条目,然后添加新的应用。

若要恢复使用正式版,请退出 Hex Test,删除它,然后打开 Hex。

Windows(10 或 11,x64 或 ARM64)

安装程序和可执行文件未签名,因此 SmartScreen 会发出警告:请选择更多信息,然后选择仍要运行。

  1. 从托盘图标退出 Hex。
  2. 运行 hex-setup-<version>-windows-<x64|arm64>.exe。它会替换通常的按用户安装布局中相同或更旧版本的已安装 Hex,并拒绝替换更新版本:请先从“应用和功能”中卸载该更新版本(设置会保留)。或者跳过安装程序,直接从任意文件夹运行独立的 hex-<version>-windows-<arch>.exe。
  3. 测试构建永远不会自行更新。要恢复正式版,请从 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