跳过内容
Capgo - Capacitor 应用程序的实时更新 Capgo

在中国使用 Capgo

If you’re deploying your app to users in China, you’ll need to configure Capgo to use regional OST (Object Storage Technology) URLs to ensure reliable and fast updates.

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

Section titled “为什么使用中国特定的URL?”

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

配置

Section titled “配置”

为了在中国配置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

配置详细信息

标题为“配置详细信息”的部分

以下是每个 URL 的作用：

  • __CAPGO_KEEP_0__: https://updater.capgo.com.cn/updates - 用于检查并下载应用的可用更新
  • - 用于将分析和使用统计信息报告回__CAPGO_KEEP_0__: https://updater.capgo.com.cn/stats - Used to report analytics and usage statistics back to Capgo
  • statsUrl: https://updater.capgo.com.cn/channel_self - 用于将分析和使用统计信息报告回__CAPGO_KEEP_0__
中国的推荐设置

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

禁用直接更新

我们强烈建议

对于中国的应用程序禁用 由于中国的网络连接性能低于其他地区，直接更新（立即应用）可能会导致下载中断或缓慢，导致用户体验不佳。 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',
    },
  },
};

完整配置示例

标题：完整配置示例

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

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;

测试您的配置

标题：测试您的配置

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

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

    终端窗口
    npx @capgo/cli@latest bundle upload --channel=production

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

  3. 监控更新过程：

    终端窗口
    npx @capgo/cli@latest app debug

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

多区域部署

多区域部署

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

全球使用中国域名

中国域名 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 访问相同的基础设施）
  • Copy to clipboard

性能考虑：

虽然 .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.

域名可以简化您的部署并确保所有地区的更新行为一致。您不需要单独的构建或环境配置。中国以外地区的小性能差异通常值得简化部署的好处。

替代方案：区域特定配置

标题为“替代方案：区域特定配置”

  • 如果您希望根据每个地区优化，请考虑：
  • 使用基于环境的配置动态设置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社区 获取帮助

关于下一步

了解