在中国使用 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: true,
         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

Section titled “配置详细信息”

以下是每个 URL 的功能：

• __CAPGO_KEEP_0__: https://updater.capgo.com.cn/updates - 用于检查并下载应用程序的可用更新
• __CAPGO_KEEP_0__: https://updater.capgo.com.cn/stats - 用于将分析和使用统计数据发送回Capgo
• __CAPGO_KEEP_0__: https://updater.capgo.com.cn/channel_self - 用于检索通道配置并确定要应用的更新

提示

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

中国的推荐设置

由于中国大陆地区网络性能限制，受到中国防火墙的影响，我们对在中国大陆部署的应用程序有特定的建议：

禁用直接更新

我们 强烈建议 directUpdate 在中国的应用程序中禁用。中国地区的网络连接性能低于其他地区，直接更新（立即应用）可能会导致下载中断或缓慢，导致用户体验不佳。

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

const config: CapacitorConfig = {
  plugins: {
    CapacitorUpdater: {
      autoUpdate: true,
      directUpdate: false, // 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',
    },
  },
};

注意

虽然我们的香港基础设施可以减少延迟并提高可靠性，但中国大陆地区的网络性能仍然受到中国防火墙的影响。禁用 directUpdate 可以确保更新成功完成，而不会干扰用户体验。

完整配置示例

以下是针对在中国部署的应用程序的推荐设置的完整示例：

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

const config: CapacitorConfig = {
  appId: 'com.example.app',
  appName: 'My App',
  webDir: 'dist',
  plugins: {
    CapacitorUpdater: {
      autoUpdate: true,
      directUpdate: false, // Recommended: disable for better reliability in China
      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;

测试您的配置

上传一个新的捆绑包到__CAPGO_KEEP_0__:

1. Upload a new bundle to Capgo:

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

2. 监控更新过程：

3. 在终端窗口中复制

   npx @capgo/cli@latest app debug

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

注意

更新行为和时间与标准Capgo配置相同。有关如何和何时应用更新的详细信息，请参阅 更新行为 文档

多区域部署

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

全球使用中国域名

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

const config: CapacitorConfig = {
  plugins: {
    CapacitorUpdater: {
      autoUpdate: true,
      directUpdate: false, // 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 访问相同的基础设施）

性能考虑：

虽然域名通过阿里巴巴 DNS 在全球解析，且在全球都能正常工作，但在中国以外地区的用户相对于标准域名（ .cn )可能会有略微的性能差异，因为标准域名直接由 __CAPGO_KEEP_0__ 解析，而我们的后端位于此处。然而，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:根据地区配置

如果您希望针对每个地区优化不同，请考虑：

• 为每个地区构建具有不同配置的应用程序变体
• 使用环境配置动态设置URL
• 为不同地区创建不同的发布频道

如果您需要帮助部署多个地区的策略，请联系我们 support@capgo.app 或加入我们的 Capgo社区 获取帮助。

故障排除

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

1. 验证您的配置 - 确保您在应用中正确设置了所有三个URL capacitor.config.ts
2. 检查网络连接 - 确保您的设备可以访问 updater.capgo.com.cn 域名
3. 查看日志 - 使用 npx @capgo/cli@latest app debug 检查错误消息
4. 测试更新 - 请尝试上传一个新包并监控下载过程
5. 联系支持 - 如果问题持续存在，请联系我们 support@capgo.app 或加入我们的 Discord 社区 获取帮助

注意

确保使用 .cn 域名（updater.capgo.com.cn)，而不是标准的国际域名，用于配置中国。

下一步

• 了解更多 更新行为 定制更新应用的时机
• 探索 频道 管理不同发布跟踪
• 查看 加密 __CAPGO_KEEP_0__ 协议概述