# 事前準備

Aspire を始める準備はできていますか？開始する前に、開発環境にいくつかの必須ツールが整っていることを確認してください。このガイドでは、Aspire ソリューションを自信を持って構築・実行するために必要なすべてのセットアップについて説明します。

1. #### 言語ランタイムをインストール

    Aspire の C# AppHost は .NET を基盤としています。.NET は、モダンなアプリケーションとクラウド サービスを構築するための、無料でオープンソースのクロスプラットフォーム フレームワークです。[.NET 10.0 SDK](https://dotnet.microsoft.com/download/dotnet/10.0) をインストールする必要があります。C# の事前知識は必須ではありません。
**重要:** C# AppHost には .NET 10.0 SDK が必要です。ただし、Aspire は .NET 8.0 以降をターゲットとするアプリケーションを実行できます。

    お使いのオペレーティング システム (Windows、macOS、Linux) に応じた [インストール手順](https://dotnet.microsoft.com/download/dotnet/10.0) に従ってセットアップを完了します。

    Aspire の TypeScript AppHost には [Node.js](https://nodejs.org/) 20 以降 (LTS 推奨) と互換性のあるパッケージ マネージャーが必要です。次のパッケージ マネージャーがサポートされています: **npm** (Node.js に含まれています)、**pnpm**、**Yarn**、**Bun**。Aspire CLI は `package.json` の `packageManager` フィールドまたはプロジェクト ディレクトリと親ディレクトリのロックファイルからアクティブなツールチェーンを自動検出します。

    お使いのオペレーティング システム (Windows、macOS、Linux) に応じた [Node.js のインストール手順](https://nodejs.org/) に従ってセットアップを完了します。別のパッケージ マネージャーを使う場合は、個別にインストールしてください:

    - [pnpm](https://pnpm.io/installation)
    - [Yarn](https://yarnpkg.com/getting-started/install)
    - [Bun](https://bun.sh/docs/installation)

1. #### OCI 準拠のコンテナー ランタイムをインストール

    <ContainerRuntimeChoices
      ariaLabel="コンテナー ランタイムの選択肢"
      intro="ローカル コンテナー サポート用に 1 つのランタイムを選択します。ほとんどの Aspire 開発者には Docker Desktop が推奨されるデフォルトです。"
      choices={[
        {
          id: 'docker',
          title: 'Docker Desktop',
          href: 'https://www.docker.com/products/docker-desktop',
          linkLabel: 'Docker Desktop をインストール',
          statusLabel: '推奨されるデフォルト',
          description:
            'コンテナーを構築・実行するための、馴染みがあり広くサポートされた環境です。',
        },
        {
          id: 'podman',
          title: 'Podman',
          href: 'https://podman.io/',
          linkLabel: 'Podman をインストール',
          statusLabel: 'サポートされている代替案',
          description:
            'Open Container Initiative (OCI) コンテナーを構築・実行するためのオープンソースでデーモンレスのランタイムです。',
        },
        {
          id: 'rancher',
          title: 'Rancher Desktop',
          href: 'https://rancherdesktop.io/',
          linkLabel: 'Rancher Desktop について詳しく',
          statusLabel: 'コミュニティ報告済み',
          description:
            'ユーザーから、特に Docker CLI を使用するよう設定した場合に成功したという報告を受けています。ただし、Rancher Desktop は正式にサポートされている Aspire シナリオではなく、定期的にテストされていません。',
        },
      ]}
      podmanSetup={{
        heading: 'Aspire で Podman を使用',
        body: 'Podman をインストール後、ASPIRE_CONTAINER_RUNTIME を podman に設定します。',
        bashTitle: 'Podman ランタイムを設定',
        powershellTitle: 'Podman ランタイムを設定',
      }}
    />

    :::tip[1 つのランタイムを選択]{icon='approve-check-circle'}
    上のタブから 1 つのオプションだけをインストールしてください。ほとんどのユーザーは **Docker Desktop** を選択します。Podman または Rancher Desktop を使いたいという理由がある場合を除き、それらをインストールしないでください。
    :::

1. #### 統合開発環境 (IDE) をインストール

    Aspire は複数の IDE とコード エディターをサポートしています。ワークフローに最適なものを選択できます:

    :::note[Visual Studio Code]{icon="vscode"}
    最適な利用体験のため、[Visual Studio Code](https://code.visualstudio.com/) をお勧めします。軽量でクロスプラットフォーム対応のコード エディターで、Aspire のサポートが優れています。使い始めるには、次の拡張機能をインストールしてください:

    [Aspire 拡張機能](/ja/get-started/aspire-vscode-extension/) - Aspire 固有のコマンドと機能用です。
    :::

    さらに、C# 言語サポートのため [C# 拡張機能](https://marketplace.visualstudio.com/items?itemName=ms-dotnettools.csharp) をインストールしてください。

    Aspire は次の IDE でもよく動作します:

    - [Visual Studio](https://visualstudio.microsoft.com/vs/): C# 開発用のフル機能 IDE で、デバッグ、IntelliSense、Git サポートを備えています。
    - [JetBrains Rider](https://plugins.jetbrains.com/plugin/23289--net-aspire): コード分析、リファクタリング、デバッグなどの高度な機能を備えた、クロスプラットフォーム対応の強力な C# IDE です。

    Aspire 拡張機能をインストールした Visual Studio Code が、TypeScript AppHost の推奨環境です。

    #### ローカル インストールの代替案を検討する (オプション)

ローカル マシンに前提条件をインストールしない場合は、[GitHub Codespaces](/ja/get-started/github-codespaces/) や [Dev Containers](/ja/get-started/dev-containers/) などのクラウドベースのオプションを使用して Aspire ソリューションを開発できます。これらのオプションを使用すると、クラウド環境で作業でき、ローカル インストールが不要になりますが、ローカル インストールと同じパフォーマンスは提供されない場合があります。

Aspire チームは、すぐに開始できるように、事前設定されている Dev Container を備えた GitHub Codespaces 設定を保守しています:

<CodespacesButton owner='microsoft' repo='aspire-devcontainer' />