중국에서 Capgo 사용

설치 명령어와 이 플러그인의 전체 마크다운 가이드를 포함한 설정 명령어를 복사하세요.

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

중국 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
```

다음 URL은 무엇을 하는지 설명합니다:

- 앱의 업데이트를 확인하고 다운로드할 수 있는 업데이트를 다운로드합니다.

Rebuild your app to apply the changes:: https://updater.capgo.com.cn/updates Terminal window
통계 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의 에지 인프라 앞에 Capgo도 약 3 초를 실패 기준으로 간주합니다. 초 대륙 중화인민공화국에서, 국경 횡단 지연 시간은 종종 더 높습니다. __CAPGO_KEEP_0__ 업데이터 플러그인이 업데이트를 확인하고 다운로드를 완료하기 위해 충분한 시간을 갖도록 하기 위해, __CAPGO_KEEP_1__ 초를 __CAPGO_KEEP_2__ 초로 설정합니다.

클립보드 복사 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;

설정 테스트

__CAPGO_KEEP_0__에 새로운 번들을 업로드하세요:

Upload a new bundle to 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',
    },
  },
};

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

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

성능 고려 사항:

도메인이 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.

지역별 구성 대안

다른 구성으로 최적화할 수 있는 앱 변형을 빌드합니다.

환경 기반 구성 사용하여 동적으로 URL을 설정합니다.
다른 지역에 대한 다른 릴리스 채널을 만듭니다.
다중 지역 배포 전략에 대한 도움을 필요로하신다면,

support@__CAPGO_KEEP_0__.app support@capgo.app 커뮤니티에 가입하세요. __CAPGO_KEEP_0__ 커뮤니티 도움을 받으려면.

중국 인프라 모니터링

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

문제 해결

“문제 해결” 제목 섹션

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

다음 단계

다음 단계 학습 업데이트 동작
업데이트가 적용될 때 커스터마이즈할 수 있도록 하기 탐색 채널
Capgo 릴리스 채널 기능 이름 Capgo 솔루션 마케팅 페이지 업데이트를 보안하기 위해

중국에서 Capgo을 계속 사용하세요

__CAPGO_KEEP_0__을 사용 중이라면 중국에서 Capgo을 계속 사용하세요 실시간 업데이트 배포를 계획하기 위해, __CAPGO_KEEP_0__을 __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 업데이트 동작 업데이트 동작의 구현 세부 사항에 대해, 그리고 업데이트 유형 업데이트 유형의 구현 세부 사항에 대해.