使用Capgo在中国

如果您正在将应用程序部署到中国用户，您需要配置 Capgo 以使用区域 OST（对象存储技术）URL，以确保可靠和快速的更新。

为什么使用中国特定的 URL?

由于中国的网络基础设施和监管（长城防火墙），直接连接到国际服务器可能会很慢或不可靠。 Capgo 提供了专用的 OST URL，数据位于香港，以最小化延迟并确保您的用户尽可能快和可靠地接收更新。

配置

要为中国配置 Capgo，您需要在您的 Capacitor 配置文件中设置三个特定的 URL。这些 URL 指向 Capgo 的香港基础设施。

1. 打开您的 capacitor.config.ts 文件

2. 添加以下配置到 CapacitorUpdater 插件部分:

   import { CapacitorConfig } from '@capacitor/cli';
   
   const config: CapacitorConfig = {
     plugins: {
       CapacitorUpdater: {
         autoUpdate: 'atBackground',
         updateUrl: 'https://updater.capgo.com.cn/updates',
         statsUrl: 'https://updater.capgo.com.cn/stats',
         channelUrl: 'https://updater.capgo.com.cn/channel_self',
       },
     },
   };
   
   export default config;

3. 重建您的应用以应用更改:

   npm run build
   npx cap sync

配置详细信息

以下是每个 URL 的作用:

• updateUrl: https://updater.capgo.com.cn/updates - 用于检查并下载可用更新以更新您的应用
• statsUrl: https://updater.capgo.com.cn/stats - 用于向 Capgo 报告分析和使用统计信息
• channelUrl: https://updater.capgo.com.cn/channel_self - 用于检索频道配置并确定哪些更新需要应用

提示

所有三个 URL 必须一起配置才能确保 Capgo 更新器在中国的完整功能

中国的推荐设置

由于中国防火墙网络性能限制，我们对在中国大陆部署的应用有特定的推荐:

增加 API 响应超时

当 API 调用超时时，Capgo 更新器插件会 responseTimeout 超过此值（值以秒为单位） 秒前置于Capgo的边缘基础设施也将大约 秒 视为某些路径的失败预算。

在中国大陆，跨境延迟往往更高。为了让插件有足够的时间完成更新检查和下载， responseTimeout 而不是早期失败，请设置较高的 updater.capgo.com.cn 复制到剪贴板

const config: CapacitorConfig = {
  plugins: {
    CapacitorUpdater: {
      autoUpdate: 'atBackground',
      // Seconds. Raise above the default (20) for China network conditions.
      responseTimeout: 60,
      updateUrl: 'https://updater.capgo.com.cn/updates',
      statsUrl: 'https://updater.capgo.com.cn/stats',
      channelUrl: 'https://updater.capgo.com.cn/channel_self',
    },
  },
};

优先

Prefer responseTimeout: 60 (or higher) for China deployments. A low timeout does not make updates faster — it only causes the plugin to give up while the request may still succeed on Capgo’s side.

使用后台更新

我们 强烈建议在中国使用 autoUpdate: 'atBackground' 中国的网络连接性能不如其他地区，立即应用模式可能会导致下载中断或缓慢，给用户带来糟糕的体验。

相反，使用默认更新行为，让更新在后台下载并在应用后台或重启时应用。这为您的用户提供了更可靠的体验。

const config: CapacitorConfig = {
  plugins: {
    CapacitorUpdater: {
      autoUpdate: 'atBackground', // Recommended for China
      updateUrl: 'https://updater.capgo.com.cn/updates',
      statsUrl: 'https://updater.capgo.com.cn/stats',
      channelUrl: 'https://updater.capgo.com.cn/channel_self',
    },
  },
};

注意

虽然我们的香港基础设施可以帮助减少延迟并提高可靠性，但到中国大陆的网络性能可能会受到“长城”影响。使用后台更新可以确保更新成功完成而不会中断用户体验。

完整配置示例

以下是中国地区应用推荐的完整配置示例:

import { CapacitorConfig } from '@capacitor/cli';

const config: CapacitorConfig = {
  appId: 'com.example.app',
  appName: 'My App',
  webDir: 'dist',
  plugins: {
    CapacitorUpdater: {
      autoUpdate: 'atBackground', // Recommended for better reliability in China
      responseTimeout: 60, // Seconds — give China network more room
      updateUrl: 'https://updater.capgo.com.cn/updates',
      statsUrl: 'https://updater.capgo.com.cn/stats',
      channelUrl: 'https://updater.capgo.com.cn/channel_self',
    },
  },
};

export default config;

测试您的配置

配置了中国特定的URL后，您可以验证更新是否正常工作:

1. 上传一个新的包到 Capgo:

   npx @capgo/cli@latest bundle upload --channel=production

2. 在中国测试设备上安装您的应用

3. 监控更新过程:

   npx @capgo/cli@latest app debug

4. 检查更新是否从中国OST URL下载

注意

更新行为和时间与标准Capgo配置相同。请参阅 更新行为 文档以了解如何和何时应用更新。

多区域部署

如果您的应用同时服务于中国内地和境外用户，您可以使用中国域名配置为全球用户。由于阿里巴巴DNS基础设施域名在全球解析，因此在中国内地和世界其他地方都可以访问。 updater.capgo.com.cn 全球使用中国域名

多区域部署

中国域名URL在多区域应用中无缝工作:

const config: CapacitorConfig = {
  plugins: {
    CapacitorUpdater: {
      autoUpdate: 'atBackground', // Recommended for China users
      updateUrl: 'https://updater.capgo.com.cn/updates',
      statsUrl: 'https://updater.capgo.com.cn/stats',
      channelUrl: 'https://updater.capgo.com.cn/channel_self',
    },
  },
};

此单个配置将适用于:

• 中国大陆用户（使用香港基础设施）
• 中国以外用户（通过阿里巴巴 DNS访问相同的基础设施）

性能考虑:

虽然 .cn 域名通过阿里巴巴 DNS 在全球解析，且在所有地方都有效，但是在中国以外的用户相对于标准域名（api.capgo.app), which is resolved directly by Cloudflare where our backend is hosted. However, DNS resolution is fast, so the performance difference is minimal and won’t significantly impact the user experience.

提示

使用的域名 .cn 域名

简化部署和确保所有地区的更新行为一致

中国以外地区的小性能折衷通常值得简化部署

• Alternative: Region-Specific Configurations
• Alternative: Region-Specific Configurations
• 如果您希望为每个地区优化不同，您也可以考虑

构建不同配置的应用程序 support@capgo.app 为不同地区创建不同的发布频道 如果您需要帮助部署多个地区的策略，请联系我们在support@__CAPGO_KEEP_0__.app或加入我们的Discord社区 中国帮助.

监控中国基础设施.

您可以在此监控Capgo在中国的特定端点的健康状况和状态. capgo.com.cn的状态.. 在此页面上检查中国OST URL的延迟、可用性和故障前，Troubleshooting.

故障排除.

如果您在中国遇到更新问题:

1. 验证您的配置. - 确认您的三个URL是否在您的 capacitor.config.ts
2. 报告 responseTimeout - 使用至少 60 - 在中国使用至少
3. 秒的超时时间以确保插件不会在更新请求仍在进行时中断 - 检查网络连接 updater.capgo.com.cn - 确保您的设备可以访问
4. 域名 - 检查中国状态页面 status.capgo.com.cn 状态.__CAPGO_KEEP_0__.com.cn
5. 是否有任何正在进行中的事件或性能下降 - 检查日志 npx @capgo/cli@latest app debug - 使用
6. 测试更新 - 试试上传一个新包并监控下载过程
7. - 联系支持 - 如果问题持续存在，请联系我们至 support@capgo.app 或加入我们的 Discord 社区 获取帮助

注意

确保使用域名（ .cn domain (updater.capgo.com.cn中国配置时，不使用标准的国际域名。

下一步

• 了解 更新行为 自定义更新时
• 探索 频道 管理不同发布轨迹
• 查看 加密 安全更新

继续使用 Capgo 在中国

如果您正在使用 使用 Capgo 在中国 以计划实时更新的交付方式连接它 Capgo 实时更新 为 Capgo 实时更新 中的产品工作流 概览 概览 功能 功能 更新行为 为__CAPGO_KEEP_0__的更新行为细节 更新类型 为__CAPGO_KEEP_0__的更新类型细节