ビルドとテスト
Gemini CLIのビルド、テスト、デバッグの完全ガイド
ビルドプロセス
ビルドシステムと開発ワークフローの理解
npm run bootstrap
依存関係をインストールしてパッケージをリンクする
Usage:
初期セットアップと新しい依存関係追加後
npm run build
依存関係の順序ですべてのパッケージをビルドする
Usage:
テストまたはリリース前
npm run build:watch
ウォッチモードでパッケージをビルドする
Usage:
アクティブな開発中
npm run clean
ビルドアーティファクトとnode_modulesをクリーンアップする
Usage:
ビルド問題に遭遇した時
テストフレームワーク
JestとTypeScriptによる包括的なテスト
npm run test
すべてのパッケージのすべてのテストを実行する
Usage:
完全なテストスイートの実行
npm run test:watch
ウォッチモードでテストを実行する
Usage:
開発中
npm run test:coverage
テストカバレッジレポートを生成する
Usage:
品質保証とCI/CD
lerna run test --scope @gemini/core
特定のパッケージのテストを実行する
Usage:
集中的なテスト
開発ワークフロー
推奨される開発とテストのワークフロー
初期セットアップ
開発環境をセットアップし、依存関係をインストールする
git clone https://github.com/google-gemini/gemini-cli.git && cd gemini-cli && npm run bootstrap
開発モード
自動再ビルドのためのウォッチモードを開始する
npm run build:watch
テスト
開発中に継続的にテストを実行する
npm run test:watch
品質チェック
コミット前にコードチェック、フォーマット、型チェックを実行する
npm run lint && npm run type-check && npm run test:coverage
デバッグ
問題をデバッグするためのツールとテクニック
デバッグモード
詳細な出力のためにデバッグログを有効にする
DEBUG=gemini:* gemini ask "こんにちは"これによりすべてのGemini CLI操作の詳細なログが表示されます
VS Codeデバッグ
提供されたVS Code起動設定を使用する
.vscode/launch.jsonブレークポイントを設定してVS Codeで直接デバッグする
テストデバッグ
特定のテストをデバッグする
npm run test -- --testNamePattern="API Client"特定のテストケースを実行してデバッグする
パフォーマンスプロファイリング
パフォーマンス問題をプロファイルする
node --prof packages/cli/bin/gemini分析用のパフォーマンスプロファイルを生成する
継続的インテグレーション
自動化されたテストと品質保証
ビルド
TypeScriptをコンパイルしてすべてのパッケージをビルドする
テスト
ユニットテストを実行してカバレッジレポートを生成する
デプロイ
パッケージを公開してドキュメントをデプロイする
一般的な問題
一般的なビルドとテストの問題の解決策
ビルド失敗
変更をプルした後にビルドが失敗する場合は、クリーンアップして再インストールを試してください
npm run clean && npm run bootstrap && npm run buildテスト失敗
断続的なテスト失敗の場合は、タイムアウトを増やしてテストを実行してください
npm run test -- --testTimeout=10000メモリ問題
ビルド中にメモリ不足エラーが発生した場合
NODE_OPTIONS="--max-old-space-size=4096" npm run build次のステップ
これらのリソースで開発の旅を続けてください