UIP ソリューション プロジェクト

uip solution project は、.uipxソリューション マニフェスト内にリストされているプロジェクト (ワークフロー、テスト ケース、ライブラリ、エージェント、Maestro フロー、アプリ) を管理します。次の 3 つのサブコマンドを使用できます。

サブコマンド	目的
add	ソリューション ディレクトリに既に存在するプロジェクト フォルダーを登録します。
import	外部プロジェクト フォルダーをソリューション ディレクトリにコピーして登録します。
remove	.uipxからプロジェクトの登録を解除します (ディスク上のファイルは削除されません)。

3 つのサブコマンドはすべて、ローカル ファイルのみで動作します。認証は不要です。

概要

uip solution project add <projectPath> [solutionFile]
uip solution project import --source <path> [--solutionFile <path>]
uip solution project remove <projectPath> [solutionFile]

各サブコマンドは 、グローバルオプション を尊重し、 標準の終了コードを返します。

一般的な動作

• 対象のプロジェクト フォルダーに、 project.uiproj またはレガシの project.json 記述子が含まれている必要があります。このコマンドは、どれを自動検出します。
• <solutionFile>省略すると、コマンドはプロジェクトパス(または現在のディレクトリでimport)から上に最も近い.uipxを検索します。1 つも見つからない場合、または複数の .uipx ファイルが同じフォルダーに存在する場合、コマンドは内容を示すエラーで失敗し、 1で終了します。
• マニフェストに追加されたプロジェクトエントリごとに一意の Id (UUID)が生成されます。

---

UIP ソリューション プロジェクト追加

ソリューション ディレクトリ に既に存在する プロジェクト フォルダーを登録します。プロジェクト フォルダーの相対パスが .uipxに記録され、一致するエントリがソリューションの内部リソース ビルダーにプロビジョニングされます。

引数

• <projectPath> (必須) — プロジェクト フォルダーのパスです。project.uiproj または project.jsonを含む必要があります。
• [solutionFile] (任意) — .uipx ソリューションのマニフェストへのパスです。省略した場合、最も近い .uipx は <projectPath>から歩いて位置します。

オプション

グローバルオプション以外はありません。

例

最小限

uip solution project add ./my-solution/my-project ./my-solution/my-solution.uipx

自動検出 .uipx

uip solution project add ./my-solution/my-project

スクリプティング — 追加して 1 つのパイプラインに詰め込む

uip solution project add ./my-solution/my-project
uip solution pack ./my-solution ./dist --version 1.0.0

データシェイプ(--output json)

{
  "Code": "ProjectAdd",
  "Data": {
    "Status": "Added successfully",
    "Project": "my-project/project.uiproj",
    "Solution": "/workspace/my-solution/my-solution.uipx"
  }
}

故障モード

• プロジェクトがソリューション フォルダーの外部にあるこのコマンドは、外部プロジェクトをコピーする project importへのポインタを使用して追加を拒否します。
• プロジェクトは既に登録されています。1と既存のProjectRelativePathに名前を付けるメッセージで終了します。

---

UIP ソリューション プロジェクトのインポート

外部プロジェクト フォルダーをソリューション ディレクトリにコピーし (フォルダー名は保持)、.uipxに登録します。含めるプロジェクトがまだソリューションのルート下にない場合に使用します。

オプション

• --source <path> (必須) — インポートする外部プロジェクト フォルダーのパスです。project.uiproj または project.jsonを含むディレクトリである必要があります。
• --solutionFile <path> (任意) — .uipx ソリューションのマニフェストへのパスです。デフォルトでは、現在の作業ディレクトリから上に移動して見つけた最も近い .uipx になります。

例

共通

uip solution project import \
  --source ./external-project \
  --solutionFile ./my-solution/my-solution.uipx

ソリューション ディレクトリ内から (自動検出 .uipx)

cd ./my-solution
uip solution project import --source ../shared-library

データシェイプ(--output json)

{
  "Code": "ProjectImport",
  "Data": {
    "Status": "Imported successfully",
    "Project": "external-project/project.uiproj",
    "Solution": "/workspace/my-solution/my-solution.uipx"
  }
}

失敗モードとロールバック

• 保存先フォルダーは既に存在します。このコマンドは上書きを拒否します。移動元のフォルダーの名前を変更するか、先に既存の保存先を削除します。
• プロジェクトが既に .uipx マニフェストに含まれています。ファイルがコピーされるまで拒否されます。
• コピー、書き込み、またはビルダーのステップが失敗します。コマンドがロールバックされ、コピーされたディレクトリが削除され、 .uipx が元の内容に復元されます。

---

UIP ソリューション プロジェクトの削除

.uipx ソリューション マニフェストからプロジェクトの登録を解除し、内部リソース ビルダーからそのエントリを削除します。ディスク上のファイルは削除されません。

引数

• <projectPath> (必須) — 削除するプロジェクト フォルダーのパスです。現在 .uipxに登録されている必要があります。
• [solutionFile] (任意) — .uipx ソリューションのマニフェストへのパスです。既定値は、<projectPath>から歩いて上って見つけた最も近い.uipxです。

例

最小限

uip solution project remove ./my-solution/my-project ./my-solution/my-solution.uipx

スクリプティング — 複数のプロジェクトを削除する

for p in project-a project-b project-c; do
  uip solution project remove "./my-solution/$p" || true
done

データシェイプ(--output json)

{
  "Code": "ProjectRemove",
  "Data": {
    "Status": "Removed successfully",
    "Project": "my-project",
    "Solution": "/workspace/my-solution/my-solution.uipx"
  }
}

故障モード

• プロジェクトがソリューション フォルダーの外部にある相対パスの先頭に ..を含めることはできません。
• プロジェクトがマニフェストにありません。1と検索に使用する相対パスで終了します。

---

関連コマンド

• uip solution new — プロジェクトを追加する前にソリューションを素早く作成します。
• uip solution resource refresh — プロジェクトのバインドを編集した後、リソースを再同期します。
• uip solution pack — プロジェクト リストが完成したら、ソリューションをパッケージ化します。

参照

• 最初のパイプライン — エンドツーエンドの例。
• uip solutionの概要。