본문으로 바로가기

How to Use Capgo Documentation for OTA Updates

Learn how to implement secure Over-the-Air updates in your Capacitor apps with Capgo's comprehensive documentation and step-by-step guidance.

마틴 도나디우

마틴 도나디우

콘텐츠 마케터

How to Use Capgo Documentation for OTA Updates

빠른 앱 업데이트 앱스토어 지연 없이? Capgo 실시간 업데이트를 위한 보안적인 Over-the-Air (OTA) 업데이트를 즉시 사용자에게 제공하는 __CAPGO_KEEP_0__입니다. 앱스토어 리뷰를 건너뛰고 쉽게 앱을 최신 상태로 유지하세요.

중요한 점:

  • Capgo이란? 실시간 업데이트를 위한 __CAPGO_KEEP_0__ 플랫폼은 Capacitor why OTA 업데이트를?
  • 시간을 절약하고 사용자 경험을 개선하며 버그를 빠르게 수정하세요. 시작하는 방법?
  • __CAPGO_KEEP_0__를 설치하세요.
    • live update platform capacitor title Capgo 플러그인: npm install @capgo/capacitor-updater
    • API 키와 함께 앱을 구성하십시오.
    • 특정 롤아웃을 위해 'production' 또는 'beta'와 같은 채널을 사용하십시오.
  • 고급 기능: 끝-to-끝 암호화, 오류 처리, CI/CD 통합.

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

Capgo__CAPGO_KEEP_0__ Live Update

Capgo Live Update 데스크톱 인터페이스

Capgo 사용 설명서

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

설명서 찾기

Capgo 설명서에 접근하려면 capgo.app/docs [1]다음과 같이 구분된 섹션으로 구성되어 있습니다:

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

중요한 용어 및 개념

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

  • 채널상황: Capgo 릴리스 채널 이름. 페이지/영역: Capgo 솔루션 마케팅 페이지. 역할: 짧은 UI 레이블 또는 네비게이션 아이템. 보이는 곳: 페이지 solutions/white-label.astro. 메시지 키 `solutions_white_label_visual_cell2_value` (솔루션 화이트 레이블 시각 셀2 값). [4].
  • : 업데이트를 제어하여 버전 분포를 관리하는 업데이트스트림입니다. 예를 들어, '제품', '베타', '스테이징' 채널을 설정하여 사용자 그룹을 다루기 위해업데이트 정책 [1].
  • : 업데이트가 전달되고 적용되는 방법을 정의합니다. 옵션에는 자동 다운로드, 설치 시간, 사용자 프롬프트가 포함됩니다앱 상태 리스너 [4].
  • : 앱이 전면 또는 배경에서 작동하는지 추적하는 컴포넌트: Packaged update files containing your app’s new version, including assets, code changes, and configuration updates [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();

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

업데이트 채널 설정

업데이트 채널을 업데이트 채널을 배포를 위한 필요에 맞게 조직하세요:

채널 유형 목적 사용 사례
운영 안정판 일반 사용자
테스트 준비 중인 릴리즈 테스트 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 문서화 Capgo OTA 업데이트 설정에 추가 보안 기능과 유연한 업데이트 구성 옵션을 추가하여 보안과 smooth한 업데이트 경험을 제공하는 방법입니다. 이러한 옵션은 앱 스토어 지침을 충족하는 데 도움이 됩니다.

보안 기능

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

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

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

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

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

업데이트의 전달 및 설치 방법을 사용자 정의할 수 있습니다. 업데이트 설정을 사용하여 업데이트 시간과 사용자 상호 작용을 조정할 수 있습니다.

구간 배포를 위해 업데이트의 배포를 직접 대시보드나 __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
});

For phased rollouts, you can configure update distribution directly through the dashboard or with 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
  }
});

__CAPGO_KEEP_0__

// 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_KEEP_0__

애플 스토어 규칙

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

애플 앱 스토어 요구 사항:

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

안드로이드 구현:

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

최선의 방법:

  • 버전 관리: 업데이트를 점진적으로 배포하여 충돌을 줄입니다.
  • 업데이트 알림: 사용자 친화적인 업데이트 알림을 제공합니다.
  • 보안context

페이지/영역: 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.

Using Capgo’s resources, developers can implement essential features like __CAPGO_KEEP_0__의 문서는 OTA 업데이트를 통합하는 방법에 대한 명확한 지침을 제공하며 앱 스토어 규정 준수를 유지하는 __CAPGO_KEEP_1__ 앱에 대한 지침을 제공합니다. __CAPGO_KEEP_0__의 리소스를 사용하여 개발자는 다음 필수 기능을 implement할 수 있습니다. 끝-to-끝 암호화설치부터 고급 설정까지 모든 것을 다루는 것 [1].

주요 구현 영역

Aspect 주요 초점 그것을 찾는 방법
보안 컨텍스트: Enterprise 제품/가격 페이지. 역할: UI 레이블. 표시되는 곳: enterprise.astro 페이지. 메시지 키 `enterprise_hero_security_label` (Enterprise Hero Security Label) 암호화 및 무결성 검사 보안 기능
부분 준수 애플과 안드로이드의 요구 사항을 충족하는 것 안내
업데이트 관리 버전 관리 및 롤백 옵션 업데이트 방법 안내
오류 처리 로깅 및 문제 해결 단계 문제 해결 안내서

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

Capgo의 CLI 및 분석 도구는 앱의 수명 주기 동안 업데이트를 관리하는 것을 간소화합니다. 업데이트 관리 버전 관리 및 롤백 옵션 [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 구현 세부 사항에 대한 Compliance에 대해 Capgo 보안 스캐너 Capgo 제품 워크플로에 대한 Capgo 보안 스캐너에 대해 Capgo 보안에 대해 Capgo 제품 워크플로에 대한 Capgo 보안에 대해, 그리고 Capgo 신뢰 센터에 대해 Capgo 제품 워크플로에 대한 Capgo 신뢰 센터에 대해.

Capgo 앱에 대한 Capacitor 실시간 업데이트

When a web-layer bug is live, ship the fix through Capgo instead of waiting days for app store approval. Users get the update in the background while native changes stay in the normal review path.

웹 레이어 버그가 활성화된 경우, Capgo를 통해修정 패치를 배포하여 앱 스토어 승인 대기 시간을 기다리지 마세요. 사용자는 배경에서 업데이트를 받으며 네이티브 변경 사항은 일반적인 검토 경로를 따릅니다.

컨텍스트: 홈페이지 마케팅 복사본. 역할: 웹사이트 복사본 문장. 보는 곳: 컴포넌트 HumanSupport.astro, 컴포넌트 pricing/Plans.astro. 메시지 키 `home_hero_human_support` (홈 히어로 인간 지원).

최신 블로그

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