다음을 통해 공유


CodePush

중요

Visual Studio App Center는 2025년 3월 31일에 사용 중지될 예정입니다. Visual Studio App Center가 완전히 사용 중지될 때까지 계속 사용할 수 있지만 마이그레이션을 고려할 수 있는 몇 가지 권장 대안이 있습니다.

지원 타임라인 및 대안에 대해 자세히 알아보세요.

CodePush는 React Native 개발자가 모바일 앱 업데이트를 사용자의 디바이스에 직접 배포할 수 있도록 하는 App Center 클라우드 서비스입니다. 개발자가 특정 업데이트(예: JS, HTML, CSS 및 이미지 변경 내용)를 게시할 수 있는 중앙 리포지토리 역할을 하며 앱은 제공된 클라이언트 SDK를 사용하여 에서 업데이트를 쿼리할 수 있습니다. 이렇게 하면 버그를 해결하는 동안 최종 사용자와 보다 결정적이고 직접적인 참여 모델을 만들거나, 이진 파일을 다시 빌드할 필요가 없는 작은 기능을 추가하거나, 공용 앱 스토어를 통해 재배포할 수 있습니다. App Center에서 만든 모든 React Native 앱은 기본적으로 CodePush를 사용하도록 설정됩니다. CodePush 사용을 시작하려면 다음 단계가 필요합니다.

참고

Android 디바이스의 경우 CodePush는 TLS 1.2 호환 디바이스에서만 작동합니다.

참고

CodePush API 사용량에는 적용된 5분당 8개 요청의 속도 제한이 있습니다. 요청된 엔드포인트, IP 요청의 원본, 배포 키 및 클라이언트 고유 ID의 조합별로 계산됩니다. 제한에 도달하면 상태 코드 429가 포함된 응답이 반환됩니다.

{
   "statusCode": 429,
   "message": "Rate limit is exceeded. Try again in X seconds."
}

1. App Center CLI 설치

App Center CLI를 사용하여 대부분의 CodePush 기능을 관리합니다. CLI를 설치하려면 터미널 창 또는 명령 프롬프트를 열고 다음 명령을 실행합니다.

npm install -g appcenter-cli

참고

이 명령을 실행하는 동안 오류가 발생하면 EACCES시스템에 대한 npm 권한을 수정해야 할 수 있습니다. 많은 사이트에서 명령을 사용하여 sudo 이 오류를 해결하는 것이 좋지만 를 사용하여 sudonpm 모듈을 설치해서는 안 됩니다.

App Center CLI를 성공적으로 설치한 후 명령을 실행 appcenter login 하여 App Center 계정 세부 정보에 대한 CLI를 구성합니다.

2. CodePush-ify 앱

CodePush 클라이언트 SDK를 앱에 추가하고 App Center의 배포 중 하나에서 앱 업데이트를 가져오도록 구성합니다. 다음 섹션에서는 지원되는 앱 플랫폼에 대해 이 작업을 수행하는 방법에 대해 자세히 설명합니다.

3. 앱 업데이트 릴리스

앱의 코드 또는 자산을 변경한 후 다음 섹션에 설명된 대로 App Center CLI를 사용하여 App Center에 업데이트를 게시합니다.

React Native

App Center CLI release-react 명령을 실행하여 앱의 코드 및 자산 파일을 번들로 묶은 다음, App Center 서버에 새 릴리스로 게시합니다. 예를 들면 다음과 같습니다.

appcenter codepush release-react -a <ownerName>/MyApp

Cordova

App Center CLI release-cordova 명령을 실행하여 앱의 코드 및 자산 파일을 번들로 묶은 다음, App Center 서버에 새 릴리스로 게시합니다. 예를 들면 다음과 같습니다.

appcenter codepush release-cordova -a <ownerName>/MyApp

App Center CLI의 중요한 기능 중 하나는 을 사용하여 appcenter apps set-current <ownerName>/<appName>앱을 현재 앱으로 설정하는 기능입니다. 앱을 현재 앱으로 설정하면 플래그를 사용할 -a 필요가 없습니다. 예를 들어 appcenter codepush deployment list -a <ownerName>/<appName> 명령은 현재 앱이 설정된 것처럼 appcenter codepush deployment list 입력할 수 있습니다. 를 사용하여 appcenter apps get-current계정의 현재 앱으로 설정된 앱을 검사 수 있습니다. 이 명령을 사용하면 대부분의 CLI 명령이 더 짧아지게 됩니다.

4. 앱 실행

이러한 단계가 완료되면 앱을 실행하는 모든 사용자는 2단계에서 구성한 환경을 사용하여 업데이트를 받게 됩니다. 자세한 내용은 CLI 및 클라이언트 SDK 설명서(Apache Cordova, React Native)를 참조하세요.