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

이 플러그인에 대한 설치 단계와 전체 마크다운 가이드를 포함한 설정 프롬프트를 복사하십시오.

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

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

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

설정

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.

Open your capacitor.config.ts 파일

Add the following configuration to the CapacitorUpdater plugin section:

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;

Rebuild your app to apply the changes:
터미널 창
```
npm run build
npx cap sync
```

설정 세부 정보

각 URL이 하는 일은 다음과 같습니다:

updateUrl: https://updater.capgo.com.cn/updates - __CAPGO_KEEP_0__ 앱을 업데이트하거나 다운로드할 수 있는 최신 버전을 확인하기 위해 사용됩니다.
statsUrl: https://updater.capgo.com.cn/stats - Capgo에 사용 데이터 및 분석 통계를 보고하기 위해 사용됩니다.
channelUrl: https://updater.capgo.com.cn/channel_self - __CAPGO_KEEP_0__ 업데이트를 적용할 수 있는 채널 구성 정보를 가져오기 위해 사용됩니다.

중국에서 권장하는 설정

Recommended Settings for China

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

우리는 중국에서 앱을 개발할 때는 강력히 추천합니다. 중국의 네트워크 성능은 다른 지역보다 낮고, 다운로드가 중단되거나 느려지면 사용자 경험에 영향을 미칠 수 있습니다. 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
      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를 통해 동일한 인프라에 접근하는 사용자)

성능 고려 사항:

While the .cn 도메인은 Alibaba 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을 설정하는 것
다른 지역에 대한 다른 릴리스 채널을 만들기

다중 지역 배포 전략에 대한 도움을 필요로하신다면, __CAPGO_KEEP_0__.app의 support@로 연락주시거나 support@capgo.app Discord 커뮤니티 Discord 커뮤니티 Discord 커뮤니티

문제 해결

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

설정 확인 - 업데이트를 위한 세 개의 URL이 올바르게 설정되어 있는지 확인하십시오. capacitor.config.ts
네트워크 연결 확인 - 장치가 업데이트를 위한 URL에 접근할 수 있는지 확인하십시오. updater.capgo.com.cn 도메인
로그 확인 - 에러 메시지를 확인하기 위해 npx @capgo/cli@latest app debug 테스트 업데이트
__CAPGO_KEEP_0__ - 새로운 번들을 업로드하고 다운로드 프로세스를 모니터링하세요
지원 문의 - 문제가 지속된다면 capgo.app의 support@로 연락해 주세요 또는 중국 설정 시 표준 국제 도메인 대신 ( ) 도메인을 사용하여 Discord 커뮤니티에 참여하여

다음 단계

업데이트 방법을 알아보세요 업데이트 동작을 수정하세요 업데이트가 적용될 때를 __CAPGO_KEEP_0__로 지정하세요
업데이트 방법을 탐색하세요 채널 다양한 릴리스 트랙을 관리하세요
리뷰 암호화 업데이트를 안전하게 보호하세요

Capgo를 사용하여 중국에서 계속 진행하세요

__CAPGO_KEEP_0__를 사용 중이라면 Capgo를 중국에서 사용하는 방법 __CAPGO_KEEP_0__를 사용하여 실시간 업데이트 전송을 계획하고 싶다면 Capgo Live Updates Capgo Live Updates에서 Capgo Live Updates의 제품 워크플로우를 연결하고 싶다면 __CAPGO_KEEP_0__ Live Updates __CAPGO_KEEP_0__ Live Updates의 구현 세부 정보를 보려면 __CAPGO_KEEP_0__ __CAPGO_KEEP_0__의 구현 세부 정보를 보려면 __CAPGO_KEEP_0__의 구현 세부 정보를 보려면 __CAPGO_KEEP_0__의 구현 세부 정보를 보려면 업데이트 유형 업데이트 유형의 구현 세부 정보에 대해.