UiPath のインストール プラットフォーム

[UiPath のインストール プラットフォーム] タスクは、UiPath CLI の特定のバージョンをダウンロードして Jenkins エージェントのツール キャッシュにインストールします。このタスクは、スタンドアロンのオートメーション プロジェクト (プロセス、ライブラリ、テスト) とソリューションの両方に適用されます。

このタスクの対象コンテンツ

[UiPath のインストール プラットフォーム] タスクは、次の場合に使用します。

• パイプラインで使用するCLIバージョンを明示的に制御する場合。
• プロジェクトの種類に基づいて特定の CLI フレーバーをインストールする必要があります (以下の CLI フレーバー を参照)。
• ビルド エージェントが UiPath のパブリック フィードにインターネットにアクセスできません。
• エージェントにCLIをキャッシュして、後続のビルドを高速化します。

パイプライン内の他の UiPath タスクの前に [ UiPath のインストール プラットフォーム ] タスクを実行します。

注:

このタスクは任意です。指定しない場合、Jenkins はプラグインにバンドルされている CLI バージョンを自動的に使用します。ただし、このタスクを使用すると、明示的に制御でき、キャッシュによってビルドのパフォーマンスが向上します。

CLI フレーバー

UiPath CLI is distributed in platform-specific packages:

プラットフォーム	アーキテクチャ	CLI パッケージ	サポートされているプロジェクトの種類
Windows	x64	UiPath.CLI.Windows	クロスプラットフォーム、Windows (非レガシ)、ソリューション
Linux	x64	UiPath.CLI.Linux	クロスプラットフォーム、ソリューション
macOS	ARM64 (Apple Silicon)	UiPath.CLI.macOS	クロスプラットフォーム、ソリューション
Windows	x64	UiPath.CLI.Windows.Legacy	Windows - レガシ プロジェクトのみ

すべての CLI パッケージに .NET 8 ランタイムが必要です。

• Windows エージェント: .NET Desktop Runtime 8
• Linux エージェント: .NET ランタイム 8

混合プロジェクトの種類を処理する

リポジトリに複数のプロジェクトの種類 (Windows - レガシ プロジェクトとクロスプラットフォーム プロジェクトの両方) が含まれている場合は、複数の CLI フレーバーをインストールし、正しい CLI で各プロジェクトの種類を処理する必要があります。

推奨されるアプローチ:

1. UiPath.CLI.Windows をインストールして、すべてのクロスプラットフォーム プロジェクトと Windows (非レガシ) プロジェクトを処理します。
2. UiPath.CLI.Windows.Legacy をインストールし、すべての Windows - レガシ プロジェクトを個別に処理します。

同じ Jenkins パイプライン内でこれを実現するには、以下の方法を使用します。

• 異なる CLI バージョンで 複数の UiPath InstallPlatform ステップを使用する。
• ビルドステージを整理して、適切なCLIで各プロジェクトタイプを処理する。
• フォルダー構造または命名規則に基づく条件ロジックを使用してプロジェクトの種類を識別する

ヒント:

UiPath CLI でプロジェクトの種類を自動的に検出する方法はありません。リポジトリ内のどのプロジェクトが Windows - レガシであるかを把握し、それに応じてパイプラインを整理する必要があります。

UiPath CLI バージョン セレクター

[ CLI バージョンを選択 ] ドロップダウンから、使用する UiPath CLI のバージョンを選択します。

ドロップダウン リストには、次ののオプションが含まれています。

• UiPath CLI 25.10 以降の利用可能なバージョン。
• CLI フレーバー (Windows、Linux、または Windows.Legacy)。
• 各バージョンの .NET ランタイムの要件。

UiPath CLI の nupkg へのパス (オフライン シナリオ)

Jenkins エージェントが UiPath のパブリック フィードにアクセスできない場合は、CLI パッケージを手動で提供できます。

1. UiPath のパブリック フィードから目的の UiPath CLI のバージョンをダウンロードします。

2. ダウンロードした .nupkg ファイルを、エージェント ワークスペース ディレクトリ内のアクセス可能な場所に配置します。

   例: ${WORKSPACE}/nupkg/UiPath.CLI.Windows.25.10.3.nupkg ${env.ProgramFiles}\\CLIVersions\\UiPath.CLI.Windows.Legacy.25.10.9424.14050.nupkg

3. [UiPath のインストール プラットフォーム] タスクの設定で、CLI のバージョンを「CustomVersion」に設定し、[CLI nupkg へのパス] フィールドに.nupkg ファイルへのパスを指定します。

重要:

以下のように、カスタム バージョンの CLI パッケージ名がオフィシャル フィードのパッケージ名と正確に一致することを確認してください。

• UiPath.CLI.Windows.25.10.3.nupkg
• UiPath.CLI.Linux.25.10.3.nupkg

パイプラインの例

pipeline {
  agent any
  environment {
      MAJOR = '1'
      MINOR = '0'
  }
  stages {
    stage ('Build') {
      steps {
         UiPathInstallPlatform(
            cliVersion: 'Windows.25.10.0-20251104-11',
            traceLevel: 'Information',
         )
      }
    }
  }
}

pipeline {
  agent any
  environment {
      MAJOR = '1'
      MINOR = '0'
  }
  stages {
    stage ('Build') {
      steps {
        UiPathInstallPlatform(
            cliVersion: 'CustomVersion',
            cliNupkgPath: 'C:\Tools\UiPath.CLI.Windows.25.10.3.nupkg',
            traceLevel: 'Information',
         )
      }
    }
  }
}

次のステップ

• Jenkins ジョブを実行する - Jenkins パイプラインを設定および実行する方法を学習します。
• Jenkins プロジェクト タスク - スタンドアロンのオートメーション プロジェクトのタスクを探索します。
• Jenkins のソリューション タスク - ソリューションのタスクを探索します。