중국에서 Capgo 사용

설치

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

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

Due to network infrastructure and regulations in China (the Great Firewall), direct connections to international servers can be slow or unreliable. Capgo provides dedicated OST URLs with data located in Hong Kong to minimize latency and ensure your users receive updates as quickly and reliably as possible.

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

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.

__CAPGO_KEEP_1__ capacitor.config.ts 파일

다음 설정을 플러그인 섹션에 추가하세요: 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;

터미널 창
클립보드 복사
```
npm run build
npx cap sync
```

설정 세부 정보

업데이트 URL

- 앱의 업데이트를 확인하고 다운로드할 수 있는 업데이트를 다운로드합니다.: https://updater.capgo.com.cn/updates 업데이트를 다운로드합니다.
통계 URL: https://updater.capgo.com.cn/stats Capgo에 분석 및 사용 통계를 보고하기 위해 사용됩니다.
채널 URL: https://updater.capgo.com.cn/channel_self __CAPGO_KEEP_0__ 업데이트를 적용할 업데이트를 결정하기 위해 채널 구성 정보를 가져옵니다.

중국 설정 추천

__CAPGO_KEEP_0__ 응답 시간을 증가

Increase API Response Timeout

The Capgo 업데이터 플러그인은 API 호출을 중단합니다. responseTimeout 는 초과되면 (값은 초)Cloudflare의 에지 인프라 앞에 Capgo도 약 3초를 실패 기준으로 간주합니다. 대륙 중국에서, 국경 횡단 지연 시간은 종종 더 높습니다. __CAPGO_KEEP_0__ 업데이터 플러그인이 업데이트를 확인하고 다운로드를 완료할 충분한 시간을 확보하기 위해, 대신에 일찍 실패하는 대신

복사 responseTimeout 팁 updater.capgo.com.cn 팁

const config: CapacitorConfig = {
  plugins: {
    CapacitorUpdater: {
      autoUpdate: 'atBackground',
      // Seconds. Raise above the default (20) for China network conditions.
      responseTimeout: 60,
      updateUrl: 'https://updater.capgo.com.cn/updates',
      statsUrl: 'https://updater.capgo.com.cn/stats',
      channelUrl: 'https://updater.capgo.com.cn/channel_self',
    },
  },
};

Use Background Updates

We 중국 앱에 대해 강력히 추천합니다. 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',
    },
  },
};

완전한 구성 예제

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

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
      responseTimeout: 60, // Seconds — give China network more room
      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을 구성한 후 업데이트가 올바르게 작동하는지 확인하려면:

Capgo에 새로운 번들을 업로드하세요:
터미널 창
```
npx @capgo/cli@latest bundle upload --channel=production
```
중국에 테스트 장치를 설치한 후 앱을 설치하세요
업데이트 프로세스를 모니터링하세요:
터미널 창
```
npx @capgo/cli@latest app debug
```
중국 OST URL에서 업데이트가 다운로드되는지 확인합니다.

다중 지역 배포

중국 내의 사용자와 전 세계의 사용자를 모두 지원하는 앱을 개발 중이라면, 전 세계의 모든 사용자에게 중국 도메인 구성 사용이 가능합니다. 알리바바 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',
    },
  },
};

다음 구성은 하나로 작동합니다:

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

성능 고려 사항:

domain은 Alibaba DNS를 통해 전 세계적으로 해결되며 모든 곳에서 작동하지만, 중국 외부 사용자에게는 표준 도메인 ( .cn )과 비교하여 slightly less performant입니다. 그러나 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@__CAPGO_KEEP_0__.app로 연락주시거나 support@capgo.app 의 __CAPGO_KEEP_0__ 중국 커뮤니티 도움을 받으려면.

__CAPGO_KEEP_0__ 중국 인프라 모니터링

Capgo의 중국 특정 엔드포인트의 상태와 건강을 모니터링할 수 있습니다. capgo.com.cn. 중국 OST URL의 지연, 장애 및 가동률을 확인하기 위해 문제를 해결하기 전에 이 페이지를 사용하십시오.

문제 해결

“문제 해결” 제목

중국에서 업데이트와 관련된 문제가 발생하는 경우: 설정 확인하기. - 세 개의 URL이 모두 올바르게 설정되어 있는지 확인하십시오. capacitor.config.ts
업데이트 responseTimeout - 중국에서 최소 60 초 동안 업데이트가 완료될 때까지 플러그인이 중단되지 않도록 하기 위해
네트워크 연결 확인 - 장치가 updater.capgo.com.cn 도메인
중국 상태 페이지 확인 - 상태.capgo.com.cn 에서 진행 중인 사고나 성능 저하를 확인하기
로그 확인 - npx @capgo/cli@latest app debug 오류 메시지를 확인하기 위해
테스트 업데이트 - 새로운 번들을 업로드하고 다운로드 프로세스를 모니터링하는
지원 문의 context: Capgo 마케팅 웹사이트. 역할: 짧은 UI 레이블 또는 네비게이션 아이템. 위치: 컴포넌트 가격/Faq.astro. 메시지 키 `contact_support` (지원 문의). - 문제가 지속되면 capgo.app 으로 연락하거나 우리 Discord 커뮤니티에 가입하여

다음 단계

업데이트 동작 업데이트가 적용될 때 커스터마이즈 할 수 있습니다. 채널
채널을 관리하여 다양한 릴리즈 트랙을 탐색할 수 있습니다. 검토 암호화
__CAPGO_KEEP_0__ __CAPGO_KEEP_0__ 업데이트를 보안하기 위해

중국에서 Capgo을 계속 사용하는 방법

중국에서 __CAPGO_KEEP_0__을 사용 중이라면 중국에서 Capgo을 계속 사용하는 방법 __CAPGO_KEEP_0__ Live Updates와 연결하여 Capgo Live Updates Capgo Live Updates에서 제품 워크플로우를 소개 소개에서 구현 세부 정보를 기능 기능에서 구현 세부 정보를 업데이트 동작 업데이트 동작 구현 세부 사항에 대해 업데이트 유형 업데이트 유형 구현 세부 사항에 대해