How to Use Capgo Documentation for OTA Updates

빠른 앱 업데이트 앱스토어 지연 없이? Capgo 앱스토어 리뷰를 건너뛰고 사용자에게 즉시 안전한 Over-the-Air (OTA) 업데이트를 전달할 수 있는 오픈 소스 플랫폼입니다. 앱을 최신 상태로 유지하기가 쉬워졌습니다.

주요 내용:

• Capgo이란? 실시간 업데이트를 위한 오픈 소스 플랫폼 Capacitor Why OTA Updates?
• 시간을 절약하고 사용자 경험을 개선하며 버그를 빠르게 수정할 수 있습니다. How to Get Started?
• __CAPGO_KEEP_0__를
  • __CAPGO_KEEP_0__ Capgo 플러그인: npm install @capgo/capacitor-updater
  • API 키와 함께 앱을 구성하세요.
  • 생산 또는 베타 채널과 같은 목표된 배포를 위해 채널을 사용하세요.
• 고급 기능: 끝-to-끝 암호화, 오류 처리, CI/CD 통합.

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

Capgo컨텍스트: Capgo UI의 HTML 텍스트 조각 (부모 키 `submitting_a_pr_to_capgo`). 페이지/영역: Capgo 마케팅 웹사이트. 역할: 웹사이트 복사 문장. Seen in: contributing.astro 페이지.

Capgo 사용 설명서

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

설명서 위치

Capgo 설명서에 접근할 수 있습니다. capgo.app/docs [1]. 설명서는 특정 목적에 따라 구분되어 있습니다:

중요한 용어 및 개념

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

• 채널이러한 것은 업데이트를 제어하고 버전 분포를 관리하는 업데이트 스트림입니다. 예를 들어, '제품', '베타', '스테이징' 채널을 설정하여 사용자 그룹을 다루기 위해 [4].
• 업데이트 정책이러한 것은 업데이트가 전달되고 적용되는 방법을 정의합니다. 옵션에는 자동 다운로드, 설치 시간, 사용자 지시 등이 포함됩니다 [1].
• 앱 상태 리스너이러한 구성 요소는 앱이 전면 또는 배경에서 실행되는지 추적합니다 [4].
• 번들패키지된 업데이트 파일이 포함되어 있으며 앱의 새로운 버전, 자산, code 변경 사항 및 구성 업데이트를 포함합니다 [4].

Code 예시 및 튜토리얼

문서에서는 code 샘플을 제공하여 통합을 간소화합니다. TypeScript/JavaScript를 사용하는 기본 예제를 보시기 바랍니다.

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

// Initialize the updater
await CapacitorUpdater.notifyAppReady()

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

• 채널 Switching을 통한 A/B 테스트
• 사용자에게 알림을 표시하는 커스텀 업데이트 흐름
• 오류를 처리하고 롤백을 구현하는 방법
• CI/CD PIPELINE과 통합하는 방법

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

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

OTA 업데이트 설정

Capgo에서 OTA 업데이트 설정을 통해 배포 프로세스를 간소화하세요. 이 단계와 팁을 따라서 불편함 없이 구성하세요.

기본 설정 단계

Capgo를 설치하기 위해 Capacitor 프로젝트에 플러그인을 설치하세요:

npm install @capgo/capacitor-updater
npx cap sync

다음으로, capacitor.config.json 파일을 업데이트하세요. Capgo API 키를 파일에 입력하세요.:

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

그 다음, 앱의 메인 파일에서 업데이트를 감지하기 위해 업데이트기를 초기화하세요.

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

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

업데이트 채널 설정

업데이트 채널을 업데이트 채널을 업데이트 채널을 관리하기 위해

특정 채널에 업데이트를 업로드하려면 __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 문서화 Capgo OTA 업데이트 설정에 추가 보안 기능과 유연한 업데이트 구성 옵션을 추가하여 보안과 smooth한 업데이트 경험을 제공하는 방법입니다. 이러한 옵션은 앱 스토어 지침을 충족하는 보안과 smooth한 업데이트 경험을 제공합니다.

보안 기능

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

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

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

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

업데이트 동작 설정

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

// 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를 유발합니다. 해결책업데이트가 충돌을 피하기 위해 명확한 버전 번호를 사용하고 rollback 옵션을 구현하여 안전성을 보장합니다.

• 설치 오류 증상업데이트가 실패하거나 자동 롤백이 트리거됩니다. 해결책업데이트 후에 성공적으로 호출하여 rollback을 방지합니다. notifyAppReady() 업데이트 크기가 50MB를 초과하는 경우 Android 기기에서 성능을 향상시키기 위해 파일을 작은 파일로 나누는 것이 좋습니다.

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

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

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

Capgo

애플 스토어 규칙

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

애플 앱 스토어 요구 사항:

• 사용자 прозрач성: 사용자에게 업데이트의 내용을 명확하게 알려주고 동의를 얻어야 합니다.
• : 앱의 주요 기능이 리뷰된 것과 동일하게 유지되어야 합니다.: 업데이트를 전송하는 데 안전한 방법을 사용해야 합니다.
• 안드로이드 구현최선의 방법

버전 관리:

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

context:

• 페이지/영역: Capgo 마케팅 웹사이트. 역할: 짧은 UI 레이블 또는 네비게이션 아이템. 메시지 키 `version_control` (버전 관리).업데이트를 점진적으로 배포하여 충돌을 줄입니다.
• 업데이트 알림업데이트 알림을 사용자 친화적이고 명확하게 제공합니다.
• 보안컨텍스트: Enterprise 제품/가격 페이지. 역할: UI 레이블. 표시되는 곳: enterprise.astro 페이지. 메시지 키 `enterprise_hero_security_label` (Enterprise Hero Security Label).

배포의完整성을 검증하고 데이터를 보호하기 위해 암호화를 사용합니다.

요약

Capgo’s documentation provides clear instructions for integrating OTA updates into Capacitor apps while staying compliant with app store regulations.

Capgo의 문서는 OTA 업데이트를 __CAPGO_KEEP_1__ 앱에 통합하는 데 필요한 명확한 지침을 제공합니다. 앱 스토어 규정 준수에 대한 지침도 포함되어 있습니다. __CAPGO_KEEP_0__의 리소스를 사용하여 개발자는 다음 필수 기능을 implement할 수 있습니다. 끝-to-끝 암호화 CI/CD 통합설치부터 고급 설정까지 모든 것을 다루는 방법 [1].

주요 구현 영역

These areas form the backbone of Capgo’s update management system.

Capgo’s CLI and analytics tools simplify 업데이트 관리 오류 처리 [1].

다음 지원을 위해 추가 리소스를 탐색할 수 있습니다. API 문서, 샘플 프로젝트, 그리고 커뮤니티 forum [2].

Keep going from How to Use Capgo Documentation for OTA Updates

__CAPGO_KEEP_0__을 사용 중인 경우 How to Use Capgo Documentation for OTA Updates 보안 및 규정 준수 계획을 위해 사용하는 경우 __CAPGO_KEEP_0__을 연결하세요. __CAPGO_KEEP_0__의 구현 세부 정보는 Encryption에서 확인할 수 있습니다. __CAPGO_KEEP_0__의 구현 세부 정보는 Compliance에서 확인할 수 있습니다. for the implementation detail in Compliance, Capgo Security Scanner for the product workflow in Capgo Security Scanner, Capgo Security for the product workflow in Capgo Security, and Capgo Trust Center for the product workflow in Capgo Trust Center.