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.

중국 사용자에게 앱을 배포할 때는 __CAPGO_KEEP_0__을 사용하여 지역 OST (Object Storage Technology) URL을 구성하여 신뢰할 수 있고 빠른 업데이트를 보장해야 합니다.

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

설정

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

1. __CAPGO_KEEP_1__을 열어 capacitor.config.ts 파일

2. 다음 구성 값을 플러그인 섹션에 추가하십시오: CapacitorUpdater 클립보드에 복사

   import { CapacitorConfig } from '@capacitor/cli';
   
   const config: CapacitorConfig = {
     plugins: {
       CapacitorUpdater: {
         autoUpdate: true,
         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이 무엇을 하는지 알아보세요:

• __CAPGO_KEEP_0__: https://updater.capgo.com.cn/updates - 앱에 사용 가능한 업데이트를 확인하고 다운로드합니다.
• - 앱의 사용 통계 및 분석을 __CAPGO_KEEP_0__로 보고합니다.: https://updater.capgo.com.cn/stats - Used to report analytics and usage statistics back to Capgo
• - __CAPGO_KEEP_0__로 사용 통계 및 분석을 보고합니다.: https://updater.capgo.com.cn/channel_self - __CAPGO_KEEP_0__로 사용 통계 및 분석을 보고합니다.

Tip

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

중국에 대한 권장 설정

중국 본토에 배포된 앱을 위한 네트워크 성능 제한으로 인해 중국의 대형 방화벽으로 인해, 우리는 특정한 추천 사항을 제공합니다:

직접 업데이트 비활성화

네트워크 연결 성능이 중국에서는 다른 지역보다 낮으며, 직접 업데이트(즉시 적용)는 다운로드가 중단되거나 느려지면 사용자 경험을 저하할 수 있습니다. 대신, 업데이트 다운로드는 앱이 배경화면 또는 재시작할 때 적용되도록 기본 업데이트 동작을 사용하세요. 사용자에게 더 신뢰할 수 있는 경험을 제공합니다. directUpdate Tip

Tip

const config: CapacitorConfig = {
  plugins: {
    CapacitorUpdater: {
      autoUpdate: true,
      directUpdate: false, // 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',
    },
  },
};

주의

홍콩 기반의 인프라를 사용하여 지연 시간을 최소화하고 신뢰성을 향상하는 데 도움이 되지만, 대륙 중국으로의 네트워크 성능은 여전히 Great Firewall에 의해 영향을 받을 수 있습니다. 비활성화 directUpdate 업데이트가 성공적으로 완료되고 사용자 경험에 영향을 주지 않도록 보장하기 위해 도움이 됩니다.

완전한 구성 예제

대륙 중국에 배포된 앱에 대한 권장 설정과 함께 완전한 예제입니다.

import { CapacitorConfig } from '@capacitor/cli';

const config: CapacitorConfig = {
  appId: 'com.example.app',
  appName: 'My App',
  webDir: 'dist',
  plugins: {
    CapacitorUpdater: {
      autoUpdate: true,
      directUpdate: false, // Recommended: disable 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을 구성한 후 업데이트가 올바르게 작동하는지 확인할 수 있습니다:

1. Capgo에 새로운 번들을 업로드하세요.

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

2. 중국에서 테스트 장치에 앱을 설치하세요.

3. 업데이트 프로세스를 모니터링하세요.

   npx @capgo/cli@latest app debug

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

주의

Capgo의 표준 구성과 동일한 업데이트 동작과 타이밍이 유지됩니다. 표준 Capgo 구성에 대한 자세한 내용은 업데이트 동작 __CAPGO_KEEP_0__

다중 지역 배포

만약 앱이 중국 내와 중국 외부의 사용자를 모두 대상으로 한다면, 모든 사용자에게 중국 도메인 설정을 사용할 수 있다. updater.capgo.com.cn 알리바바 DNS 인프라스트럭처로 인해 전 세계적으로 도메인이 해결되기 때문에 중국 내와 전 세계 어디서든 접근할 수 있다.

전세계 중국 도메인 사용

복사

const config: CapacitorConfig = {
  plugins: {
    CapacitorUpdater: {
      autoUpdate: true,
      directUpdate: false, // 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를 통해 같은 인프라에 접근하는 중국 외부 사용자
• Copy to clipboard

성능 고려 사항:

While the .cn 알리바바 DNS를 통해 전 세계적으로 도메인이 해결되며, 중국 이외의 사용자에게는 표준 도메인 (api.capgo.app)과 비교하여 Cloudflare에서 우리의 백엔드가 호스팅되는 곳에서 직접 해결되는 것보다 약간 느립니다. 그러나 DNS 해결은 빠르기 때문에 성능 차이는 미미하며 사용자 경험에 큰 영향을 미치지 않습니다.

Tip

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

대안: 지역별 구성

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

• 다양한 구성으로 다른 앱 변형을 빌드하는
• 환경 기반 설정을 사용하여 URL을 동적으로 설정합니다.
• 다양한 지역에 대한 다른 릴리스 채널을 생성합니다.

중국 지역에 대한 업데이트와 관련된 문제가 발생한 경우: 지원에 대한 도움을 받으려면 capgo.app의 support@으로 연락해 주세요. 또는 Discord 커뮤니티에 가입하여 도움을 받으세요. Troubleshooting 문제 해결

Verify your configuration

- 모든 세 개의 URL이 올바르게 설정되어 있는지 확인하세요.

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

주의

중국을 위해 구성할 때 표준 국제 도메인 대신 도메인 ( .cn )을 사용하십시오.updater.capgo.com.cn다음 단계

‘다음 단계’라는 제목을 가진 섹션

• 업데이트가 적용될 때 커스터마이즈하려면 업데이트 동작을 커스터마이즈하려면 업데이트 동작을 커스터마이즈하려면
• 탐색 채널 다양한 릴리스 트랙을 관리하기 위해
• 리뷰 업데이트를 보안하기 위해 암호화 페이지 편집