비고
이 페이지에서는 Microsoft Store 개발자 CLI를 사용하여 MSI/EXE 앱 게시를 다룹니다. Microsoft Store 개발자 CLI를 사용한 MSIX 앱 게시에 대한 자세한 내용은 여기를 클릭하세요.
Microsoft Store 명령줄 인터페이스는 사용자의 애플리케이션에 대한 업데이트를 Microsoft Store에 게시하는 데 도움이 되는 플랫폼 간(Windows, macOS, Linux) CLI입니다. MSI/EXE 앱의 경우 CLI는 파트너 센터 API 를 호출하여 개발자 호스팅 설치 관리자의 URL을 포함하는 패키지 메타데이터를 제출합니다. 스토어는 해당 URL에서 설치 관리자를 가져옵니다. CLI는 설치 관리자 이진 파일을 패키지하거나 업로드하지 않습니다. 호스팅 요구 사항은 패키지 정보 추가 및 편집을 참조하세요.
중요합니다
파트너 센터를 통해 앱의 첫 번째 Microsoft Store 게시를 완료해야 합니다. 앱이 게시되면 Microsoft Store Developer CLI를 사용하여 후속 업데이트를 게시할 수 있습니다.
스토어 개발자 CLI를 사용하는 프로세스는 MSI/EXE 및 MSIX 앱 모두에 대해 동일합니다. 따라서 사용하는 방법을 이해하려면 다음 비디오를 확인하세요.
필수 조건
Microsoft Store 개발자 CLI를 사용하려면 다음을 수행해야 합니다.
- 파트너 센터에서 Windows 앱 개발자로 등록
- 파트너 센터 계정과 연결된 테넌트를 확보합니다. 파트너 센터에서 기존 Microsoft Entra ID를 연결하거나 파트너 센터에서새 Microsoft Entra ID를 만들어 이를 달성할 수 있습니다.
- 파트너 센터에서 앱을 이미 만들었습니다. 앱이 아직 없는 경우 파트너 센터에서 이름을 예약하여 앱을 만듭니 다. CLI에서 앱을 만들 수 없습니다.
- 파트너 센터를 통해 앱의 첫 번째 게시를 완료합니다. 앱에 대한 첫 번째 제출을 만들고, 연령별 등급 설문지를 포함하여 파트너 센터에서 인증을 위해 제출합니다. CLI를 사용하여 후속 업데이트를 게시하기 전에 앱이 Microsoft Store에 게시될 때까지 기다립니다.
설치
Microsoft Store 개발자 CLI는 Windows 10+, Linux 및 macOS를 지원합니다.
지금 바로 Microsoft Store 개발자 CLI(프리뷰)를 설치하세요!
시작하기
Microsoft Store 개발자 CLI를 설치한 후 명령을 실행할 수 있도록 환경을 구성해야 합니다. CLI를 처음으로 실행하기만 하면 됩니다. 해당 CLI가 구성 프로세스를 안내합니다.
msstore
중요합니다
로그인 시 MSA를 사용하지 마세요! Microsoft Store 개발자 CLI를 사용하려면 Microsoft Entra ID 자격 증명을 사용해야 합니다. 이에 대한 자세한 내용은 필수 조건 섹션에서 확인할 수 있습니다.
CI 환경에서의 실행도 지원되며, ci/CD 파이프라인에서 Microsoft Store 개발자 CLI(미리 보기)를 사용하여 Microsoft Store 애플리케이션에 업데이트를 자동으로 게시할 수 있습니다. 이를 위한 추가적인 지침은 여기에서 찾을 수 있습니다.
비고
Microsoft Store 개발자 CLI를 통한 앱 업데이트 작업은 현재 무료 제품에만 지원됩니다. 유료 제품은 향후 릴리스에서 지원될 예정입니다.
Commands
다음은 Microsoft Store 개발자 CLI 사용 가능한 명령입니다.
| Command | Description |
|---|---|
| 정보 | 기존 구성을 인쇄합니다. |
| 다시 구성 | Microsoft Store 개발자 CLI를 재구성합니다. |
| 설정 | Microsoft Store 개발자 CLI의 설정을 변경합니다. |
| 제출 | 제출 관련 명령(예: 'status', 'get', 'getListingAssets', 'updateMetadata', 'update', 'poll', 'publish') |
자세한 내용은 다음 명령을 참조하세요.
자주 묻는 질문
Microsoft Store 개발자 CLI란 무엇이며 어떻게 도움이 될 수 있나요?
Microsoft Store 개발자 CLI는 개발자가 다음과 같은 여러 파트너 센터 작업을 자동화할 수 있는 플랫폼 간 명령줄 도구입니다.
- 앱 정보 나열 및 검색
- 개발자 호스팅 설치 관리자 URL을 포함하여 패키지 메타데이터를 업데이트하는 중
- 스토어 메타데이터 업데이트
- 앱 업데이트 제출 및 게시
이 도구는 업데이트된 설치 관리자 URL을 자동으로 제출하고 파트너 센터를 통해 앱의 첫 번째 게시 후 앱 업데이트를 게시할 수 있는 CI/CD 파이프라인에 특히 유용합니다. 인증은 파트너 센터 계정에 연결된 Entra ID 자격 증명을 사용하여 수행됩니다.
웹 UI에 대한 유연한 대안을 제공하고 Windows, macOS 및 Linux에서 스크립팅 워크플로를 지원합니다. 이를 사용하려면 개발자가 먼저 적절한 권한으로 API 액세스를 구성해야 합니다. 이 도구를 사용하면 팀이 릴리스 작업을 크게 간소화하고 크기를 조정할 수 있습니다.
CLI를 사용하여 스토어 제출을 자동화할 수 있나요?
예, 파트너 센터를 통해 앱의 첫 번째 게시를 완료한 후 빌드 파이프라인에서 CLI를 사용하여 업데이트된 패키지 메타데이터를 제출하고 후속 앱 업데이트를 게시할 수 있습니다. MSI/EXE 설치 관리자를 별도로 빌드하고 호스트한 다음 CLI를 사용하여 해당 URL이 포함된 패키지 메타데이터를 제출합니다. 스토어는 해당 URL에서 설치 관리자를 가져옵니다. CLI는 이를 패키지하거나 업로드하지 않습니다. 첫 번째 게시를 완료하는 데 CLI를 사용할 수 없습니다.
Windows developer