使用Capgo在中国

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

使用中国特定URL的原因

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

配置

To configure Capgo for China, you need to set three specific URLs in your Capacitor configuration file. These URLs point to Capgo’s Hong Kong-based infrastructure.

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 在中国的更新器功能正常

中国的推荐设置

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

后台更新

对于中国的应用程序。中国的网络连接性能低于其他地区，立即应用模式可能会导致用户体验不佳，如果下载被中断或缓慢。 相反，使用默认的更新行为，更新在后台下载并在应用程序后台或重启时应用。这为您的用户提供了更可靠的体验。 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',
    },
  },
};

__CAPGO_KEEP_0__

While our Hong Kong-based infrastructure helps minimize latency and improve reliability, network performance to mainland China can still be affected by the Great Firewall. Using background updates helps ensure updates complete successfully without disrupting the user experience.

完整配置示例

以下是针对中国地区的完整配置示例:

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
      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配置相同。请参阅 更新行为 文档以了解如何和何时应用更新。

多区域部署

如果您的应用服务用户既在中国又在全球范围内，所有用户都可以使用中国域名配置。 updater.capgo.com.cn 由于阿里巴巴 DNS 基础设施的全球解析，域名在中国境内和全球范围内都可以访问。

全球使用中国域名

中国域名 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: 区域特定配置

如果您愿意为每个地区优化不同，您也可以考虑：

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

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

故障排除

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

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下一步

关于

• 更新行为 来定制更新时的应用 探索
• 频道 来管理不同发布轨迹 查看
• Review 加密 为您的更新提供安全

继续使用Capgo在中国

如果您正在使用 使用Capgo在中国 为直播更新计划进行交付时，连接它到 Capgo直播更新 在Capgo直播更新中， 概述 概述 功能 Features 实现细节 更新行为 更新类型 更新类型 编辑页面