Close
Angular React Web Components Blazor

Ignite UI CLI を使用した作業の開始

Ignite UI CLI はスタンドアロンのグローバル コマンドライン ツールで、Ignite UI コンポーネント用に事前設定された Angular、React、jQuery プロジェクトをスキャフォールドします。ガイド付きウィザードによる初回セットアップ、スクリプト ワークフロー用の非インタラクティブな new および add コマンド、開発サーバー、そして AI コーディング アシスタントをリアルタイムの Ignite UI ドキュメントに接続するための組み込み MCP サーバーを提供します。

Ignite UI CLI は Angular CLI の代替ではなく、並行して機能します。Ignite UI CLI で作成されたプロジェクトは標準の Angular ワークスペースであり、スキャフォールド後に ng コマンドと完全に互換性があります。

Ignite UI CLI のインストール

npm を使用してグローバルにインストールします:

npm install -g igniteui-cli 

または、yarn を使用する場合:

yarn global add igniteui-cli

インストールを確認します:

ig version

新しいプロジェクトの作成

Ignite UI CLI にはプロジェクト作成のために 2 つのモードがあります: ガイド付きインタラクティブ ウィザードと引数を指定した直接コマンドです。

ガイドを使用する

ガイド付きウィザードは新しいプロジェクトの出発点として推奨されています。プロジェクト タイプ、名前、テンプレート、テーマの選択をガイドし、プロジェクトを自動的にスキャフォールドしてコミットします。

ウィザードをアクティブにするには:

ig

または:

ig new

最初の Ignite UI CLI アプリを作成

ウィザード オプションのステップ バイ ステップ ガイドについては、Ignite UI CLI を使用したステップ バイ ステップ ガイドを参照してください。

直接プロジェクトを作成する

Angular プロジェクトを非インタラクティブに作成するには、フレームワークとして angular、プロジェクト タイプとして igx-ts を指定します。

ig new my-app --framework=angular --type=igx-ts --template=side-nav

プロジェクト作成時に AI アシスタントとエージェントの設定を指定することもできます。

ig new my-app --framework=angular --type=igx-ts --template=side-nav --assistants generic --agents claude copilot

AI 設定を完全にスキップするには:

ig new my-app --framework=angular --type=igx-ts --assistants none --agents none

ig new 実行時の順序:

  1. プロジェクト ファイルが生成されます
  2. AI 設定が新しいプロジェクト ディレクトリ内で実行されます (フラグが指定されていない場合はアシスタントとエージェントのプロンプトが表示されます)
  3. Git が初期化されます (--skip-git を指定しない場合)
  4. 依存関係がインストールされます (--skip-install を指定しない場合)

Ignite UI CLI v13.1.0 以降、igx-ts プロジェクト タイプはデフォルトでスタンドアロン コンポーネントを使用するプロジェクトを生成します。代わりにモジュールベースのブートストラップを使用するには、--type=igx-ts-legacy を設定してください。

新しいアプリケーションがプロジェクト名のディレクトリに作成されます (newAngularProject)。Ignite UI for Angular アプリケーションを作成するときに選択できるベース プロジェクト テンプレートは次のとおりです。

テンプレートの IDテンプレートの説明
emptyルーティングとホームページを備えたプロジェクト構造。このテンプレートでは認証は利用できません。
side-navサイド ナビゲーション ドロワーを備えたプロジェクト構造。認証のアドオンをサポートします (以下参照)。
side-nav-miniコンパクトなサイド ナビゲーション ドロワーを備えたプロジェクト構造。認証のアドオンをサポートします (以下参照)。

インタラクティブ ウィザードで side-nav または side-nav-mini を選択すると、認証を追加するかどうかを確認するプロンプトが表示されます。次のテンプレート ID が生成され、非インタラクティブな作成用に ig new に直接渡すこともできます。これらの ID はウィザードのテンプレート リストには表示されません。

テンプレートの IDテンプレートの説明
side-nav-auth認証モジュールで拡張されたサイド ナビゲーション プロジェクト。詳細は Angular 認証プロジェクト テンプレートをご覧ください。
side-nav-mini-auth認証モジュールで拡張されたサイド ナビゲーション ミニ プロジェクト。詳細は Angular 認証プロジェクト テンプレートをご覧ください。

プロジェクトを作成する際に以下の引数を指定できます。

name

name (alias: -n)

アプリケーションの名前。アプリケーションが同じ名前のディレクトリに作成されます。

framework (Ignite UI CLI only)

—framework (alias: -f) default value: “jquery”

プロジェクトの対象フレームワーク。サポートされるフレームワークは jQuery、Angular、および React です。

type (Ignite UI CLI only)

—type (alias: -t)

使用可能なプロジェクト タイプは、選択したフレームワークによって異なります。

theme

—theme (alias: -th)

プロジェクト テーマ (プロジェクトの種類によって異なります)。

skip-git

—skip-git (alias: —sg)

このオプションを使用すると、Git によるリポジトリの自動初期化はスキップされます。オプションを省略すると、グローバルな skipGit 構成プロパティが使用されます。

skip-install

—skip-install (alias: —si)

プロジェクト作成時の npm パッケージの初期インストールをスキップします。

template—template

特定のフレームワーク タイプに複数のプロジェクト テンプレートがある場合にプロジェクト テンプレートを指定します。現在、Ignite UI for Angular の igx-ts プロジェクト タイプで使用できます。

コンポーネント テンプレートの追加

利用可能な Ignite UI Angular テンプレートを追加するには、新しいコンポーネントのテンプレート ID と名前を指定します。

ig add [template] [name] コマンドを使用します。

ig add grid newGrid

すべての利用可能なテンプレートのリストを取得するには、プロジェクトディレクトリで ig list コマンドを実行することもできます。

テンプレートの追加は、Ignite UI CLI、Angular Schematics で作成されたプロジェクト、または ng add で Ignite UI for Angular が追加された Angular CLI プロジェクトでサポートされます。ガイド付きコンポーネント ウィザードについては、Ignite UI CLI を使用したステップ バイ ステップ ガイドを参照してください。

テンプレートを追加する際に以下の引数を指定できます。

module

—module (alias: -m)

note: module argument is applicable only in Angular projects.

新しいコンポーネントを登録するモジュールの、/src/app/ folder を基準とした module.ts ファイルのパス。 ig add combo newCombo —module=myModule/myModule.module.ts

skip-route

—skip-route (alias: -srk)

新しいコンポーネントのアプリ ナビゲーション ルートを自動生成しません。

アプリケーションの実行

start コマンドはアプリケーションがビルドされ、Web サーバーが起動してデフォルトのブラウザーで開きます。

ig start

AI アシスタント統合 (MCP)

Ignite UI CLI には、AI コーディング アシスタント (GitHub Copilot、Claude、Cursor など) を最新の Ignite UI コンポーネント ドキュメントおよび API リファレンスに接続する組み込みの MCP (Model Context Protocol) サーバーが含まれています。設定後、AI アシスタントはコンポーネント API を照会したり、セットアップ ガイドを取得したり、コンテキストを切り替えずに正確な Ignite UI for Angular コードを生成したりできます。

ig new でプロジェクトを作成した場合、スキャフォールディング時に MCP 設定と Agent Skills が生成されます。既存のプロジェクトで作業している場合は、プロジェクト ルートから ig ai-config を実行して MCP サーバー、スキル ファイル、手順ファイルを一括セットアップしてください。

ig ai-config

このコマンドは複数のコーディング アシスタントと AI エージェントをサポートしています。

ig ai-config --assistants generic vscode --agents claude copilot
フラグデフォルト
--assistantsgeneric, vscode, cursor, gemini, junie, noneインタラクティブ モードでは対話形式; 非インタラクティブ モードでは generic
--agentsgeneric, claude, copilot, cursor, codex, windsurf, gemini, junie, noneインタラクティブ モードでは対話形式; 非インタラクティブ モードでは generic + claude

フラグを指定せずに実行すると、ig ai-config はインタラクティブ モードに入り、スペース キーで切り替え ENTER で確認しながらコーディング アシスタントとエージェントを選択するプロンプトを表示します。このプロンプトは ig new 実行時のウィザードのステップと同じです。

  1. コーディング アシスタントの選択 - MCP サーバー設定の対象を 1 つ以上選択 (Generic、VS Code、Cursor、Gemini、Junie)、またはスキップするには None。
  2. AI エージェントの選択 - スキル ファイルと手順ファイルのエージェントを 1 つ以上選択 (Generic、Claude、Copilot、Cursor、Codex、Windsurf、Gemini、Junie)、またはスキップするには None。

インタラクティブ モードのデフォルトは、アシスタントは Generic、エージェントは Generic + Claude です。ウィザードのプロンプトの詳細については、Ignite UI CLI を使用したステップ バイ ステップ ガイド - AI コーディング アシスタントの設定を参照してください。

AI クライアントを手動で設定する場合、または VS Code 以外のクライアントを使用する場合は、以下のコマンドで MCP サーバーを直接起動してください。

ig mcp

クライアント設定 (VS Code、Claude Desktop、Cursor など) および利用可能なツールの詳細については、Ignite UI CLI MCP を参照してください。

Ignite UI CLI コマンド

使用可能な Ignite UI CLI コマンドとその使用方法 (フラグを渡すなど) の完全なリストは、Ignite UI CLI wiki にあります。

コマンドエイリアス説明
ig startアプリケーションをビルドしてウェブ サーバーを開始、次にアプリケーションをデフォルト ブラウザーで開きます。
ig buildアプリケーションをアプトプット ディレクトリへビルドします。
ig generategサポートされるフレームワークおよびプロジェクト タイプのための新しいカスタム テンプレートを生成します。
ig help-h使用可能なコマンドをリストして手順の簡単な説明を示します。
ig configIgnite UI CLI 構成設定の読み取り / 書き込み操作を実行します。
ig doc検索した用語についてインフラジスティックスのサポート情報を検索します。
ig listl指定したフレームワークとタイプのすべてのテンプレートをリストします。プロジェクト フォルダー内でコマンド実行時にプロジェクトのフレームワークとタイプのテンプレートをすべてリストします。
ig test現在のプロジェクトのテストを実行します。
ig version-vローカル (ローカルがない場合はグローバル) にインストールされた Ignite UI CLI バージョンを示します。
ig mcpIgnite UI MCP サーバーを起動し、接続された AI アシスタントにコンポーネント ドキュメント検索および API リファレンス ツールを提供します。Ignite UI CLI MCP を参照してください。
ig ai-config.claude/skills/ に Ignite UI for Angular Agent Skills をコピーし、.vscode/mcp.json に Ignite UI MCP サーバー設定を書き込むことで、既存のプロジェクトの AI 統合をセットアップします。