내용으로 건너뛰기

앱 페이지

앱 페이지가 보여주는 것은 무엇인가요?

제목이 ‘앱 페이지가 보여주는 것은 무엇인가요?’인 섹션

앱의 메인 페이지를 보겠습니다:

Capgo에서, 앱은 Capgo의 실시간 업데이트 시스템과 통합된 모바일 애플리케이션을 나타냅니다. 앱 업데이트, 채널 및 장치 관리를 편리하게 할 수 있습니다.

메인 페이지 스크린샷

이것을 더 자세히 살펴보겠습니다. 메인 앱 페이지는 여러 가지 중요한 영역으로 나누어져 있습니다:

  1. 상단 네비게이션 바: 메인 앱 관리 화면에 접근할 수 있습니다. 스크린샷은 일러스트레이션입니다. 현재 콘솔에는:

    • 대시보드: 앱에 대한 메트릭스 및 요약 정보
    • 관찰 (beta): 네이티브 런치, WebView, 문제 및 릴리스 건강 신호.
    • 정보: 핵심 앱 설정 및 세부 정보 (참조) 앱 정보).
    • 패키지: 버전 및 릴리스.
    • 채널: 업데이트 채널 및 점진적 롤아웃 제어.
    • 장치: 등록된 장치 및 오버라이드.
    • 로그: 로그 분석 및 로그.
    • 빌드: 자연어 빌드 관리.
  2. 통계 표시: 최근 청구 기간 동안 중요한 메트릭을 시각화합니다 (데이터는 청구일부터 사용되며 1 월 1 일부터는 반영되지 않음):

    • 월 활성 사용자 (8): 사용자 활동 수를 시간에 따라 추적합니다.
    • 저장소 (9): 현재 저장소 사용량을 표시합니다.
    • 대역폭 (10): 대역폭 사용량을 표시합니다.
    • 활성 패키지 (11): 활성 장치가 다양한 앱 패키지에 걸쳐 분산되는 분포를 보여줍니다.
  3. 요약 카드: 중요한 카운트에 대한 빠른 개요를 제공합니다.

    • 패키지 업로드 (12): 업로드 된 앱 패키지의 총 수입니다.
    • 업데이트 통계 (13): 업데이트 요청, 설치, 실패 포함 총 업데이트 수입니다.
    • 배포 통계 (14): 배포된 총 수입니다.
  4. 표시 옵션 (15-18): 통계를 필터링하고 표시하는 데 필요한 제어 요소입니다.

    • Daily (15): 일별 통계를 확인하세요.
    • Cumulative (16): 시간 경과에 따른 누적 통계를 확인하세요.
    • Billing Period (17): 현재 청구 기간에 대한 통계를 확인하세요.
    • Date Range (18): 사용자 지정 날짜 범위 (예: 최근 30일)를 선택하세요.

App Information

앱 정보

This section corresponds to the “Information” tab (1) in the top navigation bar. Here you can view and manage crucial details and settings for your application.

앱 정보 페이지
애플리케이션 정보 페이지

스크린샷은 현재 콘솔보다 오래되어 현재 모든 설정을 보여주지 않습니다. 아래 필드 설명을 참조하세요.

다음은 사용 가능한 필드와 작업의 설명입니다:

  • 애플리케이션 아이콘 (2): 애플리케이션 아이콘을 표시합니다. "변경" 버튼을 클릭하여 새로운 아이콘을 업로드할 수 있습니다.
  • 애플리케이션 ID (3): A unique identifier for your application within Capgo. This ID is not editable.
  • 애플리케이션 이름 (4): 애플리케이션의 표시 이름입니다. 필요에 따라 수정할 수 있습니다.
  • 기본 업로드 채널 (5): 새로운 번들을 업로드할 기본 채널을 지정합니다. 편집 아이콘을 클릭하여 다른 기본 채널을 선택할 수 있습니다.
  • 기본 다운로드 채널 (6): 기본 채널을 지정하여 장치가 업데이트를 다운로드할 채널을 지정합니다. 다른 기본 채널을 선택하려면 편집 아이콘을 클릭하세요. 자세한 정보는 아래의 기본 채널 구성 섹션을 참조하세요.
  • 자동으로 사용하지 않는 번들을 삭제 (x 초 후) (7): 이 설정을 통해 사용하지 않은 번들을 지정된 기간 (초) 동안 자동으로 삭제할 수 있습니다. 0으로 설정하여 자동 삭제를 비활성화하세요. 이 기능은 저장 공간 관리와 번들 목록을 정리하는 데 도움이 됩니다. 0 번들 메타데이터를 플러그인에 노출 (8):
  • 활성화하면 번들 링크 및 댓글 필드가 __CAPGO_KEEP_0__ Updater 플러그인으로 전송됩니다. 이 기능은 플러그인 버전 7.35.0 이상이 필요합니다. When enabled, bundle link and comment fields will be sent to the Capacitor Updater plugin. This feature requires plugin version 7.35.0 or higher.
  • 활성화하면 __CAPGO_KEEP_0__는 알려진 Google 및 Apple 데이터 센터 IP 범위에서 업데이트, 통계 및 채널-self 요청을 거부합니다. 일반적인 프로덕션 트래픽에 대해 활성화하여 두고 있는 경우, 제공자 인프라에서 의도적으로 테스트할 때만 일시적으로 비활성화하세요. 새로운 앱은 이 보호 기능을 기본적으로 활성화하고 있으며 기존 앱은 이전에 비활성화된 설정을 유지합니다. 설정을 변경할 때까지. When enabled, Capgo rejects update, stats, and channel-self requests from known Google and Apple datacenter IP ranges. Leave it enabled for normal production traffic. Disable it temporarily only when you intentionally test from provider infrastructure. New apps enable this protection by default; existing apps retain their previous disabled setting until you change it.
  • 이 섹션에서는 애플리케이션을 다른 조직으로 이전하기 위한 옵션을 제공합니다. section below for detailed information.
  • 삭제 앱 버튼: Permanently deletes your application from Capgo. This action is irreversible and will remove all associated data, bundles, channels, and devices.
  • 업데이트 버튼: 이 페이지의 편집 가능한 필드에 대한 모든 변경 사항을 저장합니다 (예: 앱 이름, 기본 업로드 채널, 자동 삭제 번들의 설정).

기본 채널 설정

기본 채널 설정

기본 다운로드 채널 앱의 가장 중요한 설정 중 하나입니다. 새로운 장치가 __CAPGO_KEEP_0__에 연결할 때 업데이트를 받을 채널을 결정합니다. is one of the most important settings for your app. It determines which channel new devices will receive updates from when they first connect to Capgo.

장치가 __CAPGO_KEEP_0__에서 업데이트를 요청할 때 시스템은 다음 순서에 따라 채널을 결정합니다 (가장 높은 우선순위부터):

Section titled “How Default Channels Work”

When a device requests an update from Capgo, the system determines which channel to use based on the following precedence (highest priority first):

  1. Forced device mapping: 만약 채널 설정에서 디바이스 ID를 명시적으로 강제로 채널에 할당하면, 그 채널은 항상 우선합니다.
  2. Cloud override: 만약 디바이스가 setChannel() or
  3. Capacitor config defaultChannel__CAPGO_KEEP_0__ config capacitor.config.* : 만약
  4. 파일에 설정되어 있다면, 이 설정은 테스트/베타 빌드에 사용됩니다.Default Download Channel

: 이 설정은 여기에서 구성됩니다. ~99%의 프로덕션 사용자는 이 설정을 사용합니다.

Platform-Specific Default Channels

플랫폼에 따라 기본 채널을 구성할 수 있습니다. 예를 들어 iOS, Android, Electron을 위한 채널을 각각 만들 수 있습니다. 이 기능은 다음과 같은 경우에 유용합니다.

  • 한 플랫폼에 업데이트를 먼저 출시하고 싶을 때
  • 각 플랫폼에 대해 다른 업데이트 전략이 필요할 때
  • 한 플랫폼에서 새로운 버전을 테스트하고 다른 플랫폼은 안정적인 상태를 유지하고 싶을 때

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

  1. 각 플랫폼에 대해 별도의 채널을 생성합니다. 예를 들어 production-ios, production-android, production-electron)
  2. 각 채널의 설정에서 해당 플랫폼만 활성화합니다 (iOS, Android, 또는 Electron toggle)
  3. 두 채널 모두 기본값으로 표시합니다 - Capgo은 채널이 다른 플랫폼을 대상으로 할 때 이 기능을 허용합니다

업데이트를 요청하는 장치가 업데이트를 받을 때:

  • iOS 장치에서는 iOS 채널에서 업데이트를 받습니다
  • Android 장치에서는 Android 채널에서 업데이트를 받습니다
단일 기본 채널 (대부분의 앱에 권장) 섹션

대부분의 앱의 경우, iOS, Android 및 Electron을 모두 지원하는 단일 기본 채널이 가장 단순한 접근 방식입니다.

  1. 1개의 채널을 생성합니다 (예시:) production)
  2. iOS, Android 및 Electron toggle이 모두 활성화되어야 합니다
  3. 기본 채널로 표시합니다

이것은 모든 플랫폼에서 일관된 동작을 보장하고 릴리스 워크플로를 단순화합니다.

기본 채널 변경

기본 채널을 변경할 때

새로운 장치

  • 새로운 기본 채널에서 즉시 업데이트를 시작합니다 새로운 장치
  • 기존 장치 이미 채널 할당이 있는 기존 장치 (override 또는 force를 통해)는 자동으로 Switch하지 않습니다.
  • 기존 장치를 이동하려면 다음 중 하나를 사용해야 합니다:
    • Use setChannel() 프로그래밍적으로 그들을 오버라이드하는 방법
    • Force를 사용하여 새로운 채널로 이동
    • 장치 엔트리 삭제 (새로운 기본값으로 재등록)

Tip: 새로운 기본 채널을 모든 사용자에게 적용하기 전에, 작은 그룹의 강제 장치를 사용하여 테스트하세요.

앱 페이지에서 계속

앱 페이지에서 계속하는 방법

이미 사용 중인 경우 애플리케이션 페이지 계획 대시보드 및 API 작업을 계획하고 연결하세요. API 개요 API 개요에서 구현 세부 정보를 위해 소개 소개에서 구현 세부 정보를 위해 API 키 API 키에서 구현 세부 정보를 위해 디바이스 디바이스에서 구현 세부 정보를 위해 블록 블록에서 구현 세부 정보를 위해