앱 페이지

앱 페이지에서는 무엇을 볼 수 있나요?

먼저 앱의 메인 페이지를 살펴보겠습니다:

Capgo에서 앱은 Capgo의 live update 시스템과 통합된 모바일 애플리케이션을 의미합니다. 이를 통해 업데이트, 채널 및 디바이스를 원활하게 관리할 수 있습니다.

자세히 살펴보겠습니다. 메인 앱 페이지는 다음과 같은 주요 영역으로 나뉩니다:

1. 상단 네비게이션 바: 메인 앱 관리 뷰로 이동할 수 있습니다. 스크린샷은 예시이며, 현재 콘솔에는 다음 항목이 포함되어 있습니다:

   • 대시보드: 앱의 메트릭 및 요약 정보.
   • Observe (beta): Native 실행, WebView, 이슈 및 릴리스 상태 신호.
   • 정보: 핵심 앱 설정 및 상세 정보(참조 앱 정보).
   • 번들: 버전 및 릴리스.
   • 채널: 업데이트 채널 및 단계적 배포 제어.
   • 기기: 등록된 디바이스 및 오버라이드.
   • 로그: 로그 인사이트 및 로우 로그(raw logs).
   • Builds: Native Build 관리.

2. 통계 표시: 지난 결제 기간의 주요 지표를 시각화합니다 (데이터는 매월 1일이 아닌 결제일을 기준으로 집계됩니다):

   • 월간 활성 사용자 수 (8): 시간 경과에 따른 고유 활성 사용자 수를 추적합니다.
   • 스토리지 (9): 현재 스토리지 사용량을 보여줍니다.
   • 대역폭 (10): 대역폭 사용량을 표시합니다.
   • 활성 번들 (11): 각 앱 번들별 활성 디바이스 분포를 보여줍니다.

3. 요약 카드: 주요 수치를 한눈에 확인할 수 있습니다:

   • 번들 업로드 (12): 업로드된 앱 bundle 총 개수입니다.
   • 업데이트 통계 (13): 요청, 설치, 실패를 포함한 총 업데이트 횟수입니다.
   • 배포 통계 (14): 총 배포 횟수입니다.

4. 표시 옵션 (15-18): 통계 필터링 및 보기 제어 항목:

   • 일별 (15): 일 단위 통계를 확인합니다.
   • 누적 (16): 시간 경과에 따른 누적 통계를 확인합니다.
   • 결제 주기 (17): 현재 결제 기간의 통계를 확인합니다.
   • 날짜 범위 (18): 사용자 지정 날짜 범위(예: 최근 30일)를 선택하세요.

앱 정보

이 섹션은 상단 네비게이션 바의 “Information” 탭(1)에 해당합니다. 여기서 애플리케이션의 주요 세부 정보와 설정을 확인하고 관리할 수 있습니다.

App Information 페이지

스크린샷은 현재 콘솔 버전보다 이전 버전이므로 모든 최신 설정이 표시되지 않을 수 있습니다. 아래 필드 설명을 기준으로 확인해 주세요.

사용 가능한 필드와 작업은 다음과 같습니다:

• 앱 아이콘 (2): 애플리케이션 아이콘을 표시합니다. “Change” 버튼을 클릭하여 새 아이콘을 upload할 수 있습니다.
• App ID (3): Capgo 내에서 앱을 식별하는 고유 ID입니다. 이 ID는 수정할 수 없습니다.
• 앱 이름 (4): 앱의 표시 이름입니다. 필요에 따라 수정할 수 있습니다.
• 기본 업로드 채널 (5): 새 bundle이 업로드될 기본 채널을 지정합니다. 편집 아이콘을 클릭해 다른 기본 채널을 선택할 수 있습니다.
• 기본 다운로드 채널 (6): 디바이스가 업데이트를 다운로드할 기본 채널을 지정합니다. 편집 아이콘을 클릭해 다른 기본 채널을 선택할 수 있습니다. 채널 페이지에서 해당 채널이 기본인지 확인할 수 있지만, 변경은 채널의 토글이 아니라 여기서 해야 합니다. 채널을 열고 App 설정에서 관리 클릭하면 이 필드로 바로 이동합니다. 자세한 내용은 아래의 기본 채널 설정 섹션을 참조하세요.
• 미사용 번들 자동 삭제 (x초 후) (7): 지정된 시간(초) 동안 사용되지 않은 오래된 번들을 자동으로 삭제하는 설정입니다. 자동 삭제를 0 하려면 비활성화하세요. 저장 공간을 관리하고 번들 목록을 깔끔하게 유지하는 데 도움이 됩니다.
• 플러그인에 번들 메타데이터 노출 (8): 활성화하면 번들 링크와 코멘트 필드가 Capacitor Updater 플러그인으로 전송됩니다. 이 기능을 사용하려면 플러그인 버전 7.35.0 이상이 필요합니다.
• 프로바이더 인프라 요청 차단: 활성화하면 Capgo는 알려진 Google 및 Apple 데이터 센터 IP 범위에서 오는 업데이트, 통계, channel-self 요청을 거부합니다. 일반적인 프로덕션 트래픽을 위해서는 활성 상태를 유지하세요. 프로바이더 인프라를 통해 의도적으로 테스트할 때만 일시적으로 비활성화하세요. 신규 앱은 이 보호 기능이 기본으로 활성화되며, 기존 앱은 설정을 변경하기 전까지 이전의 비활성화 상태를 유지합니다.
• 앱 소유권 이전 (9): 이 섹션에서는 귀하가 속한 다른 조직으로 애플리케이션 소유권 이전을 시작할 수 있는 옵션을 제공합니다.
• 앱 삭제 버튼: Capgo에서 애플리케이션을 영구적으로 삭제합니다. 이 작업은 되돌릴 수 없으며 모든 관련 데이터, 번들, 채널 및 디바이스가 삭제됩니다.
• 업데이트 버튼: 이 페이지에서 편집 가능한 필드(예: 앱 이름, 기본 업로드 채널, 번들 자동 삭제 설정)에 적용한 모든 변경 사항을 저장합니다.

기본 채널 설정

이 기본 다운로드 채널 앱의 가장 중요한 설정 중 하나입니다. 새 기기가 Capgo에 처음 연결될 때 어떤 채널에서 업데이트를 받을지 결정합니다.

기본 채널 작동 방식

기기가 Capgo에 업데이트를 요청하면, 시스템은 다음 우선순위(높은 것부터)에 따라 어느 채널을 사용할지 결정합니다:

1. 강제 디바이스 매핑: 채널 설정에서 device ID를 특정 채널로 명시적으로 강제 지정한 경우, 해당 채널이 항상 우선합니다.
2. 클라우드 오버라이드: 대시보드나 Public API에서 기기에 채널이 할당된 경우, 해당 override가 사용됩니다.
3. 플러그인 setChannel(): 현재 플러그인 버전에서는 대시보드 override가 아닌 로컬 할당입니다. 참고: 기기가 채널을 선택하는 방식.
4. Capacitor 설정 defaultChannel: 만약 다음 capacitor.config.* 파일에 설정되어 있다면, 테스트/베타 빌드에 사용됩니다.
5. 기본 다운로드 채널: 여기에서 설정한 값입니다. 프로덕션 사용자의 약 99%가 이 설정을 사용합니다.

플랫폼별 기본 채널

iOS, Android, Electron 등 플랫폼별로 기본 채널을 다르게 구성할 수 있습니다. 다음과 같은 경우에 유용합니다:

• 한 플랫폼에 먼저 업데이트를 배포하고 싶을 때
• 플랫폼별로 서로 다른 업데이트 전략이 필요할 때
• 한 플랫폼에서 새 버전을 테스트하면서 다른 플랫폼은 안정적으로 유지하고 싶을 때

플랫폼별 기본값을 설정하려면:

1. 각 플랫폼을 위한 별도의 채널을 생성하세요 (예: production-ios, production-android, 그리고 production-electron)
2. 각 채널 설정에서 해당 플랫폼만 활성화하세요 (iOS, Android 또는 Electron 토글)
3. 웹 앱 정보), 그런 다음 각 채널을 해당 플랫폼의 Default Download Channel로 설정하세요. Capgo를 사용하면 채널이 서로 다른 플랫폼을 대상으로 할 때 여러 개의 기본 채널을 지정할 수 있습니다.

디바이스가 업데이트를 요청하면:

• iOS 디바이스는 iOS가 활성화된 기본 채널로부터 업데이트를 받게 됩니다
• Android 기기는 Android가 활성화된 기본 채널로부터 업데이트를 받습니다.

단일 기본 채널 (대부분의 앱에 권장)

대부분의 애플리케이션에서는 세 가지 핵심 플랫폼을 모두 지원하는 단일 기본 채널을 사용하는 것이 가장 간단합니다:

1. 채널을 하나 생성합니다 (예: production)
2. iOS, Android, Electron 토글이 활성화되어 있는지 확인합니다
3. 이를 Default Download Channel로 설정합니다 앱 정보

이렇게 하면 모든 플랫폼에서 일관된 동작을 보장하며 릴리스 워크플로우가 단순해집니다.

기본 채널 변경하기

기본 채널을 변경할 때:

• 새 기기들은 새로운 기본 채널로부터 즉시 업데이트를 받기 시작합니다.
• 기존 기기 중 이미 채널이 할당된 기기(override 또는 force 사용)는 자동으로 전환되지 않습니다.
• 기존 기기를 이동하려면 다음 중 하나를 수행해야 합니다:
  • 사용 setChannel() (또는 unsetChannel()) 앱에서 삭제합니다. 백엔드 기기 레코드를 삭제해도 로컬 setChannel() 할당은 해제되지 않습니다.
  • 대시보드에서 새 채널로 강제 지정(console/API override; 90일 후 만료)
  • console/API override를 삭제하여 우선순위에서 제외합니다. 클라우드 기본값만 남은 기기는 새로운 기본값을 적용받게 됩니다.

팁: 모든 사용자에게 기본 채널로 적용하기 전에, 소수의 강제 지정 기기(forced devices)를 대상으로 새 기본 채널을 반드시 먼저 테스트하세요.

App Page에서 계속하기

사용 중이라면 앱 페이지 대시보드 및 API 운영을 계획하려면, 이를 다음과 연결하세요 API 개요 구현 세부 사항은 API 개요에서 소개 구현 세부 사항은 소개에서 API 키 구현 세부 사항은 API 키에서 기기 구현 세부 사항은 기기에서, 그리고 번들 Bundles의 구현 세부 사항은