V2에서 V3로

이 문서는 auto-update의 버전 3로 업그레이드하는 방법을 설명합니다.

먼저 최신 툴링으로 마이그레이션하세요:

npm remove -g capgo
npm remove capacitor-updater

npm i @capgo/cli
npm i @capgo/capacitor-updater@3
npx cap sync

기존 설정을 모두 삭제하세요:

{
  CapacitorUpdater: {
      autoUpdateURL: "https...",
      ...
  },
}

이것만 남기도록

{
  "CapacitorUpdater": {
    "autoUpdate": true
  }
}

⚠️ 서버를 사용 중이시라면 autoUpdateURL, 이 가이드를 곧 업데이트하겠습니다. 그 동안 새로운 업로드 옵션을 확인해 보세요 external 이 옵션은 zip 파일의 링크만 전송할 수 있어 Capgo 클라우드에 code를 올리지 않습니다. 엄격한 개인정보 보호 정책을 가진 기업을 위해 만들었습니다. 외부 모드에서는 code가 Capgo 서버에 저장되지 않으며, URL만 저장한 뒤 디바이스에 전송하여 디바이스가 직접 다운로드합니다. 표준 방식에서는 code가 압축되어 서버에 저장되지만, 우리는 이를 열거나 사용하지 않습니다.

변경 사항

자동 업데이트를 위해 모든 설정이 서버 측으로 이동하여, 사용자에게 업데이트를 보내는 방식을 더 세밀하게 제어할 수 있습니다.

이로써 채널을 이용해 롤백하거나 특정 사용자 1명에게만 배포할 수 있습니다. 이러한 설정들이 웹 인터페이스에 다시 추가되었습니다:

• 네이티브에서 revert 비활성화
• 메이저 버전 이상 업데이트 비활성화

⚠️ 모든 채널에서 기본적으로 true로 설정됩니다

이로 인해 플러그인을 자주 업데이트할 필요가 사라집니다. 대부분의 업데이트가 서버 측에서 이루어지며, 클라이언트 측 변경 없이 적용됩니다.

⚠️ 업데이트가 기본이 될 때 리셋됩니다. 스토어에서 업데이트할 때 모든 다운로드 버전을 삭제하지 않으려면 다음을 수행하세요:

{
  "CapacitorUpdater": {
    "autoUpdate": true,
    "resetWhenUpdate": false
  }
}

code 업데이트하기

마지막으로, JS의 모든 import를 다음에서:

import { CapacitorUpdater } from 'capacitor-updater'

대상

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

그런 다음 code를 다시 빌드하세요 npm run build 그리고 에셋을 한 번 더 복사하세요 npx cap copy.

이제 최신 자동 업데이트 시스템을 테스트할 수 있습니다

다음 명령어로 버전을 전송하세요:

npx @capgo/cli@latest bundle upload

를 전달하고

npx capgo upload

향후 발전 방향

현재는 첫 번째 public 채널만 사용 중이지만, 향후 public 채널이 두 개 이상 설정되면 multi public 채널로 변경될 예정입니다.

자주 발생하는 문제:

• 업그레이드 후 빌드 문제: Android Studio 또는 Xcode에서 플러그인의 code 소스를 이미 열었다면, 동기화 시 해당 파일이 제거되지 않아 문제가 발생할 수 있습니다. 네이티브 IDE를 열어 수동으로 제거하세요. capacitor-updater 수동으로 제거하고 npx cap sync 이렇게 하면 해결됩니다.

V2에서 V3로 계속 진행하기

사용 중이라면 V2에서 V3로 live update 배포를 계획하려면, 다음과 연결하세요 Capgo Live Update Capgo Live Updates의 제품 워크플로우를 보려면, 개요 Overview의 구현 상세를 보려면, 기능 Features의 구현 상세를 보려면, 업데이트 동작 Update Behavior의 구현 세부 사항은 다음과 같고, 업데이트 유형 Update Types의 구현 세부 사항은 다음과 같습니다.