커스텀 도메인

이 플러그인의 설치 단계와 전체 마크다운 가이드가 포함된 설정 프롬프트를 복사하세요.

다음과 같은 사용자 지정 호스트 이름을 사용하세요: updates.example.com. Capgo가 채널, bundle, rollout을 계속 관리하는 동안 앱의 Live Updates API 요청에 적용됩니다.

Custom domain은 다음 플랜에서 사용할 수 있습니다: Enterprise 플랜. 조직 관리자는 Console에서 Live Updates API 호스트 이름을 추가하고, 제공된 DNS 레코드를 게시하며, 활성화 상태를 확인할 수 있습니다.

1. 사용자 지정 도메인 추가

다음 항목을 여세요: Capgo 콘솔 및 조직을 선택하세요.
다음으로 이동: 설정 → Organization → General 를 찾아 커스텀 도메인. 조직 설정을 업데이트할 권한과 도메인 추가를 위한 활성 Enterprise 플랜이 필요합니다.
다음과 같은 호스트 이름을 입력하세요: updates.example.com를 제외한 https://, 경로 또는 와일드카드는 제외됩니다.
클릭 도메인 추가. Console에 게시할 DNS 레코드와 인증 대기 중 상태입니다.

조직당 하나의 Live Updates API 호스트네임을 설정할 수 있습니다. DNS 레코드를 편집할 수 있어야 합니다.

만약 커스텀 도메인 옵션을 사용할 수 없다면, Enterprise 지원 담당자에게 문의하거나 support@capgo.app 로 조직명, 앱 ID, 원하는 호스트네임, DNS 제공업체를 적어 메일을 보내주세요. 특정 데이터 레지던시 지역 또는 번들 다운로드용 커스텀 호스트네임이 필요한 경우 설정 전에 지원팀에 문의하시기 바랍니다.

2. DNS 설정 및 HTTPS 확인

DNS 제공업체에서 Console에 표시된 레코드 또는 지원팀이 제공한 레코드를 추가하세요. CNAME 및 소유권/인증용 TXT 레코드를 포함하여 레코드 유형, 이름, 값을 정확하게 복사해야 합니다. Console에서 값을 클릭하면 복사할 수 있습니다. Cloudflare DNS를 사용하는 경우, CNAME을 DNS 전용 유지하세요. 단, 지원팀에서 다른 설정을 안내한 경우는 예외입니다.

단순히 CNAME을 설정하는 것만으로 충분하다고 가정하지 말고, 제공된 타겟 값을 사용하세요. plugin.capgo.app 도메인을 사용하는 동안에는 DNS 레코드를 그대로 유지해야 합니다.

DNS 전파가 완료되면 상태 새로고침. Console에서는 활성 hostname과 HTTPS 인증서가 모두 활성화된 경우에만 표시되며, 그런 다음 제공합니다 업데이터 설정 복사. 지원팀의 도움을 받아 설정하는 경우, 지원팀에 활성화 확인을 요청하세요. 다음 명령으로 DNS를 확인하고 TLS 연결을 점검할 수도 있습니다:

dig updates.example.com
curl -v https://updates.example.com/updates

교체 updates.example.com 프로비저닝된 hostname으로. curl 명령어는 DNS, TLS, HTTP 연결을 확인합니다. 다음에 대한 GET 요청은 /updates 유효한 업데이트 확인이 아니며 API 오류를 반환할 수 있습니다. 4단계에서 네이티브 테스트 build로 실제 업데이트 흐름을 검증하세요.

3. 업데이터 설정

도메인이 활성화되면 Console에서 updater 설정을 복사하여 다음 세 가지 URL을 capacitor.config.ts에 병합하세요. 표준 Capgo API 경로로 프로비저닝된 호스트네임의 경우 다음을 사용합니다:

import type { CapacitorConfig } from '@capacitor/cli';

const config: CapacitorConfig = {
  appId: 'com.example.app',
  appName: 'My App',
  webDir: 'dist',
  plugins: {
    CapacitorUpdater: {
      autoUpdate: 'atBackground',
      updateUrl: 'https://updates.example.com/updates',
      statsUrl: 'https://updates.example.com/stats',
      channelUrl: 'https://updates.example.com/channel_self',
    },
  },
};

export default config;

예시 URL을 Console에 표시된 정확한 URL 또는 지원팀을 통해 확인된 URL로 교체하세요. 기존 앱 설정 및 기타 플러그인 옵션은 그대로 유지해야 합니다.

설정	목적
`updateUrl`	사용 가능한 bundle이 있는지 확인합니다.
`statsUrl`	업데이트 통계를 보고합니다.
`channelUrl`	디바이스 channel 작업을 처리합니다.

4. 동기화, 테스트 및 출시

설정을 네이티브 프로젝트에 동기화하세요:

npx cap sync

네이티브 테스트 버전을 빌드 및 설치한 후 다음을 수행합니다:

테스트 번들을 다음으로 업로드하세요: 테스트 채널 기존 Capgo 워크플로우를 사용하여.
네이티브 디바이스 로그를 확인하여 업데이트 요청이 커스텀 호스트네임에 도달하는지, 그리고 Bundle이 성공적으로 다운로드 및 설치되는지 확인하세요.
앱에서 업데이트 통계를 사용하는 경우, Console 및 테스트 채널 작업에 통계가 표시되는지 확인하세요.
평소와 동일한 스토어 배포 프로세스를 통해 새로운 native app 버전을 출시하세요.

이전 native 버전 사용자들은 새로운 native 버전을 설치하기 전까지 기존에 설정된 엔드포인트 URL을 계속 사용합니다. updater의 기본 호스트네임은 plugin.capgo.app이며, 이는 Capgo에서 관리합니다. 직접 관리하던 다른 커스텀 호스트네임에서 마이그레이션하는 경우, 해당 사용자들이 모두 마이그레이션할 때까지 DNS 레코드와 서비스를 활성 상태로 유지하세요. Channels, bundle uploads, rollbacks는 기존과 동일하게 Capgo Console 및 CLI 워크플로우를 사용합니다.

문제 해결

도메인을 삭제하려면 도메인 삭제 → 삭제 확인 를 Organization settings에서 실행하세요. 먼저 대체 엔드포인트를 사용하는 native app 버전을 출시하여 사용자들이 마이그레이션할 수 있도록 하세요. 이전 버전 사용자들은 삭제된 호스트네임을 통한 접속이 차단됩니다. 조직(organization)을 삭제하기 전에 도메인을 먼저 삭제하세요.

DNS 해석 실패: 지원팀에서 제공한 레코드 이름 및 타겟 값을 확인하고, DNS 제공업체를 통해 전파 상태를 확인하세요.
HTTPS 오류: Native Build를 배포하기 전에 지원팀에 호스트네임 활성화 및 인증서 프로비저닝 확인을 요청하세요.
요청이 여전히 다음을 사용하는 경우: plugin.capgo.app: 세 가지 URL을 모두 확인하고, npx cap sync다시 빌드한 후 새 Native 버전을 설치하세요.
Bundle 다운로드에 다른 호스트네임이 사용되는 경우: 업데이트 응답에서 다운로드 URL을 제공합니다. 커스텀 Bundle 전송에 대해 지원팀에 문의하거나, 커스텀 스토리지 Bundle 스토리지를 직접 관리하고 싶은지 확인하세요.
HTTPS가 유효함에도 업데이트가 실패하는 경우: 앱 ID, 채널, native version, 요청 타임스탬프, native logs를 Capgo 지원팀에 공유해 주세요..

자세한 내용은 Updater 설정 전체 구성 참조와 데이터 위치 지역별 엔드포인트 요구 사항을 확인하세요.