SuperAPI AI 工具集

oasis-server-setup

通用与其它

查看项目

更新于 10-16 03:44

技能介绍

用途:为 Tauri 桌面应用接入 Oasis 自托管更新服务器,实现自动更新、崩溃上报和用户反馈收集。

主要能力:Oasis 提供更新清单接口(GET /{app_slug}/update/{target}-{arch}/{version}),返回各平台签名与下载地址,无更新时返回 HTTP 204;崩溃上报(POST /sdk/{app_slug}/crashes)与反馈提交(POST /sdk/{app_slug}/feedback);发布注册(POST /api/releases/{app_slug},仅 CI 使用)。发行产物存于 Cloudflare R2 CDN。

使用方式:先用 npx @tauri-apps/cli signer generate -w ~/.tauri/keys/your-app.key 生成签名密钥,在 tauri.conf.json 的 plugins.updater 中配置 pubkey 与 endpoints(含 {{target}}、{{arch}}、{{current_version}} 模板变量),并在 capabilities/default.json 添加 updater:default、updater:allow-check、updater:allow-download-and-install、process:default、process:allow-restart 权限。安装 pnpm add @oasis/sdk 后用 initOasis 初始化,配置 apiKey、serverUrl、appVersion、enableAutoCrashReporting 等。SDK 提供 feedback.submit/reportBug/requestFeature/sendFeedback、crashes.captureException、breadcrumbs 与 setUser 等方法。

适用场景:需要自托管发布管理、跨平台自动更新与遥测的 Tauri 应用。

限制与注意事项:客户端公钥格式为 pk_{app-slug}{random},CI 密钥格式为 ci{app-slug}_{random},后者不可暴露。必须使用双花括号模板变量;版本号须为 semver(如 0.1.0);app slug 需在 workflow、SDK 与服务器注册中保持一致;R2 URL 须可公开访问;签名在客户端校验。SDK 各配置项默认值与更多服务器部署细节(如托管、数据库等)资料未提供。