중국에서 Capgo 사용

이 플러그인을 설치하는 단계와 전체 마크다운 가이드를 포함한 설치 설정을 복사합니다.

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

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

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

설정

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

열기 capacitor.config.ts 파일

__CAPGO_KEEP_0__ 설정 파일에 다음 설정을 추가하세요: 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
```

__CAPGO_KEEP_0__

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

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

중국에서 권장하는 설정

중국 대륙에서 앱을 배포하는 경우, 중국의 대화벽으로 인해 네트워크 성능 제한으로 인해 특정 추천을 하게 됩니다.

API 응답 시간을 늘리십시오.

Capgo 업데이터 플러그인은 API 호출을 중단합니다. responseTimeout __CAPGO_KEEP_0__의 값은 초 단위입니다. 초클라우드 플레어의 에지 인프라 앞에서 Capgo도 약 3초를 실패로 간주합니다. 3 초 as a failure budget for some paths.

In mainland China, cross-border latency is often higher. Keep a higher responseTimeout so the plugin has enough room to finish update checks and downloads through 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에서 업데이트가 다운로드되는지 확인하세요

다중 지역 배포

앱이 중국 내 및 중국 외부의 사용자를 모두 지원한다면, 모든 사용자에게 중국 도메인 구성이 사용될 수 있습니다. updater.capgo.com.cn 알리바바 DNS 인프라스트럭처로 인해 도메인은 전 세계적으로 해결되며, 중국 내 및 전 세계 어디서든 접근할 수 있습니다.

중국 도메인 전역 사용

클립보드 복사

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를 통해 동일한 인프라에 접근)
성능 고려 사항:

성능 고려 사항:

라이브 업데이트는 .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.

만약 각 지역에 대해 최적화하는 것을 선호한다면, 다음을 고려할 수도 있습니다:

환경 기반 구성 사용하여 동적으로 URL을 설정

Alternative: Region-Specific Configurations
Section titled “Alternative: Region-Specific Configurations”
다양한 지역에 대한 릴리스 채널을 생성하는 방법

다중 지역 배포 전략에 대한 도움을 필요로하신다면, capgo.app의 support@ or 가입하거나 중국 인프라 모니터링 중국 인프라 모니터링

__CAPGO_KEEP_0__의 중국 특화된 엔드포인트의 상태를 확인할 수 있습니다.

Capgo의 중국 특정 엔드포인트의 상태와 건강을 모니터링할 수 있습니다. status.capgo.com.cn문제 해결

Troubleshooting

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

설정 확인 - 중국에서 업데이트를 받기 위해 사용하는 URL이 모두 올바르게 설정되어 있는지 확인하십시오. capacitor.config.ts
Raise responseTimeout - 중국에서 업데이트를 받기 위해 사용하는 URL이 모두 올바르게 설정되어 있는지 확인하십시오. 60 seconds
중국에서 업데이트를 받기 위해 사용하는 URL이 모두 올바르게 설정되어 있는지 확인하십시오. 네트워크 연결 확인 updater.capgo.com.cn domain
domain - Review status.capgo.com.cn 어떤 중단된 서비스나 성능 저하가 있는지 확인하세요.
로그를 검토하세요. - 사용하세요. npx @capgo/cli@latest app debug 오류 메시지를 확인하기 위해 업데이트를 체크하세요.
테스트 업데이트를 확인하세요. - 새로운 번들을 업로드하고 다운로드 프로세스를 모니터링하세요.
지원팀에 문의하세요. - 문제가 지속되면 우리에게 연락하세요 또는 capgo.app의 Discord 커뮤니티에 가입하세요. 지원팀에 문의하세요. - 문제가 지속되면 __CAPGO_KEEP_0__.app의 support@__CAPGO_KEEP_0__.app로 연락해 주세요. 도움을 받으려면

다음 단계

업데이트 동작에 대해 알아보십시오. 업데이트 동작을 사용자 정의하려면 업데이트 동작을 사용자 정의하려면
탐색 채널 __CAPGO_KEEP_0__ 관리
리뷰 암호화 __CAPGO_KEEP_0__ 업데이트를 보안

Capgo 중국에서 계속

__CAPGO_KEEP_0__ 중국에서 계획 Capgo 중국 업데이트와 연결 live update 라이브 업데이트 Capgo 라이브 업데이트의 제품 워크플로우 Capgo 개요 개요 구현 세부 사항에 대한 구현 세부 사항을 위해 기능 기능 구현 세부 사항에 대한 구현 세부 사항을 위해 업데이트 동작 업데이트 동작 구현 세부 사항에 대한 구현 세부 사항을 위해, 및 업데이트 유형 업데이트 유형 구현 세부 사항에 대한 구현 세부 사항을 위해.

Capacitor 앱을 배포하세요 컨텍스트: Capgo 마케팅 웹사이트. 역할: 짧은 UI 레이블 또는 네비게이션 아이템. 보이는 곳: Hero.astro 구성 요소. Capgo 제품/브랜드 및 개발자 용어를 정확히 유지하세요. 메시지 키 `hero_title_line1` (Hero Title Line1).