Capgo 사용(중국 지역)

If you’re deploying your app to users in China, you’ll need to configure Capgo to use regional OST (Object Storage Technology) URLs to ensure reliable and fast updates.

Why Use China-Specific URLs?

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

설정

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

1. 열기 capacitor.config.ts 파일

2. 다음 구성 추가: 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;

3. 변경 사항을 적용하기 위해 앱을 다시 빌드하세요:

   npm run build
   npx cap sync

설정 세부 정보

다음 URL은 무엇을 하는지 알아보세요.

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

팁

중국에서 Capgo 업데이터의 전체 기능을 보장하기 위해 모든 세 가지 URL을 함께 구성해야 합니다.

__CAPGO_KEEP_0__

__CAPGO_KEEP_1__

중국에서 앱을 배포하는 경우 네트워크 성능 제한으로 인해 Great Firewall of China로 인해 특정 추천을 합니다.

__CAPGO_KEEP_2__ 우리는 중국 앱에 대해 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',
    },
  },
};

주의

While our Hong Kong-based infrastructure helps minimize latency and improve reliability, network performance to mainland China can still be affected by the Great Firewall. Using background updates helps ensure updates complete successfully without disrupting the user experience.

중요한 설정 예제

중국에서 앱을 배포하는 데 권장되는 설정과 함께 완전한 예제입니다.

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__에 새로운 번들을 업로드하세요.

1. Upload a new bundle to Capgo:

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

2. 설정 테스트

3. 업데이트 프로세스를 모니터링하십시오:

   npx @capgo/cli@latest app debug

4. 중국 OST URL에서 업데이트가 다운로드되는지 확인하십시오

주의

표준 Capgo 구성과 동일한 업데이트 동작 및 타이밍이 유지됩니다. 업데이트 적용 방법 및 시점에 대한 자세한 내용은 업데이트 동작 문서를 참조하십시오.

다중 지역 배포

앱이 중국 내 및 중국 외부의 사용자를 모두 대상으로 한다면, 모든 사용자에게 중국 도메인 구성 사용이 가능합니다. updater.capgo.com.cn __CAPGO_KEEP_0__의 도메인은 Alibaba DNS 인프라로 전 세계적으로 해결되며, 중국 내에서뿐만 아니라 전 세계 어디서든 접근할 수 있습니다.

중국 도메인을 전 세계적으로 사용하기

중국 도메인 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를 통해 동일한 인프라에 접근하는 사용자)

성능 고려 사항:

__CAPGO_KEEP_0__의 도메인은 Alibaba DNS를 통해 전 세계적으로 해결되며 전 세계 어디서든 작동하지만, 중국 외부의 사용자에게는 표준 도메인 (__CAPGO_KEEP_0__)과 비교하여 __CAPGO_KEEP_0__에서 호스팅되는 우리의 백엔드가 있는 곳에서 직접 해결되는 표준 도메인보다 약간 느립니다. 그러나 DNS 해결은 빠르므로 성능 차이는 미미하며 사용자 경험에 큰 영향을 미치지 않습니다. .cn 복사 클립보드에 붙여넣기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.

Tip

Using the .cn 모든 사용자에게 모든 지역에 걸쳐 일관된 업데이트를 보장하는 데 도움이 되는 도메인 사용은 배포를 단순화하고 모든 지역에서 일관된 업데이트를 보장합니다. 별도의 빌드나 환경 기반 구성이 필요하지 않습니다. 중국 이외의 작은 성능 손실은 일반적으로 단순화된 배포에 대한 단순화된 배포의 가치에 상당합니다.

Alternative: Region-Specific Configurations

If you prefer to optimize differently for each region, you can also consider:

• 각 지역에 대해 다르게 최적화하는 것을 선호한다면, 다음을 고려할 수도 있습니다:
• Building separate app variants with different configurations
• 다양한 구성으로 별도의 앱 변형을 빌드하는

Using environment-based configuration to dynamically set the URLs support@capgo.app 또는 우리의 Discord 커뮤니티에 가입하여 도움을 받으세요.

문제 해결

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

1. 설정 확인 - 모든 세 개의 URL이 올바르게 설정되어 있는지 확인하세요. capacitor.config.ts
2. 네트워크 연결 확인 - 장치가 도메인에 접근할 수 있는지 확인하세요. updater.capgo.com.cn 로그 확인
3. - 도메인에 접근할 수 있는지 확인하세요. - 사용 npx @capgo/cli@latest app debug 에 오류 메시지를 확인하기 위해
4. 테스트 업데이트 - 새로운 번들을 업로드하고 다운로드 프로세스를 모니터링하는 데
5. 지원 - 문제가 지속되면 capgo.app의 support@ 또는我们的 Discord 커뮤니티에 접속하여 도움을 받으세요

주의

__CAPGO_KEEP_0__ 중국에서 구성할 때 표준 국제 도메인 대신 __CAPGO_KEEP_0__ 도메인을 사용하십시오. .cn __CAPGO_KEEP_1__updater.capgo.com.cn__CAPGO_KEEP_2__

__CAPGO_KEEP_3__

• __CAPGO_KEEP_5__ __CAPGO_KEEP_6__ __CAPGO_KEEP_7__
• __CAPGO_KEEP_8__ __CAPGO_KEEP_9__ __CAPGO_KEEP_10__
• __CAPGO_KEEP_11__ 암호화 업데이트를 보호하기 위해

Capgo을 중국에서 사용하는 경우 계속하기

__CAPGO_KEEP_0__을 사용 중이라면 Capgo을 중국에서 사용하는 경우 계속하기 __CAPGO_KEEP_0__을 사용하여 실시간 업데이트 배포를 계획할 때 Capgo Live Updates와 연결 Capgo Live Updates의 Capgo Live Updates 제품 워크플로우에서 개요 개요의 구현 세부 정보를 위해 기능 __CAPGO_KEEP_0__ 기능 설명 업데이트 동작 업데이트 동작 및 __CAPGO_KEEP_0__ 기능 설명 업데이트 유형 __CAPGO_KEEP_0__ 기능 설명 및 업데이트 유형