25.10.16

公開日: 2026 年 5 月 18 日

更新内容

ライブラリのパッケージ化時にアクティビティのルート カテゴリを上書きする

ライブラリ プロジェクトをパッケージ化すると、結果のパッケージによって公開されるすべてのアクティビティにルート カテゴリのプレフィックスが付けられます。既定では、このプレフィックスはライブラリ プロジェクト名です。新しい --activitiesRootCategory パラメーターを使用すると、プロジェクトの名前を変更せずに上書きできます。

uipcli package pack "C:\projects\MyLibrary\project.json" -o "C:\Output" --activitiesRootCategory "MyCompany.Finance.Invoicing"

生成された .nupkg 内のアクティビティは、ライブラリをインストールするプロジェクトの Studio の [アクティビティ] パネルの [ MyCompany.Finance.Invoicing ] に表示されます。

このパラメーターは、 ライブラリ プロジェクトをパッケージ化する場合にのみ有効です。Process、Tests、および Objects の出力の種類では無視されます。省略した場合、動作は変更されず、ルート カテゴリは Studio の [ ライブラリ パブリッシュ ] ダイアログで生成されるライブラリ プロジェクト名と一致します。

パック中のアナライザーと検証のスキップ

ワークフロー アナライザーとプロジェクトの検証は、 package packの一部として自動的に実行されます。2 つの新しいフラグにより、どちらの手順もオプトアウトできます。

• --skipAnalyze — パッケージの手順でワークフロー アナライザーを実行しません。
• --skipValidate — pack ステップのプロジェクト検証ステップをスキップします。

uipcli package pack "C:\projects\MyProject\project.json" -o "C:\Output" --skipAnalyze --skipValidate

これらのフラグは、次の場合に使用します。

• パイプラインが以前のステージ (結合前のチェックなど) でプロジェクトの package analyze または検証済みであり、 packで同じコストを再度支払いたくない。
• ローカル デバッグ用のクイック パッケージを作成しており、成果物のみが必要な場合。

リリース パイプラインでは、両方の手順を有効にしておくことをお勧めします。

依存関係の解決 --nugetConfigFilePath

新しい --excludeConfiguredSources フラグでは、UiPath の組み込みフィードと、CLI を実行するホスト上のユーザー レベルおよびマシン レベルの NuGet の構成 (通常は UiPath %AppData%\NuGet\NuGet.Config と %ProgramFiles(x86)%\NuGet\Config) は除外されます。CLI は、--nugetConfigFilePathに渡す nuget.config ファイルで定義されているフィードからのみパッケージを解決します。

uipcli package pack "C:\projects\MyProject\project.json" -o "C:\Output" \
  --nugetConfigFilePath "C:\ci\nuget.config" \
  --excludeConfiguredSources

このフラグは、次の場合に使用します。

• バージョン管理で宣言したフィードのみが参照される、密閉された再現可能なビルドが必要です。
• 共有ビルドエージェントには、特定のパイプラインに出血させたくないマシンレベルのフィードがあります。
• ホスト レベルの NuGet 構成の相違が原因で発生する、"エージェント A で動作し、エージェント B で失敗する" 問題をデバッグしています。

構成ファイルを使用して uipcli を実行する場合は、 "excludeConfiguredSources": trueを設定します。

このフラグを設定すると他のソースが参照されないため、プロジェクトが必要とするすべてのフィード (同等の UiPath フィードも含む) を nuget.config で宣言してください。

アナライザーを多用するプロジェクトでの Linux および macOS のパフォーマンスの向上

以前は、Linux または macOS でワークフロー アナライザーの警告が大量に生成されるプロジェクトをパッケージ化する場合、実際のコンパイルが完了した後に CLI でアナライザーのメッセージがドレインされるまでに数分かかっていました。CLI と SolutionPackager の間の内部通信チャネルは、名前付きパイプ/Unix ドメインソケットトランスポートに切り替えられ、そのボトルネックが取り除かれました。

ユーザーアクションは必要ありません—LinuxでVerbose Analyzerの出力に15 +分かかっていたパックは、コンパイルが完了してから数秒で完了します。Windows の動作に変更はありません。

復元の高速化 — 1 回の実行で NuGet のダウンロードが重複するなくなりました

1 つの CLI 呼び出しで複数の復元手順 (たとえば、検証とパックを行う pack や、各プロジェクトを復元する solution pack など) がトリガーされた場合、ステップ間で HTTP キャッシュ ウィンドウが既に期限切れになっているため、同じ NuGet パッケージが複数回ダウンロードされる可能性があります。CLI では、ダウンロード済みのパッケージが 1 回の実行内で 15 分間キャッシュされるようになったため、後続の復元手順では、フィードから再取得するのではなく、ローカル コピーが再利用されます。

ユーザーによる操作は不要です — 多くの依存関係を持つプロジェクトでは、NuGet の復元を実行するコマンドが大幅に高速化されます。

起動時に出力されるバージョンとランタイム

すべてのCLI呼び出しで、出力の最初の行としてバナーが出力されるようになりました。

uipcli: version 25.10.16, running on .NET 8.0.x

これにより、サポートログは自己記述的になり、どのCLIビルドまたはどのランタイムが特定のログファイルを生成したかについてあいまいさはありません。

ドキュメントの更新

• プロジェクトをパッケージ化する
• オートメーションの依存関係を復元する
• プロジェクトを分析する
• パッケージをテストするか、テスト セットを実行する
• NuGet フィードを管理する