Angular Tooling

Angular v20+ 開発を効率化するために Angular CLI と開発ツールを使用します。

プロジェクトセットアップ

新規プロジェクトの作成

# 新しいスタンドアロンプロジェクトを作成（v20+ のデフォルト）
ng new my-app

# 特定のオプション付き
ng new my-app --style=scss --routing --ssr=false

# テストをスキップ
ng new my-app --skip-tests

# 最小限のセットアップ
ng new my-app --minimal --inline-style --inline-template

プロジェクト構造

my-app/
├── src/
│   ├── app/
│   │   ├── app.component.ts
│   │   ├── app.config.ts
│   │   └── app.routes.ts
│   ├── index.html
│   ├── main.ts
│   └── styles.scss
├── public/                  # Static assets
├── angular.json             # CLI configuration
├── package.json
├── tsconfig.json
└── tsconfig.app.json

コード生成

コンポーネント

# コンポーネントを生成
ng generate component features/user-profile
ng g c features/user-profile  # 短縮形

# オプション付き
ng g c shared/button --inline-template --inline-style
ng g c features/dashboard --skip-tests
ng g c features/settings --change-detection=OnPush

# フラット（フォルダなし）
ng g c shared/icon --flat

# ドライラン（プレビュー）
ng g c features/checkout --dry-run

サービス

# サービスを生成（デフォルトで providedIn: 'root'）
ng g service services/auth
ng g s services/user

# テストをスキップ
ng g s services/api --skip-tests

その他のスキーマティクス

# ディレクティブ
ng g directive directives/highlight
ng g d directives/tooltip

# パイプ
ng g pipe pipes/truncate
ng g p pipes/date-format

# ガード（デフォルトで関数型）
ng g guard guards/auth

# インターセプター（デフォルトで関数型）
ng g interceptor interceptors/auth

# インターフェース
ng g interface models/user

# 列挙型
ng g enum models/status

# クラス
ng g class models/product

パスエイリアスで生成

# フィーチャーフォルダのコンポーネント
ng g c @features/products/product-list
ng g c @shared/ui/button

開発サーバー

# 開発サーバーを起動
ng serve
ng s  # 短縮形

# オプション付き
ng serve --port 4201
ng serve --open  # ブラウザを開く
ng serve --host 0.0.0.0  # ネットワークに公開

# 本番環境モード（ローカル）
ng serve --configuration=production

# SSL 付き
ng serve --ssl --ssl-key ./ssl/key.pem --ssl-cert ./ssl/cert.pem

ビルド

開発ビルド

ng build

本番ビルド

ng build --configuration=production
ng build -c production  # 短縮形

# 特定のオプション付き
ng build -c production --source-map=false
ng build -c production --named-chunks

ビルド出力

dist/my-app/
├── browser/
│   ├── index.html
│   ├── main-[hash].js
│   ├── polyfills-[hash].js
│   └── styles-[hash].css
└── server/              # SSR が有効な場合
    └── main.js

テスト

ユニットテスト

# テストを実行
ng test
ng t  # 短縮形

# 単一実行（CI）
ng test --watch=false --browsers=ChromeHeadless

# カバレッジ付き
ng test --code-coverage

# 特定のファイル
ng test --include=**/user.service.spec.ts

E2E テスト

# e2e を実行（設定されている場合）
ng e2e

リンティング

# リンターを実行
ng lint

# 自動修正可能な問題を修正
ng lint --fix

設定

angular.json の主要セクション

{
  "projects": {
    "my-app": {
      "architect": {
        "build": {
          "builder": "@angular-devkit/build-angular:application",
          "options": {
            "outputPath": "dist/my-app",
            "index": "src/index.html",
            "browser": "src/main.ts",
            "polyfills": ["zone.js"],
            "tsConfig": "tsconfig.app.json",
            "assets": ["{ \"glob\": \"**/*\", \"input\": \"public\" }"],
            "styles": ["src/styles.scss"],
            "scripts": []
          },
          "configurations": {
            "production": {
              "budgets": [
                {
                  "type": "initial",
                  "maximumWarning": "500kB",
                  "maximumError": "1MB"
                }
              ],
              "outputHashing": "all"
            },
            "development": {
              "optimization": false,
              "extractLicenses": false,
              "sourceMap": true
            }
          }
        }
      }
    }
  }
}

環境設定

// src/environments/environment.ts
export const environment = {
  production: false,
  apiUrl: 'http://localhost:3000/api',
};

// src/environments/environment.prod.ts
export const environment = {
  production: true,
  apiUrl: 'https://api.example.com',
};

angular.json で設定：

{
  "configurations": {
    "production": {
      "fileReplacements": [
        {
          "replace": "src/environments/environment.ts",
          "with": "src/environments/environment.prod.ts"
        }
      ]
    }
  }
}

ライブラリの追加

Angular ライブラリ

# Angular Material を追加
ng add @angular/material

# Angular PWA を追加
ng add @angular/pwa

# Angular SSR を追加
ng add @angular/ssr

# Angular Localize を追加
ng add @angular/localize

サードパーティライブラリ

# インストールして設定
npm install @ngrx/signals

# 一部のライブラリはスキーマティクスを持つ
ng add @ngrx/store

Angular の更新

# 更新をチェック
ng update

# Angular コアと CLI を更新
ng update @angular/core @angular/cli

# すべてのパッケージを更新
ng update --all

# 強制更新（ピア依存関係チェックをスキップ）
ng update @angular/core @angular/cli --force

パフォーマンス分析

# 統計情報付きでビルド
ng build -c production --stats-json

# バンドルを分析（esbuild-visualizer をインストール）
npx esbuild-visualizer --metadata dist/my-app/browser/stats.json --open

キャッシング

# 永続的なビルドキャッシュを有効化（v20+ ではデフォルト）
# angular.json で設定：
{
  "cli": {
    "cache": {
      "enabled": true,
      "path": ".angular/cache",
      "environment": "all"
    }
  }
}

# キャッシュをクリア
rm -rf .angular/cache

詳細な設定については、references/tooling-patterns.md を参照してください。