Capgo을 사용하여 중국

이 플러그인의 설치 단계와 전체 마크다운 가이드를 포함한 설정 지시서를 복사하세요.

중국에서 앱을 사용자에게 배포하려면 Capgo을 중국 지역 OST (Object Storage Technology) URL을 사용하여 신뢰할 수 있고 빠른 업데이트를 보장하기 위해 구성해야 합니다.

중국-특정 URL을 사용하는 이유

중국(대치 벽)의 네트워크 인프라 및 규제로 인해 직접 국제 서버에 연결하는 경우 속도 또는 신뢰성이 느려질 수 있습니다. Capgo은 홍콩에 위치한 데이터를 사용하여 지연 시간을 최소화하고 사용자가 가능한 한 신속하고 신뢰할 수 있는 업데이트를 받을 수 있도록 하는 데드icated OST URL을 제공합니다.

설정

중국을 위해 Capgo을 구성하려면 Capacitor 구성 파일에서 세 개의 특정 URL을 설정해야 합니다. 이 URL은 Capgo의 홍콩 기반 인프라를 가리킵니다.

파일을 열어 capacitor.config.ts 파일

__CAPGO_KEEP_0__을 다음 설정으로 추가하세요. 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;

__CAPGO_KEEP_2__ 앱을 다시 빌드하여 변경 사항을 적용하세요.
__CAPGO_KEEP_3__ 창
```
npm run build
npx cap sync
```

__CAPGO_KEEP_4__ 세부 정보

__CAPGO_KEEP_5__ URL은 다음과 같이 작동합니다.

__CAPGO_KEEP_6__ - 앱에 사용 가능한 업데이트를 확인하고 다운로드하는 데 사용됩니다.: https://updater.capgo.com.cn/updates updateUrl
statsUrl: https://updater.capgo.com.cn/stats - Capgo에 대한 분석 및 사용 통계를 보고하기 위해 사용됩니다.
channelUrl: https://updater.capgo.com.cn/channel_self - __CAPGO_KEEP_0__ 업데이터의 업데이트를 적용하기 위해 채널 구성 정보를 가져옵니다.

중국에서 권장되는 설정

중국 본토에 배포된 앱의 네트워크 성능 제한으로 인해 중국 대륙에서 발생하는 Great Firewall of China로 인한 특정 추천 사항이 있습니다.

배경 업데이트를 사용하세요

We strongly recommend using autoUpdate: 'atBackground' for apps in China. 중국 내 네트워크 연결성은 다른 지역보다 느립니다. 다운로드가 중단되거나 느려지면 instant apply 모드에서는 사용자 경험에 부정적인 영향을 줄 수 있습니다.

대신, 업데이트 다운로드가 백그라운드에서 진행되고 앱이 백그라운드나 재시작할 때 적용되도록 기본 업데이트 동작을 사용하세요. 이 방법은 사용자 경험에 영향을 주지 않고 업데이트 완료를 보장해주는 더 신뢰할 수 있는 경험을 제공합니다.

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',
    },
  },
};

Complete Configuration Example

중국에 배포된 앱에 대한 권장 설정과 함께 완전한 예제입니다.

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;

__CAPGO_KEEP_0__

__CAPGO_KEEP_2__

Upload a new bundle to Capgo:

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

__CAPGO_KEEP_6__
__CAPGO_KEEP_7__
__CAPGO_KEEP_8__
```
npx @capgo/cli@latest app debug
```
__CAPGO_KEEP_10__

다중 지역 배포

앱이 중국 내 및 중국 외부의 사용자를 모두 대상으로 한다면, 모든 사용자에게 중국 도메인 설정을 사용할 수 있습니다. 알리바바 DNS 인프라로 인해 도메인은 전 세계적으로 해결되며, 중국 내 및 전 세계 어디서든 접근할 수 있습니다. updater.capgo.com.cn 세계적으로 중국 도메인 사용

다중 지역 앱에서 중국 도메인 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',
    },
  },
};

This single configuration will work for:

중국 본토 사용자 (홍콩 기반 인프라를 사용하는 사용자)
중국 외부 사용자 (중국 본토 사용자와 동일한 인프라를 Alibaba DNS를 통해 접근하는 사용자)

성능 고려 사항:

domain이 Alibaba 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.

Alternative: Region-Specific Configurations

각 지역을 최적화하는 방법이 다른 경우, 다른 지역에 맞는 설정을 고려해 볼 수도 있습니다.

다른 지역에 맞는 앱 버전을 만들기 위해 별도의 설정을 사용하는 방법
환경에 따라 URL을 동적으로 설정하기 위해 환경 기반 설정을 사용하는 방법
다른 지역에 맞는 릴리스 채널을 만들기 위해

다중 지역 배포 전략에 도움을 필요로하신다면, __CAPGO_KEEP_0__.app의 support@로 연락주시거나 support@capgo.app 문제 해결 문제 해결 Section titled “Troubleshooting”

Section titled “Troubleshooting”

중국에서 업데이트와 관련된 문제가 발생하는 경우:

설정 확인 - 모든 세 개의 URL이 올바르게 설정되어 있는지 확인하세요. capacitor.config.ts
네트워크 연결 확인 - 장치가 업데이트를 다운로드할 수 있는지 확인하세요. updater.capgo.com.cn 도메인
로그 확인 - 에러 메시지를 확인하기 위해 npx @capgo/cli@latest app debug 업데이트 테스트
- 새로운 번들을 업로드하고 다운로드 프로세스를 모니터링하세요. 지원팀에 문의하세요.
__CAPGO_KEEP_0__ - 문제가 지속되면 __CAPGO_KEEP_0__.app의 support@capgo.app 또는 중국을 위한 구성 시 domain ( )

)

Learn about 업데이트 동작을 업데이트가 적용되는 시기를 __CAPGO_KEEP_0__으로 조정할 수 있습니다.
Explore 채널 다양한 릴리스 트랙을 관리할 수 있습니다.
Review 암호화 업데이트를 보안할 수 있습니다.

Keep going from Using Capgo in China

If you are using __CAPGO_KEEP_0__ in China, Capgo을 중국에서 사용하여 __CAPGO_KEEP_0__을 연결하여 Capgo Live Updates Capgo Live Updates에서 제품 워크플로우에 개요 개요 구현 세부 정보에 기능 기능 구현 세부 정보에 업데이트 동작 업데이트 동작 구현 세부 정보에 업데이트 유형 업데이트 유형 구현 세부 정보에