OTA 업데이트를 위한 Capgo 사용 방법

빠른 앱 업데이트가 필요합니다 __CAPGO_KEEP_0__ Capgo __CAPGO_KEEP_0__

__CAPGO_KEEP_0__

Capgo __CAPGO_KEEP_0__ Capacitor __CAPGO_KEEP_0__
__CAPGO_KEEP_0__ __CAPGO_KEEP_0__
__CAPGO_KEEP_0__
- __CAPGO_KEEP_0__ Capgo 플러그인: npm install @capgo/capacitor-updater
- API 키를 사용하여 앱을 구성하십시오.
- 대상된 롤아웃을 위해 'production' 또는 'beta'와 같은 채널을 사용하십시오.
고급 기능: 끝에서 끝까지 암호화, 오류 처리, CI/CD 통합

Capgo의 문서 (capgo.app/docs)는 설치부터 고급 구성까지의 단계별 지침을 제공합니다. 설치부터 고급 구성까지의 모든 업데이트를 위한 완벽한 가이드입니다.

Capgo, Live 업데이트 용 CapacitorJs 플러그인

Capgo Live Update 대시보드 인터페이스

Capgo 문서 사용 가이드

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

문서 위치

Capgo의 문서에 접근하려면 capgo.app/docs [1]입니다. 문서는 특정 목적에 따라 구분되어 있습니다.

구분	목적	주요 주제
시작하기	초기 설정	설치 단계 API 키 설정
설정	기본 설정	플러그인 설정, 환경 설정
API 참조	기술 정보	메서드, 매개 변수, 반환 값
보안	보호 조치	암호화 설정, 서명 검증
문제 해결	문제 해결	일반적인 문제, 진단 도구

중요한 용어 및 개념

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

채널: 업데이트를 통제하고 버전 분배를 관리하기 위해 사용하는 업데이트스트림입니다. 예를 들어, '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과 통합하는 업데이트

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

implementation 세부 사항은 다음 설정 가이드를 확인하시기 바랍니다.

OTA 업데이트 설정

OTA 업데이트 Capgo을 설정하여 배포 프로세스를 단순화하세요. 이러한 단계와 팁을 따라서 불편함이 없는 구성으로 진행하세요.

기본 설정 단계

Capgo 플러그인을 설치하여 Capacitor 프로젝트에 추가하세요:

npm install @capgo/capacitor-updater
npx cap sync

다음으로 __CAPGO_KEEP_0__ __CAPGO_KEEP_1__ 키를 포함한 capacitor.config.json 파일을 업데이트하세요. Capgo API key:

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

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

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

업데이트 채널 설정

업데이트 채널을 __CAPGO_KEEP_0__에 따라 조직하세요.

업데이트 채널 업데이트 채널을 배포에 맞게 조직하세요: __CAPGO_KEEP_0__ 유형

__CAPGO_KEEP_0__ 목적	__CAPGO_KEEP_0__	업무 사례
운영	안정적인 릴리스	일반 사용자 기반
스테이징	미리 출시 테스트	QA 팀 및 베타 테스터
베타	기능 테스트	초기 채택자

__CAPGO_KEEP_0__ __CAPGO_KEEP_1__를 특정 채널에 업데이트하려면 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);
  }
}

또한 사용자 그룹을 대상으로 하여 커스텀 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);
}

이러한 단계를 통해 OTA 업데이트시스템이 준비되었습니다. 업데이트 프로세스를 더 자세히 커스터마이즈하기 위해 고급 설정을 탐색하세요.

sbb-itb-f9944d2

고급 설정

앱의 Capgo OTA 업데이트 설정을 보다 안전하고 유연한 업데이트 구성으로 개선하세요. 이러한 옵션은 앱 스토어 지침을 충족하면서도 안전하고 smooth한 업데이트 경험을 보장합니다.

보안 기능

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

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

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

배포 보호 시스템의 주요 구성 요소는 다음과 같습니다.

보안 기능	설명	구현
배포完整성	암호학적 서명으로 패키지의 진위성을 확인합니다.	setVerifyBundles() 함수를 호출하면 자동으로 활성화됩니다.
롤백 보호	업데이트가 실패하면 안정적인 버전으로 되돌립니다.	업데이트 프로세스에 내장되어 있습니다.
권한 관리	업데이트를 역할 기반의 권한으로 관리합니다.	설정은 대시보드에서 구성할 수 있습니다.

업데이트 동작 설정

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

// 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].

상세한 에러 로깅을 사용하여 문제를 일찍 catch하세요. 예를 들어, 이 listener를 implement하세요:

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

에러 로깅과 함께 pre-checks를 combination하여 이러한 문제를 효과적으로 처리할 수 있습니다. 그 다음에 compliance에 집중하세요.

App Store 규칙

업데이트는 기술적인 수정만으로는 충분하지 않습니다. 앱 스토어의 지침에 맞춰야 합니다.

애플 앱 스토어 요구 사항:

사용자 투명성: 사용자에게 업데이트의 내용을 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의 리소스를 사용하여 개발자는 CI/CD 통합 및 끝-to-끝 암호화 를 구현할 수 있습니다.Capgo에서부터 시작하여 고급 설정까지 모든 것을 다룹니다. [1].

주요 구현 영역

Aspect	주요 초점	위치
보안	암호화 및 무결성 검사	보안 기능 부분
규정 준수	애플 및 안드로이드 요구 사항을 충족하는	앱 스토어 규칙 가이드
업데이트 관리	버전 관리 및 롤백 옵션	업데이트 방법 가이드
오류 처리	로깅 및 문제 해결 단계	문제 해결 가이드

Capgo의 업데이트 관리 시스템의 핵심 영역입니다.

Capgo의 CLI 및 분석 도구는 앱의 수명 주기 동안 업데이트를 관리하는 것을 간소화합니다. 업데이트 관리 앱의 수명 주기 전반에 걸쳐 [1].

추가 지원을 위해, API 문서, 샘플 프로젝트, 커뮤니티 포럼 [2].

Capgo 문서를 사용하는 방법을 OTA 업데이트로 계속 진행하세요

__CAPGO_KEEP_0__ 문서를 사용하는 방법을 OTA 업데이트로 계속 진행하세요 How to Use Capgo Documentation for OTA Updates Encryption Encryption 규정 준수 Compliance __CAPGO_KEEP_0__ Compliance 세부 정보 Capgo 보안 스캐너 Capgo 보안 스캐너의 제품 워크플로우에 대해 Capgo 보안 Capgo 보안의 제품 워크플로우에 대해, 그리고 Capgo 신뢰 센터 Capgo 신뢰 센터의 제품 워크플로우에 대해.

Capgo을 사용하는 방법 Capgo의 OTA 업데이트를 위한 문서