중국에서 Capgo 사용

설치

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

중국 URL 사용의 이유

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

설정

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

파일을 열어 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
```

설정 세부 정보 섹션 제목

updateUrl

- 앱의 업데이트를 확인하고 다운로드할 수 있는 업데이트를 다운로드합니다.: https://updater.capgo.com.cn/updates - Used to check for and download available updates for your app
통계 URL: https://updater.capgo.com.cn/stats Capgo에서 통계 및 사용량 통계를 보고하기 위해 사용됩니다.
채널 URL: https://updater.capgo.com.cn/channel_self __CAPGO_KEEP_0__에서 채널 구성 및 적용할 업데이트를 결정하기 위해 사용됩니다.

중국 설정 추천

__CAPGO_KEEP_0__ 응답 시간 증가

API 업데이터의 응답 시간을 증가시키는 방법을 설명합니다.

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

__CAPGO_KEEP_0__ 대신 __CAPGO_KEEP_1__를 사용하여 업데이트를 확인하고 다운로드를 완료하세요. 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',
    },
  },
};

백그라운드 업데이트를 사용하세요

우리는 중국 앱에 대해 강력히 추천합니다. 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을 동적으로 설정하는 경우
중국 지역에 대한 별도 릴리스 채널을 생성하는 경우

다중 지역 배포 전략에 대한 도움을 필요로하신다면, support@capgo.app 또는 우리의 __CAPGO_KEEP_0__ 커뮤니티 도움을 받으려면.

중국 인프라 모니터링

Capgo의 중국 특정 엔드포인트의 상태와 건강을 모니터링할 수 있습니다. status.capgo.com.cn. 중국 OST URL의 지연, 오류 및 uptime을 확인하기 전에 앱을 문제 해결하기 전에 이 페이지를 사용하세요.

문제 해결

“문제 해결” 제목

중국에서 업데이트와 관련된 문제가 발생하는 경우: 설정 확인하기 (Verify your configuration) - 설정 URL이 올바르게 설정되었는지 확인하세요. capacitor.config.ts
업데이트 responseTimeout - 중국에서 최소 60 초 이상 사용하여 업데이트가 완료될 때까지 플러그인이 중단되지 않도록 합니다.
네트워크 연결 확인 - 장치가 updater.capgo.com.cn 도메인
중국 상태 페이지 확인 - 상태.capgo.com.cn 상태 페이지를 확인하여 진행 중인 사고나 성능 저하가 있는지 확인합니다.
로그 확인 - npx @capgo/cli@latest app debug 오류 메시지를 확인하기 위해
테스트 업데이트 - 새로운 번들을 업로드하고 다운로드 프로세스를 모니터링해 보세요
지원 문의 - 문제가 지속되면 __CAPGO_KEEP_0__.app의 support@로 연락해 주세요 support@capgo.app Discord 커뮤니티에 가입하여 도움을 받으세요 주의

다음 단계

다음 단계 업데이트 동작 업데이트가 적용될 때 커스터마이즈할 수 있도록 하기 위해
업데이트 채널 다양한 릴리스 트랙을 관리하기 위해 업데이트 채널
다양한 릴리스 트랙을 관리하기 위해 리뷰 업데이트를 보안하기 위해

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

중국에서 __CAPGO_KEEP_0__을 사용 중이라면 중국에서 Capgo을 계속 사용하는 방법 __CAPGO_KEEP_0__ Live Updates Capgo Live Updates Capgo Live Updates __CAPGO_KEEP_0__ Live Updates __CAPGO_KEEP_0__ Live Updates __CAPGO_KEEP_0__ Live Updates __CAPGO_KEEP_0__ Live Updates 업데이트 동작 업데이트 동작의 구현 세부 사항에 대해, 그리고 업데이트 유형 업데이트 유형의 구현 세부 사항에 대해.