메인 콘텐츠로 건너뛰기

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

안전한 Capacitor 앱에 OTA 업데이트를 구현하는 방법을 알아보세요. Capgo의 포괄적인 문서와 단계별 지침을 통해 Capacitor 앱에 OTA 업데이트를 구현하세요.

마틴 도나디유

마틴 도나디유

마케팅 담당자

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

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

__CAPGO_KEEP_0__이란?

  • Capgo은 __CAPGO_KEEP_0__ Capacitor apps.
  • Why OTA Updates? 시간을 절약하고 사용자 경험을 개선하고 버그를 빠르게 수정하세요.
  • How to Get Started?
    • Capacitor를 설치하세요. Capgo 플러그인: npm install @capgo/capacitor-updater
    • API 키와 앱을 구성하세요.
    • ‘production’ 또는 ‘beta’와 같은 채널을 사용하여 목표된 롤아웃을 수행하세요.
  • Capacitor의 고급 기능: 끝에서 끝까지 암호화, 오류 처리 및 CI/CD 통합

Capgo의 문서 (capgo.app/docs)는 설치부터 고급 구성까지 설정, 보안 및 문제 해결에 대한 단계별 지침을 제공합니다. 설치부터 고급 구성까지 무난한 업데이트를 위한 귀하의 가이드입니다.

CapgoCapacitorJs 플러그인으로 Live 업데이트

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

Capgo 사용 설명서

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

문서 위치

Capgo의 문서에 접근하는 방법 capgo.app/docs [1]It’s organized into sections based on specific purposes:

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

중요한 용어 및 개념

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

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

Code 예시 및 튜토리얼

문서에는 통합을 단순화하기 위해 샘플 code이 제공됩니다. TypeScript/JavaScript를 사용하는 기본 예제를 보시려면 다음과 같습니다.

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

// Initialize the updater
await CapacitorUpdater.notifyAppReady()

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

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

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

implementation 방법에 대한 자세한 내용은 다음 설정 가이드를 참조하세요.

설정

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

기본 설정 단계

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

npm install @capgo/capacitor-updater
npx cap sync

다음으로, capacitor.config.json __CAPGO_KEEP_0__ __CAPGO_KEEP_1__ 키를 Capgo API key:

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

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

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

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

업데이트 채널 설정

업데이트 업데이트 채널 배포 목적에 맞게 설정하세요:

채널 유형목적사용 사례
생산안정적인 릴리스일반 사용자
테스트QA 팀 및 베타 테스터베타
Pre-release testing기능 테스트초기 채택자

특정 채널에 업데이트를 업로드하려면 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

고급 설정

업데이트 프로세스를 커스터마이즈 할 수 있는 추가 보안 기능과 유연한 업데이트 구성 옵션을 사용하여 업데이트를 보다 안전하고 smooth하게 개선하세요. Capgo OTA update __CAPGO_KEEP_0__ 업데이트는 강력한 보안 프로토콜을 제공하여 업데이트를 안전하게 보호하고 사용자에게 안전하게 전달합니다. 플랫폼은 모든 업데이트에 대해 끝에서 끝까지 암호화와 공개 키 암호화 방식을 사용합니다.

아래는 키 보안 기능을 활성화하는 방법입니다.

Capgo provides strong security protocols to safeguard your update bundles and deliver them securely to users. The platform uses end-to-end encryption with public-key cryptography for all updates [1]__CAPGO_KEEP_0__

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

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

__CAPGO_KEEP_0__

__CAPGO_KEEP_0____CAPGO_KEEP_1____CAPGO_KEEP_2__
__CAPGO_KEEP_3____CAPGO_KEEP_4____CAPGO_KEEP_5__
__CAPGO_KEEP_6____CAPGO_KEEP_7____CAPGO_KEEP_8__
__CAPGO_KEEP_9____CAPGO_KEEP_10____CAPGO_KEEP_11__

업데이트 동작 설정

__CAPGO_KEEP_0__ 업데이트를 사용하여 이벤트 리스너 및 구성 옵션을 사용하여 업데이트가 전달되고 설치되는 방법을 사용자 지정할 수 있습니다. 업데이트의 타이밍과 사용자 상호 작용을 조정하려면 다음 설정을 조정하세요:

// 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의 phased rollouts를 위해 업데이트 분배를 직접 대시보드 또는 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_KEEP_0__ 문제 해결 가이드

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

__CAPGO_KEEP_0__ 일반적인 문제 및 해결 방법

일반적인 문제와 해결 방법을 여기에 나열했습니다:

  • __CAPGO_KEEP_0__ 다운로드 실패 증상:: 다운로드가 멈추거나 완료되지 않습니다. 해결: 네트워크 연결을 확인하고 업데이트 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하게 알려주고 동의를 얻으세요.
  • core 기능: 리뷰된 앱의 주요 기능이 유지되도록 하세요.
  • 보안 조치: __CAPGO_KEEP_0__을 사용하여 업데이트를 안전하게 전송하세요.

Android Implementation:

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

Best Practices:

  • Version Control: 업데이트를 점진적으로 배포하여 충돌을 줄입니다.
  • Update Notifications: 사용자 친화적인 업데이트 알림을 제공하세요.
  • Security: 배달된 패키지의 무결성을 검증하고 데이터를 보호하기 위해 암호화를 사용하세요.

Summary

: 이 섹션은 가이드의 주요 아이디어를 통합합니다.

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

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

중요한 Implementation 영역

영역중요한 Focus찾아보기
보안암호화 및 무결성 검사보안 기능 구성
__CAPGO_KEEP_0__애플과 안드로이드의 요구 사항을 충족하는 방법애플 스토어 규칙 __CAPGO_KEEP_0__
업데이트 관리버전 관리 및 롤백 옵션업데이트 방법 __CAPGO_KEEP_0__
오류 처리로깅 및 문제 해결 단계__CAPGO_KEEP_0__

이 영역들은 Capgo의 업데이트 관리 시스템의 근간을 이루고 있습니다.

Capgo의 CLI 및 분석 도구는 업데이트를 관리하는 것을 간소화합니다. 앱의 전체 생명주기 동안 업데이트를 관리하는 것을 간소화합니다. 추가 지원을 위해 __CAPGO_KEEP_0__ 문서, 샘플 프로젝트, 및 커뮤니티 포럼과 같은 추가 리소스를 탐색할 수 있습니다. [1].

__CAPGO_KEEP_0__ 문서를 사용하는 방법: OTA 업데이트를 위한 __CAPGO_KEEP_0__ 문서를 사용하는 방법 이미 API를 사용 중이라면 API 문서를 사용하는 방법: OTA 업데이트를 위한 API 문서를 사용하는 방법, 이 영역들은 __CAPGO_KEEP_0__의 업데이트 관리 시스템의 근간을 이루고 있습니다.__CAPGO_KEEP_0__의 __CAPGO_KEEP_1__ 및 분석 도구는 업데이트를 관리하는 것을 간소화합니다. 앱의 전체 생명주기 동안 업데이트를 관리하는 것을 간소화합니다. [2].

추가 지원을 위해 Capgo 문서, 샘플 프로젝트, 및 커뮤니티 포럼과 같은 추가 리소스를 탐색할 수 있습니다.

__CAPGO_KEEP_0__ 문서를 사용하는 방법: OTA 업데이트를 위한 __CAPGO_KEEP_0__ 문서를 사용하는 방법 이미 Capgo를 사용 중이라면 Capgo 문서를 사용하는 방법: OTA 업데이트를 위한 Capgo 문서를 사용하는 방법 보안 및 규정 준수 계획을 수립하기 위해 연결하세요. 암호화 __CAPGO_KEEP_0__ 암호화 구현 세부 사항에 대해 규정 준수 __CAPGO_KEEP_0__ 규정 준수 구현 세부 사항에 대해 Capgo 보안 스캐너 Capgo 보안 스캐너의 제품 워크플로에 대해 Capgo 보안 Capgo 보안의 제품 워크플로에 대해 Capgo 신뢰 센터 Capgo 신뢰 센터의 제품 워크플로에 대해

실시간 업데이트 Capacitor 앱

웹-layer 버그가 실시간으로 활성화되면, 앱 스토어 승인 대기 없이 Capgo를 통해 패치를 배포하세요. 사용자는 배경에서 업데이트를 받으며, 네이티브 변경 사항은 일반적인 검토 경로에 남아 있습니다.

시작하기

블로그에서 최신 뉴스

Capgo은 전문적인 모바일 앱을 만들기 위해 필요한 최고의洞察력을 제공합니다.