You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Download the installer or bundle for your platform from the assets below.
66
127
67
-
Development and manual verification currently happen on Windows. macOS and Linux artifacts are built by CI but have not been manually tested by the developer yet.
128
+
Development and manual verification currently happen on Windows.
129
+
130
+
macOS notes:
131
+
- Normal launch of downloaded macOS apps requires Developer ID signing and Apple notarization.
132
+
- This workflow produces notarized macOS artifacts only when APPLE_CERTIFICATE, APPLE_CERTIFICATE_PASSWORD, KEYCHAIN_PASSWORD, APPLE_ID, APPLE_PASSWORD, and APPLE_TEAM_ID repository secrets are configured.
133
+
- If those secrets are missing, macOS artifacts are ad-hoc signed CI test builds and Gatekeeper may report that OpenPet is damaged or cannot be verified.
134
+
- Apple Silicon and Intel builds are separate assets; download the asset matching your Mac.
135
+
136
+
Linux notes:
137
+
- Linux .deb, .rpm, and AppImage artifacts are built by CI but have not been manually runtime-tested by the developer yet.
For most users, install a packaged build for your platform from [GitHub Releases](https://github.com/X-T-E-R/OpenPet/releases) and launch OpenPet. The pet appears on your desktop, can be dragged to the position you want, and can be configured from the pet right-click menu or the app tray/menu.
15
+
For most Windows users, install a packaged build from [GitHub Releases](https://github.com/X-T-E-R/OpenPet/releases) and launch OpenPet. The pet appears on your desktop, can be dragged to the position you want, and can be configured from the pet right-click menu or the app tray/menu.
16
16
17
17
Release builds are generated for Windows, macOS, and Linux. Development and manual verification currently happen on Windows; macOS and Linux packages are built by CI but have not been manually tested by the developer yet.
18
18
19
+
### Platform Status
20
+
21
+
- Windows: primary manually verified platform.
22
+
- macOS: CI builds Apple Silicon and Intel artifacts separately. Normal launch of a downloaded macOS app requires Apple Developer ID signing and notarization; if the release was built without those credentials, Gatekeeper may show that OpenPet is damaged or cannot be verified. Treat unsigned macOS artifacts as tester builds, not production-ready distribution.
23
+
- Linux: CI builds `.deb`, `.rpm`, and `.AppImage` artifacts on Ubuntu, but runtime behavior has not been manually verified yet.
24
+
19
25
To run from source:
20
26
21
27
```powershell
@@ -153,6 +159,8 @@ pnpm release:check
153
159
pnpm release:bundle
154
160
```
155
161
162
+
macOS release distribution needs Apple Developer ID signing and notarization. Configure `APPLE_CERTIFICATE`, `APPLE_CERTIFICATE_PASSWORD`, `KEYCHAIN_PASSWORD`, `APPLE_ID`, `APPLE_PASSWORD`, and `APPLE_TEAM_ID` repository secrets before publishing macOS artifacts for normal end users; otherwise the workflow falls back to ad-hoc signed CI artifacts that Gatekeeper may block.
163
+
156
164
## Safety And Rights
157
165
158
166
- The control API defaults to `127.0.0.1` and is intended for tools running on the same machine. Use `0.0.0.0` only for trusted local-network workflows.
Windows 普通用户可以从 [GitHub Releases](https://github.com/X-T-E-R/OpenPet/releases)下载打包版本后直接启动 OpenPet。桌宠会显示在桌面上,可以拖到你想要的位置,设置页可以从桌宠右键菜单或应用托盘 / 菜单打开。
16
16
17
17
Release 会为 Windows、macOS 和 Linux 生成构建产物。当前开发与手动验证主要在 Windows 环境完成;macOS 和 Linux 包由 CI 构建,但开发者尚未手动测试。
18
18
19
+
### 平台状态
20
+
21
+
- Windows:当前主要手动验证平台。
22
+
- macOS:CI 会分别构建 Apple Silicon 和 Intel 产物。macOS 从网络下载的应用要正常打开,需要 Apple Developer ID 签名和 Apple 公证;如果 release 构建时没有这些凭据,Gatekeeper 可能提示 OpenPet 已损坏或无法验证。
macOS 正式分发需要 Apple Developer ID 签名和公证。发布面向普通用户的 macOS 产物前,需要在仓库 secrets 配置 `APPLE_CERTIFICATE`、`APPLE_CERTIFICATE_PASSWORD`、`KEYCHAIN_PASSWORD`、`APPLE_ID`、`APPLE_PASSWORD` 和 `APPLE_TEAM_ID`;否则 workflow 会退回到 ad-hoc signed CI 测试产物,Gatekeeper 仍可能拦截。
163
+
156
164
## 安全与权利提醒
157
165
158
166
- 控制 API 默认绑定 `127.0.0.1`,适合由同一台机器上的工具调用。只有受信任的本地网络工作流需要时才使用 `0.0.0.0`。
0 commit comments