앱 페이지

앱 페이지에는 무엇이 표시되나요?

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

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

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

1. 상단 내비게이션 바: 앱 관리의 여러 섹션에 대한 접근을 제공합니다:

   • 대시보드 (1): 현재 뷰로, 주요 지표와 요약을 표시합니다.
   • 정보 (2): 앱의 핵심 설정과 세부 정보를 표시합니다 (아래 “앱 정보” 섹션 참조).
   • 번들 (3): 앱의 버전과 릴리스를 관리합니다.
   • 채널 (4): 다양한 업데이트 채널(예: 프로덕션, 베타)을 구성하고 관리합니다.
   • 디바이스 (5): 등록된 디바이스를 보고 관리하며, 특정 오버라이드를 설정합니다.
   • 로그 (6): 앱의 상세 로그 및 오류 보고서에 접근합니다.
   • 빌드 (7): 앱 빌드를 보고 관리합니다.

2. 통계 표시: 지난 청구 기간의 중요한 지표를 시각화합니다 (데이터는 월 1일이 아닌 청구일부터의 사용량을 반영합니다):

   • 월간 활성 사용자 (8): 시간에 따른 고유 활성 사용자 수를 추적합니다.
   • 스토리지 (9): 현재 스토리지 소비량을 표시합니다.
   • 대역폭 (10): 대역폭 사용량을 표시합니다.
   • 활성 번들 (11): 다양한 앱 번들에 걸친 활성 디바이스 분포를 표시합니다.

3. 요약 카드: 주요 수치의 빠른 개요를 제공합니다:

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

4. 표시 옵션 (15-18): 통계를 필터링하고 보기 위한 컨트롤:

   • 일별 (15): 일별 통계를 봅니다.
   • 누적 (16): 시간에 따른 누적 통계를 봅니다.
   • 청구 기간 (17): 현재 청구 기간의 통계를 봅니다.
   • 날짜 범위 (18): 사용자 지정 날짜 범위를 선택합니다 (예: 최근 30일).

앱 정보

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

앱 정보 페이지

사용 가능한 필드와 작업에 대한 설명:

• 앱 아이콘 (2): 애플리케이션의 아이콘을 표시합니다. “변경” 버튼을 클릭하여 새 아이콘을 업로드할 수 있습니다.
• 앱 ID (3): Capgo 내에서 애플리케이션의 고유 식별자입니다. 이 ID는 편집할 수 없습니다.
• 앱 이름 (4): 애플리케이션의 표시 이름입니다. 필요에 따라 수정할 수 있습니다.
• 기본 업로드 채널 (5): 새 번들이 업로드될 기본 채널을 지정합니다. 편집 아이콘을 클릭하여 다른 기본 채널을 선택할 수 있습니다.
• 기본 다운로드 채널 (6): 디바이스가 업데이트를 다운로드할 기본 채널을 지정합니다. 편집 아이콘을 클릭하여 다른 기본 채널을 선택할 수 있습니다. 자세한 내용은 아래 기본 채널 구성 섹션을 참조하세요.
• 사용하지 않은 번들 자동 삭제 (x초 후) (7): 이 설정을 사용하면 지정된 기간(초 단위) 동안 사용되지 않은 오래된 번들을 자동으로 삭제할 수 있습니다. 자동 삭제를 비활성화하려면 0으로 설정하세요. 이는 스토리지를 관리하고 번들 목록을 깨끗하게 유지하는 데 도움이 됩니다.
• 플러그인에 번들 메타데이터 노출 (8): 활성화되면 번들 링크와 코멘트 필드가 Capacitor Updater 플러그인으로 전송됩니다. 이 기능은 플러그인 버전 7.35.0 이상이 필요합니다.
• 앱 소유권 이전 (9): 이 섹션에서는 소속된 다른 조직으로 애플리케이션 이전을 시작하는 옵션을 제공합니다.
• 앱 삭제 버튼: Capgo에서 애플리케이션을 영구적으로 삭제합니다. 이 작업은 되돌릴 수 없으며 모든 관련 데이터, 번들, 채널, 디바이스가 제거됩니다.
• 업데이트 버튼: 이 페이지의 편집 가능한 필드에 대한 변경 사항을 저장합니다 (예: 앱 이름, 기본 업로드 채널, 번들 자동 삭제 설정).

기본 채널 구성

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

기본 채널 작동 방식

디바이스가 Capgo에 업데이트를 요청하면, 시스템은 다음 우선순위(최고 우선순위 먼저)에 따라 어떤 채널을 사용할지 결정합니다:

1. 강제 디바이스 매핑: 디바이스 ID가 채널 설정에서 명시적으로 채널에 강제된 경우, 해당 채널이 항상 우선합니다.
2. 클라우드 오버라이드: 디바이스가 setChannel()을 통해 또는 대시보드에서 수동으로 채널에 할당된 경우, 해당 오버라이드가 사용됩니다.
3. Capacitor config defaultChannel: capacitor.config.* 파일에 설정된 경우, 테스트/베타 빌드에 사용됩니다.
4. 기본 다운로드 채널: 여기서 구성된 설정—프로덕션 사용자의 ~99%가 이것을 사용합니다.

플랫폼별 기본 채널

두 개의 별도 기본 채널을 구성할 수 있습니다—하나는 iOS용, 하나는 Android용입니다. 다음과 같은 경우에 유용합니다:

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

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

1. 두 개의 채널을 만듭니다 (예: production-ios와 production-android)
2. 각 채널 설정에서 관련 플랫폼만 활성화합니다 (iOS 또는 Android 토글)
3. 두 채널을 모두 “기본”으로 표시합니다 - 채널이 다른 플랫폼을 대상으로 할 때 Capgo는 이를 허용합니다

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

• iOS 디바이스는 iOS가 활성화된 기본 채널에서 업데이트를 받습니다
• Android 디바이스는 Android가 활성화된 기본 채널에서 업데이트를 받습니다

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

대부분의 애플리케이션에서 두 플랫폼을 모두 지원하는 단일 기본 채널이 가장 간단한 접근 방식입니다:

1. 하나의 채널을 만듭니다 (예: production)
2. iOS와 Android 토글이 모두 활성화되어 있는지 확인합니다
3. 기본 채널로 표시합니다

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

기본 채널 변경

기본 채널을 변경하면:

• 새 디바이스는 즉시 새 기본값에서 업데이트를 받기 시작합니다
• 기존 디바이스가 이미 채널 할당(오버라이드 또는 강제를 통해)이 있는 경우 자동으로 전환되지 않습니다
• 기존 디바이스를 이동하려면:
  • setChannel()을 사용하여 프로그래밍 방식으로 오버라이드
  • 대시보드에서 새 채널로 강제
  • 디바이스 항목 삭제 (새 기본값으로 다시 등록됨)

팁: 모든 사용자의 기본값으로 설정하기 전에 항상 소규모 강제 디바이스 그룹으로 새 기본 채널을 테스트하세요.