특정 사용자에게 즉시 변경 사항을 배포하고 그들의 피드백을 받고 싶으셨나요? TestFlight 또는 Google Play에서 새로운 빌드를 다운로드하고 설치하지 않고.
저는 고객이 요청한 개선 사항을 빠르게 implement 할 수 있었습니다. 그러나 결과를 고객의 손에 넣어 피드백을 받기 위해 업데이트를 모든 사용자에게 배포하거나 (실험적인 변경이 위험하므로) 고객에게만 배포하는 일회용 빌드를 생성하는 것은 모두에게 번거로웠습니다.
flexibility가 부족했습니다. 개발자들은 다양한 사용자 그룹, 예를 들어 비기술적 스태커, QA, 또는 적절한 경우 전체 사용자에게 업데이트를 제공할 수 있어야했습니다.
생산 빌드를 워크 인 프로세스 버전으로 전환하고 피드백을 수집하고 다시 생산 빌드로 돌아가야했습니다.
그것이 바로 채널 스루핑 을 가능하게 해줍니다. 사용자의 기기에 설치된 앱은 런타임에 업데이트 채널을switch할 수 있으므로, 프로덕션 앱을 검토 및 반복 가능한 공간으로 만들 수 있습니다. 이 대신에 고정된 엔드포인트가 됩니다. 비기술적인 이해관계자와 프로덕션 앱을 작업할 때 특히 유용합니다. 사용자가 이미 설치한 앱에서 변경 사항을 테스트하고 직접 피드백을 줄 수 있습니다.
업데이트 채널 이해하기
업데이트 채널은 Capgo이 특정 빌드에 대한 업데이트를 목표로하는 방법입니다. 각 빌드는 채널과 관련되어 있으며, 그 채널은 받을 업데이트를 결정합니다.
예를 들어, 사용자에게 영향을 미치지 않는 채널에 업데이트를 게시할 수 있습니다. 과거에는 채널을switch하기 위해 다른 네이티브 빌드를 설치하거나 수동으로 장치 할당을 대시보드에서 변경해야했습니다. preview __CAPGO_KEEP_0__의 채널은 다음과 같은 기능을 제공합니다. production특정 기능을 가진 사용자 그룹을 대상으로합니다.
Channels in Capgo allow you to:
- 새로운 기능을 점진적으로 출시합니다.
- 업데이트 채널을 사용하면 사용자에게 영향을 미치지 않는 채널에 업데이트를 게시할 수 있습니다. 업데이트 채널을 사용하면 사용자에게 영향을 미치지 않는 채널에 업데이트를 게시할 수 있습니다.
- 업데이트 채널을 사용하면 사용자에게 영향을 미치지 않는 채널에 업데이트를 게시할 수 있습니다.
- Create beta testing programs
- production 환경에서 개별 사용자와 디버그하는 방법
업데이트 채널에 대해 익숙하지 않다면 Capgo 채널 문서에서 더 자세히 설명되어 있습니다. Channel Surfing이란 무엇인가?
Channel Surfing은 설치된 앱이 재설치 없이 다른 업데이트스트림에서 업데이트를 pulls 할 수 있도록 해줍니다. 설치된 앱은 런타임에 업데이트 채널을 switch 할 수 있고, 새로 선택한 채널에서 업데이트를 계속 받을 때까지 앱이 삭제되거나 다른 채널로 switch 될 때까지.
실제로, 제품 관리자 또는 QA는 예를 들어
채널로 switch 할 수 있고, 최신 변경 사항을 테스트할 수 있습니다. 테스트가 끝나면 다시 production 채널로 switch 할 수 있습니다. 재설치나 별도의 미리보기 빌드가 필요하지 않습니다. preview Channel Surfing의 내부 동작은 앱이 업데이트 클라이언트에게 어떤 채널을 사용해야 하는지 알려주는 것입니다. 이 선택은 런타임에 변경될 수 있고, 삭제되거나 대체될 때까지 유지됩니다. production __CAPGO_KEEP_0__
__CAPGO_KEEP_0__
How to Implement Channel Surfing
프로젝트를 Capgo Live Updates와 연동하기 전에 채널 서핑을 시도하려면, Capgo Live Updates를 프로젝트에 설정해야 합니다. 이를 설정하려면 Capgo quickstart guide를 따라야 합니다. 채널 서핑을 위해 필요한 설정은 Capgo dashboard에서 'Allow devices to self associate'를 각 채널에 활성화하는 것입니다..
Capgo 설정이나 구성 변경이 필요하지 않습니다. 채널 서핑의 핵심은 단일 code 호출에 의해 구동됩니다.
이것은 API에서 업데이트를 조회할 때 사용되는 채널을 설정합니다.
import { CapacitorUpdater } from '@capgo/capacitor-updater';
await CapacitorUpdater.setChannel({ channel: 'your-channel' });setChannel Capgo에 대한 자세한 내용을 알아보세요. Learn more about the setChannel API.
플러그인 버전 5.34.0, 6.34.0, 7.34.0, 또는 8.0.0 (버전에 따라 다름)에 따라 __CAPGO_KEEP_0__
(버전에 따라 다름)에 따라 __CAPGO_KEEP_0__ Instant Channel Switching (v5.34.0+) setChannel() __CAPGO_KEEP_0__
- 백엔드 유효성 검사 (읽기 전용): Capgo 백엔드에 요청을 보내 Capgo 채널이 허용되는지 유효성 검사합니다.
- 로컬 스토리지 업데이트: 유효성 검사가 통과하면 장치의 로컬 스토리지에 채널을 저장합니다.
- 즉시 효과: 새로운 채널을 즉시 사용하기 위해 다음 업데이트를 확인할 때 사용합니다.
이전 setChannel() 백엔드 데이터베이스 (예: API 또는 Dashboard 변경)에서 채널 오버라이드 저장했습니다. 장치들은 백엔드 복제가 완료될 때까지 (2분 이내) 새로운 채널을 인식할 수 없었습니다. 새로운 동작은 유효성 검사만 백엔드에서 읽고 로컬에서 저장하기 때문에 채널 Switching이 즉시 발생합니다.
채널 Switching 완전한 흐름
사용자 경험을 개선하기 위해, 채널 Switching 후 앱 재시작을 기다리기만 하는 것보다 더 많은 작업을 수행하고 싶을 것입니다. 일반적인 접근 방식은 즉시 업데이트 확인, 다운로드, 앱 재로드를 수행하여 사용자가 선택한 채널의 업데이트로 직접 이동하도록 하는 것입니다.
일반적인 흐름은 다음과 같습니다.
- 채널 변경 (
setChannel) - 업데이트 확인 (
getLatest) - 업데이트를 가져와 적용 (
download,set또는next) - 앱을 다시 로드할 필요가 있는 경우 (
reload)
다음과 같은 완전한 예제입니다:
import { CapacitorUpdater } from '@capgo/capacitor-updater';
async function switchChannel(selectedChannel: string) {
try {
// 1. Set the updates channel (with optional auto-update trigger)
await CapacitorUpdater.setChannel({
channel: selectedChannel,
triggerAutoUpdate: true // Immediately check for updates
});
console.log(`Switched to channel: ${selectedChannel}`);
// If you want more control, handle the update manually:
// const latest = await CapacitorUpdater.getLatest();
// if (latest.url) {
// const bundle = await CapacitorUpdater.download({
// url: latest.url,
// version: latest.version
// });
// await CapacitorUpdater.set({ id: bundle.id });
// }
} catch (error) {
console.error('Failed to switch channel:', error);
}
}
// Switch to the beta channel
switchChannel('beta');이 흐름을 구조화하는 방법은 여러분에게 달려 있습니다. 여러 상호 작용을 통해 이러한 단계를 나누거나 한 번에 모두 실행할 수 있습니다. 흐름을 구조화하는 방법에 관계없이, 실패를 고려하십시오. 네트워크 문제 또는 유효하지 않은 채널은 모두 업데이트를 적용하는 것을 방해할 수 있습니다.
단 하나의 요구 사항: 자체 할당을 활성화하십시오.
자체 할당을 활성화하는 유일한 방법입니다. 앱이 채널을 switch하기 전에, 채널을 사용하는 setChannel(), you must enable self-assignment for that channel in the Capgo dashboard:
- 에 가서 자체 할당을 활성화하십시오: 다음으로 이동하십시오: 채널 Capgo 내 섹션
- __CAPGO_KEEP_0__ 내 섹션에서 채널 이름을 클릭하세요
- 활성화 “Allow devices to self associate”
- 변경 사항을 저장하세요
앱에서 설정 변경이 필요 없습니다. 단지 채널에서 스스로 할당을 활성화하세요. defaultChannel 이 설정이 비활성화되어 있다면, 이 채널을 호출하는 시도는 실패하고 이벤트는 발생합니다.
Listing Available Channels setChannel() 사용 가능한 채널 목록 channelPrivate 사용 가능한 채널 목록
사용 가능한 채널 목록
채널 목록을 가져와 자체 할당을 위해 사용할 수 있는 채널을 확인할 수 있습니다:
const { channels } = await CapacitorUpdater.listChannels();
console.log('Available channels:', channels.map(c => c.name));
// Use this to build a channel selector UI이것은 자체 할당이 활성화된 채널만 반환합니다.
현재 채널 가져오기
장치가 현재 할당된 채널을 확인하려면:
const { channel } = await CapacitorUpdater.getChannel();
console.log('Current channel:', channel);기본 채널로 되돌리기
기본 채널로 되돌아가기 위해 채널 오버라이드 제거하고:
await CapacitorUpdater.unsetChannel({});이것은 장치를 특정 채널에 할당된 채널에서 해제하여 기본 defaultChannel config 또는 클라우드 기본값으로 돌아갑니다.
채널 스루핑 테스트 방법
채널 스루핑을 실제로 확인하려면 릴리스 빌드를 필요로합니다 - @capgo/capacitor-updater API은 릴리스 빌드에 설계되었습니다. 디버그 빌드의 경우 앱은 일반 업데이트 흐름을 우회하는 개발 서버에서 자바스크립트를 로드하는 대신에 로드됩니다.
필수 조건
__CAPGO_KEEP_0__에서 설정된 Cloud 채널을 기준으로 앱이 시작됩니다. “기기 자체가 연결되도록 허용”을 각 채널에 대해 활성화합니다. 설정 변경은 필요하지 않습니다. 앱에서.
테스트 빌드 생성
앱을 일반적으로 빌드하세요.
bun run build && npx cap sync그런 다음 Xcode 또는 Android Studio를 사용하여 네이티브 빌드를 생성하거나 CI/CD PIPELINE을 사용하세요. 앱은 Capgo 대시보드에서 설정된 Cloud 채널 중 하나에 따라 시작됩니다.
다양한 채널에 업데이트를 게시하는 방법
앱이 설치된 후 다양한 채널에 업데이트를 게시하세요.
# Publish to preview channel
npx @capgo/cli@latest bundle upload --channel preview
# Publish to production channel
npx @capgo/cli@latest bundle upload --channel production그런 다음 앱 내의 채널 전환 UI로 이동하여 채널 전환을 트리거하세요. 선택한 채널에서 업데이트를 가져와 새 업데이트로 로드해야 합니다.
채널 전환 UI 만들기
채널 전환은 일반적으로 앱의 모든 사용자에게 노출시키고 싶지 않은 기능입니다. 예를 들어, 인증된 직원만이 앱을 프리뷰 채널로 전환할 수 있는 버튼을 노출할 수 있습니다.
채널 전환 UI를 위한 예제 React 컴포넌트입니다.
import { useState, useEffect } from 'react';
import { CapacitorUpdater } from '@capgo/capacitor-updater';
export function ChannelSwitcher() {
const [currentChannel, setCurrentChannel] = useState<string>('');
const [availableChannels, setAvailableChannels] = useState<string[]>([]);
const [isLoading, setIsLoading] = useState(false);
useEffect(() => {
loadChannelInfo();
}, []);
async function loadChannelInfo() {
const { channel } = await CapacitorUpdater.getChannel();
setCurrentChannel(channel || 'default');
const { channels } = await CapacitorUpdater.listChannels();
setAvailableChannels(channels.map(c => c.name));
}
async function handleChannelSwitch(channel: string) {
setIsLoading(true);
try {
await CapacitorUpdater.setChannel({
channel,
triggerAutoUpdate: true
});
setCurrentChannel(channel);
// App will update in background or on next restart
} catch (error) {
console.error('Failed to switch channel:', error);
} finally {
setIsLoading(false);
}
}
return (
<div>
<p>Current channel: {currentChannel}</p>
<div>
{availableChannels.map(channel => (
<button
key={channel}
onClick={() => handleChannelSwitch(channel)}
disabled={isLoading || channel === currentChannel}
>
Switch to {channel}
</button>
))}
</div>
</div>
);
}OTA 업데이트 주의 사항
이러한 문제는 채널 전환과 관련이 없지만, 채널 전환을 동시에 실행하면 빠르게 나타나는 문제입니다.
런타임 버전 불일치
업데이트는 Capgo에서 native 앱 버전과 연관되어 있습니다. 만약 업데이트된 native 버전이 설치된 native 버전과 일치하지 않으면 업데이트가 다운로드되거나 적용되지 않습니다. 채널 전환을 하게 되면, 앱이 채널을 전환하지만 업데이트가 적용되지 않는데, 업데이트가 존재하는 채널에 업데이트가 존재한다는 것을 알 수 있습니다.
업데이트가 다른 native 앱 버전에서 업데이트된 것을 의미합니다. 채널의 패키지를 native 버전과 호환되도록 확인하세요.
업데이트 삭제 또는 취소
앱이 이미 채널에 대한 업데이트를 다운로드한 경우, Capgo 대시보드에서 업데이트를 삭제하면 이미 업데이트를 다운로드한 기기에 업데이트를 삭제하지 않습니다. 삭제는 미래의 다운로드만 중단합니다. 업데이트가 잘못된 경우 가장 신뢰할 수 있는 방법은 동일한 채널에 알려진 좋은 업데이트를 게시하는 것입니다. 이로 인해 채널의 역사에서 새로운 업데이트가 생성되고, 클라이언트는 이 업데이트를 최신 버전으로 인식하고 적용합니다. __CAPGO_KEEP_0__도 이전에 안정적인 업데이트를 재적용하거나 빌드에 포함된 업데이트로 돌아가도록 클라이언트에게 지시하는 롤백 메커니즘을 제공합니다.
데이터 마이그레이션 고려 사항
Capgo also provides a rollback mechanism that can instruct clients to re-apply a previous stable update or fall back to the update embedded in the build.
downloads.
채널 전환은 앱이 실행하는 자바스크립트 번들을 변경합니다. 앱이 채널 간에 호환되지 않는 마이그레이션 또는 데이터 형식에 의존하는 경우, 전환을 반복하면 문제가 발생할 수 있습니다.
예를 들어, 베타 업데이트가 데이터베이스 마이그레이션을 적용하면, 프로덕션 버전은 새로운 스키마를 이해하지 못할 수 있습니다. 개발자는 업데이트가 전환 가능하도록 유지하거나 필요할 때 전환을 한 방향으로 제한해야 합니다.
채널 전환으로 인해 모바일 반복이 개선되는 이유
채널 전환은 특히 프로덕션 환경에서 변경 사항을 빠르게 검토할 필요가 있는 경우 유용합니다.
급한 버그 수정이 널리 배포되기 전에 검증이 필요할 때, 채널 전환은 변경 사항을 지정된 사용자만의 작은 집합으로 격리하여 검토할 수 있도록 해줍니다.
제품 소유자 또는 QA가 설치된 프로덕션 빌드를 다른 업데이트 채널로 전환하여 수정 또는 기능을 검증한 후 다시 프로덕션 채널로 전환할 수 있습니다.
이러한 변경 사항은 비전문가의 참여를 포함하여 검토 및 결정을 위한 워크플로우를 유지하면서, 단일 프로덕션 빌드를 테스트, 피드백 및 검증을 위한 유연한 도구로 사용할 수 있습니다.
사용 사례
QA 테스트
QA 테스트
QA 테스트
- QA 테스트: QA 팀이 기능 branch 간에 switch 할 수 있습니다.
- Beta 프로그램: 사용자가 출시 전 일찍 접근하기 위해 beta 채널에 가입합니다.
- 주주 검토: 제품 소유주가 출시 전 변경 사항을 미리 볼 수 있습니다.
- A/B 테스트: 사용자를 실험을 위해 다른 채널에 assign합니다.
- 디버깅: 특정 사용자를 디버깅 채널로 switch하여 문제를 진단합니다.
채널 변경 방법 비교
| 방법 | 효과 시간 | __CAPGO_KEEP_0__ 채널 assignments | 사용 사례 |
|---|---|---|---|
setChannel() 플러그인에서 |
즉시 | 기기만 (로컬) | 앱 내에서 사용자가 채널 switching을 유도하는 경우 |
| 기기 오버라이드 | 최대 2분 | 백엔드 데이터베이스 | 관리자-initiated 특정 기기 변경 |
| API 채널 assignments | 최대 2분 | 데이터베이스 | 자동화된 백엔드 통합 |
채널 전환 UI를 빌드할 때 최상의 사용자 경험을 제공하기 위해, 항상 플러그인의 setChannel() 메소드를 사용하세요.
최선의 방법
- 접근 제한: 채널 전환은 일반적으로 내부 사용자에게만 제공되므로 모든 사용자에게 노출하지 마세요.
- 오류 처리: 채널 전환 시 항상 오류를 부드럽게 처리하세요.
- 호환성 검증: 설치된 네이티브 버전과 호환되는 업데이트를 다른 채널에서 확인하세요.
- 채널 문서화: __CAPGO_KEEP_0__에 대한 각 채널의 목적을 명확하게 문서화하세요.
- 사용량 모니터링: 디버깅을 위해 채널별로 어떤 기기를 사용 중인지 추적하세요.
자원
결론
채널 전환은 Capacitor 앱의 개발을 어떻게 바꿀 수 있는지에 대한 새로운 관점을 제공합니다. 프로덕션 빌드가 고정된 엔드포인트가 아닌 유연한 테스트, 검증, 및 빠른 반복을 위한 도구로 변합니다.
최근 플러그인 버전에서 소개된 즉각적인 채널 전환 기능으로 인해 사용자 경험은 이제 더 이상 기다리지 않고 새 채널에서 업데이트를 즉시 받을 수 있습니다.
버그 수정을 검증하는 데 스테이크 홀더와 함께, 베타 프로그램을 실행하거나 특정 사용자와 문제를 디버깅하는 등, 채널 전환은 사용자에게 필요한 업데이트를 정확한 시간에 제공할 수 있는 유연성을 제공합니다.
채널 서핑에서 계속 진행하세요: Capgo: 런타임에서 업데이트 채널을 Switch하는 방법
이러한 기능을 사용하는 경우 Channel Surfing for Capgo: How to Switch Update Channels at Runtime 채널 라우팅과 스테이지드 롤아웃을 계획하고 연결하려면 채널 채널 채널 채널 Beta 테스트 솔루션 Beta 테스트 솔루션의 제품 워크플로우에 대해 채널 라우팅과 스테이지드 롤아웃을 계획하고 연결하려면 채널 버전 목표 설정 솔루션 버전 목표 설정 솔루션의 제품 워크플로에 대해.
