Windows:使用 WinGet 安装
在 Windows 上,使用 Windows 程序包管理器 WinGet 安装 CLI:xbox 添加到你的 PATH,并且不需要管理员权限。如果安装后终端找不到
xbox,请打开新的终端;如果你使用 IDE 的集成终端,请重启 IDE。
若要更新 CLI:
%LOCALAPPDATA%\XboxDevCLI 中。只能使用 WinGet 更新 WinGet 安装,而不能使用本页中的 ZIP 步骤。请继续执行
后续步骤。
Linux 和 macOS:使用脚本安装
在 Linux x64 或 macOS 上,安装脚本会将最新版本下载到~/.local/opt/xboxdevcli,并在 shell 的启动文件中将该目录添加到你的 PATH。
它需要 curl 和 unzip:
xbox --version 检查版本。若要更新 CLI,请再次运行该脚本。若要删除它,请删除
~/.local/opt/xboxdevcli 以及脚本添加到该启动文件中的那一行。
下载版本
当 WinGet 和安装脚本都不适用时(例如在没有 WinGet 的 Windows 电脑上),请从发布存档安装。 从 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。对于 Zsh(macOS 上的默认 shell),请将此行添加到~/.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。
