自定义域名
复制包含安装步骤和该插件完整 Markdown 指南的配置 prompt。
使用您自己的主机名,例如 updates.example.com,用于处理您应用的 Live Update API 请求,同时 Capgo 继续管理您的渠道、bundle 和发布。
自定义域名功能适用于 企业版套餐。组织管理员可以在 Console 中添加 Live Update API 主机名,发布提供的 DNS 记录,并检查其激活状态。
1. 添加自定义域名
标题为“1. 添加自定义域名”的章节- 打开 Capgo 控制台 并选择您的组织。
- 前往 设置 → 组织 → 常规 并找到 自定义域名。您需要拥有更新组织设置的权限,以及有效的 Enterprise 套餐才能添加域名。
- 输入主机名,例如
updates.example.com,不能包含https://、路径或通配符。 - 点击 添加域名。Console 会显示需要发布的 DNS 记录,以及一个 待验证 状态。
每个组织只能配置一个 Live Updates API 主机名。您必须能够编辑其 DNS 记录。
如果 自定义域名 该选项不可用,请联系您的企业支持联系人或发送邮件至 support@capgo.app 并附上您的组织、应用 ID、期望的主机名以及 DNS 提供商。如果您需要 特定的数据驻留区域 或用于 bundle 下载的自定义主机名,请在配置前联系支持团队。
2. 配置 DNS 并验证 HTTPS
章节标题为“2. 配置 DNS 并验证 HTTPS”在 DNS 提供商处,添加 Console 中显示或由支持团队提供的记录。请原样复制记录类型、名称和值,包括 CNAME 以及任何所有权或证书验证 TXT 记录。点击 Console 中的值即可复制。如果你使用 Cloudflare DNS,请将 CNAME 保持为 仅 DNS 除非支持团队确认了其他设置。
请使用提供的目标地址,不要想当然地认为指向 plugin.capgo.app 的 CNAME 就够了。域名使用期间请保留这些 DNS 记录。
DNS 传播完成后,点击 刷新状态。控制台显示 活跃 仅在主机名及其 HTTPS 证书均处于激活状态时;随后提供 复制更新器配置。如需支持协助配置,请联系支持确认激活。你也可以通过以下命令检查 DNS 并验证 TLS 连接:
dig updates.example.comcurl -v https://updates.example.com/updates替换 updates.example.com 使用你已配置的主机名。该 curl 命令会检查 DNS、TLS 和 HTTP 连接;对 /updates 的 GET 请求不是有效的更新检查,可能会返回 API 错误。请在步骤 4 中使用原生测试构建验证实际的更新流程。
3. 配置更新器
标题为“3. 配置更新器”的章节域名激活后,从控制台复制更新器配置,并将三个 URL 全部合并到 capacitor.config.ts。对于已按标准 Capgo API 路径配置的主机名,请使用:
import type { CapacitorConfig } from '@capacitor/cli';
const config: CapacitorConfig = { appId: 'com.example.app', appName: 'My App', webDir: 'dist', plugins: { CapacitorUpdater: { autoUpdate: 'atBackground', updateUrl: 'https://updates.example.com/updates', statsUrl: 'https://updates.example.com/stats', channelUrl: 'https://updates.example.com/channel_self', }, },};
export default config;请将示例 URL 替换为控制台显示或支持团队确认的准确 URL。保留现有的应用设置和其他插件选项。
| 设置 | 用途 |
|---|---|
updateUrl | 检查是否有可用的 bundle。 |
statsUrl | 上报更新统计信息。 |
channelUrl | 处理设备 channel 操作。 |
4. 同步、测试和发布
标题为“4. 同步、测试和发布”的章节将配置同步到您的原生项目中:
npx cap sync构建并安装原生测试版本,然后:
- 将测试 bundle 上传到 测试通道 使用你平常的 Capgo 工作流。
- 检查原生设备日志,确认更新请求能到达你的自定义主机名,并且 bundle 能成功下载和安装。
- 确认更新统计信息出现在 Console 中;如果你的应用用到了测试通道相关操作,也一并测试。
- 通过你平常的应用商店分发流程发布新的原生应用版本。
旧的原生安装会继续使用其配置的端点 URL,直到用户安装新的原生版本。更新器的默认主机名为 plugin.capgo.app,由 Capgo 管理。如果你正从你控制的另一个自定义主机名迁移,请保持其 DNS 记录和服务处于启用状态,直到这些用户完成迁移。Channels、bundle 上传和回滚仍会使用你平常的 Capgo Console 和 CLI 工作流。
故障排除
“故障排除”章节要移除域名,请使用 移除域名 → 确认移除 在 Organization 设置中。请先发布一个使用替代端点的原生应用版本,并让用户完成迁移:旧安装将无法再通过已移除的主机名访问。请在删除其所属 Organization 之前移除该域名。
- DNS 解析失败: 请核对记录名称和目标值是否与支持团队提供的一致,并检查 DNS 提供商的解析生效情况。
- HTTPS 失败: 在发布 Native Build 之前,请联系支持团队检查主机名激活和证书签发情况。
- 请求仍在使用
plugin.capgo.app: 请确认这三个 URL,运行npx cap sync,重新构建并安装新的原生版本。 - Bundle 下载使用的是其他主机名: 更新响应中会提供下载 URL。如需自定义 Bundle 交付方式,请咨询支持团队,或查看 自定义存储 如果你想自行管理 Bundle 存储。
- HTTPS 正常但更新失败: 共享应用 ID、通道、原生版本、请求时间戳和原生日志给 Capgo 支持.