Windows: WinGet으로 설치
Windows에서는 Windows 패키지 관리자인 WinGet으로 CLI를 설치합니다.xbox를 PATH에 추가하며, 관리자 권한이 필요하지 않습니다. 설치 후 터미널에서
xbox를 찾을 수 없으면 새 터미널을 열거나, IDE의 통합 터미널을 사용하는 경우 IDE를
다시 시작하세요.
CLI를 업데이트하려면 다음을 실행합니다.
%LOCALAPPDATA%\XboxDevCLI에 남아 있습니다. WinGet
설치는 이 페이지의 ZIP 단계가 아니라 WinGet으로만 업데이트하세요.
다음 단계로 계속 진행하세요.
Linux 및 macOS: 스크립트로 설치
Linux x64 또는 macOS에서 설치 스크립트는 최신 릴리스를~/.local/opt/xboxdevcli에 다운로드하고, 셸의 시작 파일에서 해당 디렉터리를 PATH에 추가합니다.
curl 및 unzip이 필요합니다.
xbox --version으로 버전을
확인하세요. CLI를 업데이트하려면 스크립트를 다시 실행합니다. 제거하려면
~/.local/opt/xboxdevcli와 스크립트가 해당 시작 파일에 추가한 줄을 삭제합니다.
릴리스 다운로드
WinGet이 없는 Windows PC처럼 WinGet과 설치 스크립트가 적합하지 않은 경우 릴리스 보관 파일에서 설치합니다. GitHub 릴리스 페이지에서 운영 체제와 CPU에 맞는 보관 파일을 다운로드합니다.
Linux x64 바이너리에는 glibc 2.27 이상이 필요합니다. macOS 바이너리는 Microsoft가 서명하고
Apple이 공증합니다. .NET을 설치할 필요가 없습니다.
플랫폼별 단계에 나와 있는 것처럼 전체 보관 파일을 새 전용 디렉터리에 추출하고, 해당 디렉터리를
PATH에
추가합니다. 디렉터리에 이미 설치가 있는 경우 대신
ZIP 설치 업데이트를 따르세요.
Windows(PowerShell)
-
보관 파일을 추출하고 추출된 실행 파일을 확인합니다.
-
디렉터리를
PATH에 추가합니다. Windows 검색에서 계정의 환경 변수 편집을 엽니다. 사용자 변수에서 Path를 편집하고, 새로 만들기를 선택한 다음,C:\Users\<you>\AppData\Local\Programs\XboxDevCLI와 같은 디렉터리를 입력합니다. -
새 터미널을 열고 버전을 확인합니다.
Linux 및 macOS(Bash 또는 Zsh)
-
보관 파일을 추출하고 추출된 실행 파일을 확인합니다. 이 예에서는 Linux x64를 사용합니다.
macOS에서는 Apple 실리콘의 경우
xbox-osx-arm64.zip을, Intel의 경우xbox-osx-x64.zip을 사용하세요. -
디렉터리를
PATH에 추가합니다. macOS의 기본 셸인 Zsh의 경우~/.zshrc에, Bash의 경우~/.bashrc에 다음 줄을 추가합니다. -
새 터미널을 열고 버전을 확인합니다.
설치 확인
xbox --version은 다운로드한 릴리스의 버전을 태그의 선행 v 없이 표시합니다.
이전 버전이 표시되면 PATH에서 다른 xbox 복사본이 먼저 발견되는 것입니다. PowerShell에서는
Get-Command xbox -All로, Bash 또는 Zsh에서는 type -a xbox로 해당 복사본을 찾아 PATH에서
제거하세요.
업데이트 확인
xbox upgrade는 최신 릴리스가 있는지와 설치 방법을 알려 줍니다.
Upgrade를 참조하세요.
winget upgrade Microsoft.Gaming.XBOXDeveloperCLI를 실행합니다. 스크립트
설치를 업데이트하려면 설치 스크립트를 다시
실행합니다. ZIP 설치를 업데이트하려면 다음 섹션을 따르세요.
ZIP 설치 업데이트
저장된 설정과 로그인 데이터는 설치와 별도로 저장되므로 그대로 유지됩니다. 값이 저장되는 위치를 참조하세요.xbox upgrade가 표시하는 릴리스 페이지나 GitHub 릴리스 페이지에서 새 릴리스의 보관 파일을 다운로드하고 새 디렉터리에 추출합니다.- 실행 중인
xbox프로세스를 모두 닫습니다. - 이전 설치 디렉터리를 같은 경로에서 새 디렉터리로 바꾸거나,
Windows(PowerShell) 또는
Linux 및 macOS(Bash 또는 Zsh)에서와 같이
PATH항목을 새 디렉터리로 변경합니다. - 새 터미널을 열고
xbox --version에 새 버전이 표시되는지 확인합니다.
PATH에서 제외한 상태로 보관하세요. 로그인이 만료된 경우
xbox auth login을 다시 실행하세요.
