aspire-install 脚本参考

本文包含 aspire 安装的 PowerShell 和 Bash 脚本的语法。 若要下载脚本，请参阅 “安装为本机可执行文件”。

Name

aspire-install.ps1 | aspire-install.sh - 用于安装 CLI 的 Aspire 脚本。

概要

窗户：

aspire-install.ps1 [-InstallPath <DIRECTORY>] [-Version <VERSION>] [-Quality <QUALITY>]
                   [-OS <OPERATING_SYSTEM>] [-Architecture <ARCHITECTURE>] [-KeepArchive] [-Help]"

Linux/macOS：

aspire-install.sh [--install-path <DIRECTORY>] [--version <VERSION>] [--quality <QUALITY>]
                  [--os <OPERATING_SYSTEM>] [--arch <ARCHITECTURE>] [--keep-archive] [--verbose] [--help]

Description

这些 aspire-install 脚本执行 CLI 的非 Aspire admin 安装。

脚本行为

这两个脚本的行为方式相同。 他们下载目标平台的 Aspire CLI，将其安装到指定位置，并将其添加到 PATH 环境变量。

默认情况下，安装脚本下载并安装 CLI 的最新稳定版本 Aspire 。 使用 -Version|--version 参数指定不同的版本，或使用参数指定不同的质量级别 -Quality|--quality 。

除非使用 -InstallPath|--install-path 参数更改，否则脚本将安装到用户特定的位置： %USERPROFILE%\.aspire\bin 在 Windows 或 $HOME/.aspire/bin /macOS 上 Linux。

选项

• -InstallPath|--install-path <DIRECTORY>

  指定安装路径。 如果该目录不存在，则会创建该目录。 默认值在 Windows 上 %USERPROFILE%.aspire\bin，在 /macOS 上Linux。 Aspire CLI 可执行文件直接放置在此目录中。

• -Version|--version <VERSION>

  表示要安装的特定版本。 例如： 9.4。 如果未指定，则安装最新的稳定版本。

• -Quality|--quality <QUALITY>

  下载指定的质量生成。 可能的值为：

  • release：最新的稳定版本（默认值）。
  • staging：从当前发布分支（预发布版本）生成。
  • dev：来自 main 分支的最新内部版本（开发版本）。

  不同的质量值指示发布过程的不同阶段：

  • release：CLI 的最终稳定版本 Aspire 。 适用于生产用途。
  • staging：预发行版，用于测试即将发布的版本。 不建议用于生产环境。
  • dev：主开发分支的最新内部版本。 它们经常生成，并且未经过完全测试。 不建议用于生产用途，但可用于在合并特定功能后立即测试特定功能或修补程序。

• -OS|--os <OPERATING_SYSTEM>

  指定要为其安装 CLI 的作系统。 可能的值包括：win、linux、linux-musl、osx。

  该参数是可选的，仅当需要重写脚本检测到的作系统时，才应使用该参数。

• -Architecture|--arch <ARCHITECTURE>

  Aspire要安装的 CLI 二进制文件的体系结构。 可能的值为 x64，x86arm64. 默认行为是自动检测当前系统体系结构。

• -KeepArchive|--keep-archive

  如果设置此选项，脚本将在安装后保留下载的存档文件和临时目录。 默认情况下，脚本在提取并清理临时目录后删除存档。

• --verbose

  显示诊断信息。 （Linux/macOS 仅）

• -Help|--help

  打印脚本的帮助信息。

例子

• 将最新的稳定版本安装到默认位置：

  窗户：

  .\aspire-install.ps1
  

  macOS/Linux：

  ./aspire-install.sh
  

• 安装到自定义目录：

  窗户：

  .\aspire-install.ps1 -InstallPath 'C:\Tools\Aspire'
  

  macOS/Linux：

  ./aspire-install.sh --install-path "/usr/local/bin"
  

• 安装特定版本：

  窗户：

  .\aspire-install.ps1 -Version '9.4'
  

  macOS/Linux：

  ./aspire-install.sh --version "9.4"
  

• 安装开发版本：

  窗户：

  .\aspire-install.ps1 -Quality 'dev'
  

  macOS/Linux：

  ./aspire-install.sh --quality "dev"
  

• 仅使用详细输出（Linux/macOS）进行安装：

  ./aspire-install.sh --verbose
  

卸载

没有卸载脚本。 删除安装目录，例如 %USERPROFILE%\.aspire\bin 在 Windows 或 $HOME/.aspire/bin /macOS 上 Linux。

另请参阅

• 安装 Aspire CLI