Aspire CLI をインストール

Aspire には、Aspire ベースのアプリの作成と管理を支援するコマンドライン インターフェイス (CLI) ツールが用意されています。CLI は、インタラクティブファーストな体験で開発ワークフローを効率化します。このガイドでは、システムに Aspire CLI をインストールする方法を説明します。最速のセットアップにはインストール スクリプトを使用するか、環境に合ったパッケージ マネージャー (npm、NuGet、WinGet、Homebrew) を選択してください。

Aspire CLI をインストールする前に、必要な 前提条件 が整っていることを確認してください。

Aspire CLI をインストール

Aspire CLI をインストールするには、1 つのコマンドでインストール スクリプトをダウンロードして実行します:

Bash

インストール スクリプト (macOS/Linux)

curl -sSL https://aspire.dev/install.sh | bash

PowerShell

インストール スクリプト (Windows)

irm https://aspire.dev/install.ps1 | iex

このスクリプトは Aspire CLI の最新の安定版リリースをインストールします。インストール中に Do you want to continue? と表示されることがあります。インストール スクリプトのダウンロードと実行を続けるには、Yes の Y または Yes to All の A で応答してください。インストールを確認するには 検証 を参照してください。

ヒント

上部ナビゲーション (ダウンロード アイコン ) から Install Aspire CLI コマンド モーダルをいつでも再度開けます。モーダルには OS 向けのダウンロード兼インストール コマンドが表示されるため、必要に応じてインストーラーを再実行できます。

スクリプトを確認したい場合や、インストーラーをコマンドを分けて実行したい場合にのみ、スクリプトを個別にダウンロードする必要があります。詳細は aspire-install スクリプト リファレンス を参照してください。

パッケージ マネージャーでインストール

インストール スクリプトは、サポートされているすべてのプラットフォームで動作します。Aspire CLI を他の開発ツールと一緒に管理したい場合は、代わりにパッケージ マネージャーでインストールできます。環境に合ったオプションを選択してください:

Homebrew

macOS (Apple シリコンと Intel) では、Homebrew で Aspire CLI をインストールします。

Homebrew でインストール

brew install --cask microsoft/aspire/aspire

npm

開発ツールを npm で管理している場合は、npm から Aspire CLI をインストールします。このオプションには Node.js が必要です。

npm でインストール

npm install -g @microsoft/aspire-cli

同じコマンドが Windows、macOS、Linux (Alpine などの musl ベースのディストリビューションを含む) で動作します。npm はお使いのオペレーティング システムとアーキテクチャに適したネイティブ バイナリを自動的に選択します。

ノート

npm からインストールすると、Aspire CLI はセルフ更新を npm 経由でルーティングします。aspire update --self を実行すると、バイナリを直接ダウンロードする代わりに、実行すべき npm install -g @microsoft/aspire-cli@latest コマンドが表示されます。詳細は aspire update を参照してください。

NuGet

開発ツールを .NET SDK で管理している場合は、Aspire CLI を .NET グローバル ツールとしてインストールします。このオプションには .NET SDK が必要です。

.NET CLI でインストール

dotnet tool install -g Aspire.Cli

CLI は Aspire.Cli グローバル ツールとして NuGet.org に公開されており、Windows、macOS、Linux で動作します。

WinGet

Windows (x64 と Arm64) では、Windows パッケージ マネージャー (WinGet) で Aspire CLI をインストールします。

WinGet でインストール

winget install Microsoft.Aspire

検証

Aspire CLI がインストールされていることを検証するには、aspire --version を使用して Aspire CLI からバージョン番号を取得します:

インストール バージョンの確認

aspire --version

そのコマンドが動作すると、Aspire CLI ツールのバージョンが表示されます:

Aspire CLI — Output

13.3.0+{commitSHA}

+{commitSHA} サフィックスは、Aspire CLI がビルドされた特定のコミットを示します。

Aspire CLI リファレンス を読むと、さらに詳しく学べます。 ドキュメントを参照してください。

トラブルシューティング

バージョン番号が表示されない場合は、端末の セッションを再起動して PATH 環境変数の変更を反映する必要がある 可能性があります。端末を閉じて再度開き、aspire --version コマンドをもう一度実行してください。

関連情報

• aspire-install スクリプト リファレンス
• aspire コマンド リファレンス
• Aspire VS Code 拡張機能 - CLI をインストールして、VS Code 内から Aspire コマンドを使用する