Capgo 사용 방법 문서: OTA 업데이트

__CAPGO_KEEP_0__ 업데이트가 더 빠르기를 원한다면? 앱 스토어 지연 없이 앱 업데이트를 더 빠르게 받으려면? __CAPGO_KEEP_0__ Capgo은 사용자에게 즉시 안전한 Over-the-Air (OTA) 업데이트를 전달할 수 있게 해줍니다. 앱 스토어 검토를 생략하고 앱을 최신 상태로 유지하기가 쉬워졌습니다. 주요 내용:

__CAPGO_KEEP_0__이란 무엇인가?

• Capgo 실시간 업데이트 플랫폼 Capacitor 앱에.
• OTA 업데이트 이유는? 시간을 절약하고 사용자 경험을 개선하고 버그를 빠르게 수정하세요.
• 시작하는 방법?
  • 설치하는 Capgo 플러그인: npm install @capgo/capacitor-updater
  • 앱을 API 키와 구성하세요.
  • 대상적인 롤아웃을 위해 “production” 또는 “beta”와 같은 채널을 사용하세요.
• 고급 기능: 끝에서 끝까지 암호화, 오류 처리 및 CI/CD 통합.

Capgo’s 문서 (capgo.app/docs)에서 설치부터 고급 설정까지 단계별 지침을 제공하여 무결점 업데이트를 위한 완벽한 가이드입니다.

Capgo, Live 업데이트 기능을 제공하는 CapacitorJs 플러그인

Capgo 문서 사용

OTA 업데이트와 함께 작업할 때 문서를 효과적으로 탐색하는 것은 필수적입니다. Capgo의 문서는 Capacitor 앱에 Live 업데이트를 통합하는 데 대한 자세한 지침을 제공합니다.

문서 위치

Capgo의 문서에 접근하는 방법 capgo.app/docs [1]. 다양한 목적에 따라 구분된 섹션입니다.

중요한 용어 및 개념

다음은 사용자가 마주할 주요 용어입니다:

• 채널: 이들은 버전 배포를 제어하는 업데이트스트림입니다. 예를 들어, 'production', 'beta', 'staging' 채널을 설정하여 사용자 그룹에 맞게 다루고 싶다면... [4].
• 업데이트 정책: 업데이트가 전달되고 적용되는 방법을 정의합니다. 옵션에는 자동 다운로드, 설치 시간, 사용자 지시 등이 포함됩니다. [1].
• 앱 상태 리스너: 이 컴포넌트는 앱이 전면 또는 배경에서 실행되는지 추적합니다. [4].
• 번들: 앱의 새로운 버전을 포함한 패키지된 업데이트 파일, 자산, code 변경 사항, 구성 업데이트 [4].

Code 예시 및 튜토리얼

문서에는 샘플 code를 제공하여 통합을 간소화합니다. TypeScript/JavaScript를 사용하는 기본 예제는 다음과 같습니다:

import { CapacitorUpdater } from '@capgo/capacitor-updater'

// Initialize the updater
await CapacitorUpdater.notifyAppReady()

더 복잡한 사용 사례를 위한 문서에는 실제 예시가 포함되어 있습니다. [2][3], 예를 들어:

• A/B 테스트를 위한 채널 Switching
• 사용자 지시를 포함한 사용자 정의 업데이트 플로우
• 오류 처리 및 롤백 구현
• CI/CD pipeline과 통합

각 튜토리얼은 성능 고려 사항과 보안 측면을 강조하여 잘못된 결정을 피하고 최적의 결과를 얻을 수 있도록 도와줍니다. 문서는 최신 기능과最佳 관행을 포함하여 자주 업데이트됩니다. [1].

implementation 세부 사항은 다음 설정 가이드를 참조하십시오.

OTA 업데이트 설정

Set up OTA updates in Capgo to streamline your deployment process. Follow these steps and tips for a hassle-free configuration.

기본 설정 단계

Capgo 플러그인을 Capacitor 프로젝트에 설치하세요.

npm install @capgo/capacitor-updater
npx cap sync

다음으로 __CAPGO_KEEP_0__ __CAPGO_KEEP_1__ 키를 포함한 __CAPGO_KEEP_0__ 파일을 업데이트하세요. capacitor.config.json 그 다음, 앱의 메인 파일에서 업데이트를 감지하기 위해 업데이터를 초기화하세요. Capgo API key:

{
  "plugins": {
    "CapacitorUpdater": {
      "autoUpdate": true,
      "apiKey": "YOUR_API_KEY_HERE"
    }
  }
}

__CAPGO_KEEP_1__

import { CapacitorUpdater } from '@capgo/capacitor-updater';
await CapacitorUpdater.notifyAppReady();

이 작업이 완료되면, 다양한 업데이트스트림을 관리하기 위한 채널을 설정할 수 있습니다.

업데이트 채널 설정

업데이트 채널을 업데이트 채널 업데이트 채널을

특정 채널에 업데이트를 업로드하려면 Capgo CLI:

npx @capgo/cli upload -c production

업데이트 방법

Capgo은 업데이트를 처리하는 두 가지 주요 방법을 제공합니다:

자동 업데이트 자동 업데이트를 활성화하려면 autoUpdate: true 개발자의 추가 노력 없이 배경에서 업데이트를 적용하기 위해 설정합니다.

수동 업데이트 더욱 많은 제어를 원하신다면 수동으로 업데이트 관리를 하실 수 있습니다. 업데이트 확인 및 적용을 위한 다음 패턴을 사용하세요:

// Check for updates
const update = await CapacitorUpdater.download();

// Install when ready
if (update) {
  await CapacitorUpdater.set(update);
}

중요한 업데이트 경우 사용자에게 진행하기 전에 알림을 주실 수 있습니다:

if (update.version > currentVersion) {
  const userConsent = await showUpdatePrompt();
  if (userConsent) {
    await CapacitorUpdater.set(update);
  }
}

또한 사용자 그룹을 대상으로 하여 custom ID 및 채널을 사용하여 업데이트 하실 수 있습니다:

await CapacitorUpdater.setCustomId('beta-tester-123');
await CapacitorUpdater.setChannel('beta');

마지막으로 오류 처리 및 롤백 옵션을 포함하여 업데이트 하실 수 있습니다:

try {
  await CapacitorUpdater.set(update);
} catch (error) {
  await CapacitorUpdater.reset(); // Revert to the last working version
  console.error('Update failed:', error);
}

__CAPGO_KEEP_0__ OTA 업데이트

업데이트 프로세스를 더 커스터마이즈 하기 위해 추가 설정을 탐색하세요.

sbb-itb-f9944d2

고급 설정 Capgo OTA update 설치를 보다 안전하고 유연한 업데이트 구성으로 개선하세요.

보안 기능

Capgo은 업데이트 패키지를 안전하게 보호하고 사용자에게 안전하게 전달하기 위해 강력한 보안 프로토콜을 제공합니다. 플랫폼은 모든 업데이트에 대해 끝에서 끝까지 암호화와 공개 키 암호화 방식을 사용합니다. [1]. 업데이트 패키지의 보안 기능을 활성화하는 방법은 다음과 같습니다.

// Enable bundle verification
await CapacitorUpdater.setVerifyBundles(true);

// Configure encryption settings
await CapacitorUpdater.configure({
  encryption: {
    enabled: true,
    failOnError: true
  }
});

업데이트 패키지 보호 시스템의 주요 구성 요소는 다음과 같습니다.

업데이트 동작 설정

업데이트가 전달되고 설치되는 방법을 사용자 정의하려면 이벤트 리스너와 구성 옵션을 사용하세요. 업데이트의 타이밍과 사용자 상호 작용을 조정하세요.

// Listen for when an update is available
CapacitorUpdater.addListener('updateAvailable', async (info) => {
  if (info.version > currentVersion) {
    // Custom update logic based on app state
    const isAppInactive = await checkAppState();
    if (isAppInactive) {
      await CapacitorUpdater.download();
    }
  }
});

// Monitor download completion
CapacitorUpdater.addListener('downloadComplete', (info) => {
  console.log(`Update ${info.version} ready to install`);
  // Implement custom installation timing if desired
});

분할 배포를 위해 업데이트의 배포를 직접 대시보드 또는 code에서 구성할 수 있습니다.

// Set custom update conditions for a gradual rollout
await CapacitorUpdater.configure({
  rollout: {
    percentage: 25, // Start with 25% of users
    timeInterval: 24 // Increase rollout percentage every 24 hours
  }
});

특정 버전 관련 동작을 처리하려면:

// Handle version-specific update failures
CapacitorUpdater.addListener('updateFailed', async (info) => {
  if (info.error.code === 'VERSION_MISMATCH') {
    await CapacitorUpdater.reset(); // Revert to the last stable version
    // Optionally, handle error notification here
  }
});

이 설정은 업데이트가 신뢰할 수 있는 반면 앱의 요구 사항에 맞게 프로세스를 조정할 수 있도록 합니다. 항상 Capgo의 스테이징 환경에서 업데이트를 철저히 테스트한 후 프로덕션으로 배포하세요. [2].

문제 해결 가이드

Capgo의 오류 로그와 내장 도구는 OTA 업데이트의 문제를 해결하는 데 도움을 주며 앱이 스토어 요구 사항에 준수합니다.

일반적인 문제와 해결책

다음은 일반적인 문제와 해결책입니다:

• 다운로드 실패 증상: 다운로드가 멈추거나 완료되지 않습니다. 해결: 네트워크 연결을 확인하고 업데이트 URL이 유효한지 확인한 후 중단을 처리하는 재시도 메커니즘을 추가하세요.

• 버전 충돌 증상: 업데이트 설치가 실패하거나 앱instability를 유발합니다. 해결: 명확한 버전 번호를 사용하여 충돌을 피하고 안전을 위해 롤백 옵션을 implement하세요.

• 설치 오류 증상: 업데이트 실패 또는 자동 롤백을 트리거합니다. 해결: 업데이트 후에 호출하십시오. notifyAppReady() 업데이트 후에 롤백을 방지하기 위해.

Android 기기에서 성능을 향상시키기 위해 50MB 이상의 업데이트를 작은 파일로 나누면 도움이 될 수 있습니다. [5].

세부한 오류 로깅을 사용하여 문제를 일찍 잡으십시오. 예를 들어, 이 리스너를 implement하십시오:

CapacitorUpdater.addListener('updateFailed', (error) => {
  console.log(`Update failed: ${error.code}`);
  logUpdateError({
    errorCode: error.code,
    deviceInfo: error.device,
    timestamp: new Date().toISOString()
  });
});

오류 로깅과 사전 검사를 combination하여 이러한 문제를 효과적으로 처리할 수 있습니다. 그 다음에 규정 준수에 집중할 수 있습니다.

앱 스토어 규칙

기술적인 수정만으로는 충분하지 않습니다. - 업데이트도 앱 스토어의 지침과 일치해야 합니다.

애플 앱 스토어 요구 사항:

• 사용자 투명성: 사용자에게 업데이트의 내용을 rõ ràng하게 알려주고 동의를 얻으십시오.
• 기본 기능: 앱의 주요 기능이 검토된대로 유지되도록 보장합니다.
• 보안 조치: 업데이트를 전송하는 데 안전한 방법을 사용합니다.

안드로이드 구현:

await CapacitorUpdater.configure({
  updateNotification: {
    title: "Update Available",
    message: "A new version is available. Please update to access the latest features.",
    requireUserConsent: true
  }
});

최선의 방법:

• 버전 관리: 업데이트를 점진적으로 출시하여 충돌을 줄입니다.
• 업데이트 알림: 사용자 친화적인 업데이트 알림을 제공합니다.
• 보안: 배달의 무결성을 확인하고 데이터를 보호하기 위해 암호화를 사용합니다.

개요

이 섹션에서는 가이드의 주요 아이디어를 요약합니다.

Capgo의 문서는 Capacitor 앱에 OTA 업데이트를 통합하는 데 필요한 명확한 지침을 제공하며 앱 스토어 규정 준수에 대한 보장을 제공합니다.

Capgo의 리소스를 사용하여 개발자는 초기 설정부터 고급 구성까지 모든 것을 포함하여 필수적인 기능인 끝-to-끝 암호화 및 CI/CD 통합을 implement할 수 있습니다. [1].

중요한 구현 영역

Capgo의 업데이트 관리 시스템의 근간을 이루는 영역입니다.

Capgo의 CLI 및 분석 도구는 업데이트를 앱의 전체 생애주기 동안 추가 지원을 받으려면 [1].

__CAPGO_KEEP_0__ 문서 API 샘플 프로젝트, ,커뮤니티 forum 및 [2].