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

中国的推荐设置

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

后台更新

强烈建议使用 对于中国的应用程序。中国的网络连接性能低于其他地区，立即应用模式可能会导致用户体验不佳，如果下载被中断或缓慢。 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',
    },
  },
};

注意：

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），后者直接由 Cloudflare 解析，后端服务位于此处。然而，DNS 解析速度快，性能差异很小，用户体验不会受到重大影响。

提示

使用 .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. Test updates - 尝试上传新包并监控下载过程
5. Contact support - 如果问题持续存在，请联系我们在 support@capgo.app 或加入我们的 Discord 社区 获取帮助

Caution

确保在配置中国时使用域（”，”）而不是标准国际域名。 .cn 下一步updater.capgo.com.cn名为“下一步”的部分

了解

• 以自定义更新应用时的方式 探索 频道
• 以管理不同发布轨道的方式 查看 Review
• Review 加密 为了安全你的更新

继续使用Capgo在中国

如果你正在使用 使用Capgo在中国 计划实时更新的交付,连接它与 Capgo实时更新 在Capgo实时更新中, __CAPGO_KEEP_0__实时更新概述 __CAPGO_KEEP_0__实时更新的实现细节 功能 Features 实现细节 更新行为 更新类型 更新类型 编辑页面