在中国使用 Capgo

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

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

由于中国的网络基础设施和法规(防火长城),直接连接到国际服务器可能会很慢或不可靠。Capgo 提供专用的 OST URL,数据位于香港,以最大限度地减少延迟并确保您的用户尽可能快速可靠地接收更新。

配置

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

打开您的 capacitor.config.ts 文件

将以下配置添加到 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;

重新构建您的应用以应用更改:
Terminal window
```
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 - 用于检索渠道配置并确定要应用哪些更新

中国推荐设置

由于中国防火长城造成的网络性能限制,我们对部署在中国大陆的应用有具体建议:

禁用直接更新

我们强烈建议为中国的应用禁用 directUpdate。中国的网络连接性能不如其他地区,直接更新(立即应用)在下载中断或缓慢时可能会导致糟糕的用户体验。

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

const config: CapacitorConfig = {
  plugins: {
    CapacitorUpdater: {
      autoUpdate: true,
      directUpdate: false, // 推荐用于中国
      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, // 推荐:禁用以在中国获得更好的可靠性
      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 后,您可以验证更新是否正常工作:

将新 bundle 上传到 Capgo:

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

在中国的测试设备上安装您的应用
监控更新过程:
Terminal window
```
npx @capgo/cli@latest app debug
```
检查是否从中国 OST URL 下载更新

多区域部署

如果您的应用为中国境内和境外的用户提供服务,您可以为全球所有用户使用中国域配置。由于阿里巴巴 DNS 基础设施,updater.capgo.com.cn 域在全球范围内解析,使其可在中国境内和世界其他地方访问。

在全球使用中国域

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

const config: CapacitorConfig = {
  plugins: {
    CapacitorUpdater: {
      autoUpdate: true,
      directUpdate: false, // 推荐用于中国用户
      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 解析很快,因此性能差异很小,不会显著影响用户体验。

替代方案:区域特定配置

如果您希望为每个区域进行不同的优化,您还可以考虑:

使用不同配置构建单独的应用变体
使用基于环境的配置动态设置 URL
为不同区域创建不同的发布渠道

如果您需要有关多区域部署策略的帮助,请通过 support@capgo.app 联系我们或加入我们的 Discord 社区寻求帮助。

故障排除

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

验证您的配置 - 仔细检查所有三个 URL 是否在您的 capacitor.config.ts 中正确设置
检查网络连接 - 确保您的设备可以访问 updater.capgo.com.cn 域
查看日志 - 使用 npx @capgo/cli@latest app debug 检查错误消息
测试更新 - 尝试上传新 bundle 并监控下载过程
联系支持 - 如果问题仍然存在,请通过 support@capgo.app 联系我们或加入我们的 Discord 社区寻求帮助

后续步骤

了解更新行为以自定义何时应用更新
探索渠道以管理不同的发布轨道
查看加密以保护您的更新