メインコンテンツまでスキップ

ツールのインストール

本章では、前提条件として挙げたツールを OS 別にインストールします。 各ツールごとに作業完了確認のステップを用意していますので、必ずバージョン確認コマンドで成功を確認してから次に進んでください。

Windows​

Bun​

インストール手順:

  1. PowerShell を開きます（ターミナルの開き方 参照）。

  2. 次のコマンドを実行します（公式サイトの Windows 向けインストーラ）。

    powershell -c "irm bun.sh/install.ps1|iex"

  3. インストール後、ターミナルを一度閉じて開き直します（PATH を反映させるため）。

詳細・最新情報は公式サイト https://bun.com/docs/installation#windows を参照してください。

PowerShell の実行ポリシーで止まるとき

このシステムではスクリプトの実行が無効になっているため… のようなエラーが出た場合は、次のコマンドで現在のユーザにのみ実行を許可してから再実行してください。

Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned

作業完了確認:

bun --version

期待される出力（例）:

1.3.14

表示されたバージョンが 1.3.14 以上 であることを確認してください。

Java (JDK)​

選定方針: iAP でサポートされる JDK を選びます。intra-mart Accel Series ドキュメントアーカイブ で対象とする iAP バージョンのリリースノートを必ず確認してください。利用可能な JDK は、リリースノートに記載されている JDK 8 または JDK 11 を前提とします。

インストール手順（Oracle JDK の例）:

  1. 次のいずれかのダウンロードページにアクセスします。
  2. Windows x64 Installer をダウンロードします。
  3. ダウンロードしたインストーラを実行し、ウィザードに従ってインストールします。
  4. インストール先のフォルダを控えておきます（例: C:\Program Files\Java\jdk-11.x.x）。

環境変数の設定:

Windows では、JAVA_HOME と PATH の設定が必要です。

  1. 次の手順で「環境変数」画面を起動します。
    • スタートメニューで「環境変数」と入力 → 「システム環境変数の編集」を選択 → 「環境変数」ボタンをクリック
  2. 「システム環境変数」に JAVA_HOME を新規追加し、値にインストール先フォルダを指定します。
  3. 同じ「システム環境変数」の Path を編集し、末尾に %JAVA_HOME%\bin を追加します。
  4. OK で閉じた後、ターミナルを一度閉じて開き直します。
複数の Java が存在する場合

過去にインストールした別バージョンの Java が残っていると、java -version で意図しないバージョンが表示されることがあります。その場合は JAVA_HOME を目的のバージョンに設定し直し、Path 上の既存の Java 参照（C:\Program Files\Common Files\Oracle\Java\javapath 等）を一時的に外してください。

作業完了確認:

java -version

期待される出力（例）:

java version "11.0.29" 2025-10-21 LTS
Java(TM) SE Runtime Environment ...
Java HotSpot(TM) 64-Bit Server VM ...

表示されたバージョンが 1.8.x または 11.x であることを確認してください。

Maven​

インストール手順:

  1. 公式サイト https://maven.apache.org/download.cgi から Binary zip archive（例: apache-maven-3.9.14-bin.zip）をダウンロードします。
  2. 任意のフォルダ（例: C:\tools\apache-maven-3.9.14）に解凍します。
  3. 環境変数を設定します（Java (JDK) と同じ画面で行います）。
    • MAVEN_HOME を新規追加し、値に解凍したフォルダを指定します。
    • Path の末尾に %MAVEN_HOME%\bin を追加します。
  4. ターミナルを一度閉じて開き直します。

詳細は公式サイト https://maven.apache.org/install.html を参照してください。

作業完了確認:

mvn --version

期待される出力（例）:

Apache Maven 3.9.14 (...)
Maven home: C:\tools\apache-maven-3.9.14
Java version: 11.0.29, vendor: ...

表示されたバージョンが 3.9.14 以上 であることを確認してください。

Visual Studio Code​

インストール手順:

  1. 公式サイト https://code.visualstudio.com/ から Windows 版インストーラをダウンロードします。
  2. インストーラを実行します。途中の「追加タスクの選択」で、次のオプションにチェックを入れることを推奨します。
    • 「PATH への追加」（code コマンドを使えるようにする）
    • 「エクスプローラーのコンテキストメニューに [Code で開く] アクションを追加する」（フォルダ右クリックから開けるようにする）
  3. インストール完了後、ターミナルを一度閉じて開き直します。

詳細は公式サイト https://code.visualstudio.com/docs/setup/windows を参照してください。

作業完了確認:

code --version

期待される出力（例）:

1.127.0
xxxxxxxxxxxxxxx
x64

表示されたバージョンが 1.127.0 以上 であることを確認してください。

Git​

Git によるバージョン管理を行わない場合

Git によるバージョン管理を行わない場合は、Git のインストールは不要です。 GitHub 等のリモートで管理する場合は、別途対応サービスのアカウントをご用意ください。

インストール手順:

  1. 公式サイト https://git-scm.com/download/win から Windows 版インストーラをダウンロードします。

  2. インストーラを実行し、基本的にはデフォルト設定で進めて問題ありません。

  3. インストール後、ターミナルを一度閉じて開き直します。

  4. 初回セットアップとして、ユーザ名・メールアドレスを設定します（コミット時の署名情報になります）。

    git config --global user.name "Your Name"
    git config --global user.email "you@example.com"

詳細は公式サイト https://git-scm.com/book/en/v2/Getting-Started-Installing-Git を参照してください。

作業完了確認:

git --version

期待される出力（例）:

git version 2.53.0.windows.3

表示されたバージョンが 2.53.0 以上 であることを確認してください。

環境変数の設定​

OS 別の手順で設定した環境変数について、要点を整理します。 Java SE Development Kit および Apache Maven を、環境変数に登録してください。

  • JAVA_HOME: Java SE Development Kit をインストールしたフォルダ
  • MAVEN_HOME: Apache Maven をインストールしたフォルダ

また、環境変数 PATH に、それぞれの bin フォルダを追加してください。

  • Linux / macOS の場合
    • PATH=$JAVA_HOME/bin:$MAVEN_HOME/bin:$PATH
  • Windows の場合
    • PATH=%JAVA_HOME%\bin;%MAVEN_HOME%\bin;%PATH%
Maven の設定ファイルは自動生成されます

Maven の設定ファイル(settings.xml)および intra-mart の Maven リポジトリの参照設定は、Accel CLI でプロジェクトを作成する際にプロジェクト配下へ自動的に生成されます。そのため、ユーザのホームディレクトリ配下(~/.m2/settings.xml 等)へ手動で設定を行う必要はありません。

セットアップ手順で問題が発生したときは

トラブルシューティング を参照してください。