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

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

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

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

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

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

注:

このタスクは任意です。指定しない場合、Azure DevOps は拡張機能にバンドルされている 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 - レガシ プロジェクトのみ

注:

macOS のサポートは現在、ARM64 (Apple Silicon) プロセッサでのみ利用可能です。Intel プロセッサ搭載の Mac はサポートされていません。

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

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

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

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

推奨されるアプローチ:

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

これは、同じ Azure DevOps パイプラインで次の方法で実現できます。

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

ヒント:

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

CLI バージョン セレクター

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

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

• UiPath CLI 25.10 以降の利用可能なバージョン。
• The CLI flavor (Windows, Linux, macOS or Windows.Legacy).

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

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

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

2. ダウンロードした .nupkg ファイルをビルド エージェントの Agent.Tools ディレクトリ内に配置します。

   例: $(Agent.ToolsDirectory)\nupkg\UiPath.CLI.Windows.25.10.3.nupkg

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

重要:

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

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

YAML パイプライン

[UiPath のインストール プラットフォーム] タスクは YAML 形式で設定できます。

Basic examples

# Windows
- task: UiPathInstallPlatform@6
  displayName: 'Install UiPath CLI for Windows'
  inputs:
    cliVersion: 'Windows.25.10.3'

# Linux
- task: UiPathInstallPlatform@6
  displayName: 'Install UiPath CLI for Linux'
  inputs:
    cliVersion: 'Linux.25.10.3'

# macOS (Apple Silicon)
- task: UiPathInstallPlatform@6
  displayName: 'Install UiPath CLI for macOS'
  inputs:
    cliVersion: 'macOS.25.10.3'

# Windows Legacy
- task: UiPathInstallPlatform@6
  displayName: 'Install UiPath CLI for Windows Legacy'
  inputs:
    cliVersion: 'Windows.Legacy.25.10.9424.14050'

プロジェクトの種類が混在するリポジトリの場合は、両方の CLI フレーバーをインストールします。

# Install CLI for Cross-platform and Windows (non-legacy) projects
- task: UiPathInstallPlatform@6
  displayName: 'Install UiPath CLI Windows'
  inputs:
    cliVersion: 'Windows.25.10.3'

# Install CLI for Windows-Legacy projects
- task: UiPathInstallPlatform@6
  displayName: 'Install UiPath CLI Windows Legacy'
  inputs:
    cliVersion: 'Windows.Legacy.25.10.9424.14050'

CLI のカスタム バージョンをインストールするには:

- task: UiPathInstallPlatform@6
  displayName: 'UiPath Install Platform'
  inputs:
    cliVersion: 'CustomVersion'
    cliNupkgPath: 'C:\Tools\UiPath.CLI.Windows.25.10.3.nupkg'

次のステップ

• Azure DevOps タスクを実行する - Azure DevOps パイプラインを構成および実行する方法について説明します。
• Azure DevOps プロジェクト タスク - スタンドアロンのオートメーション プロジェクトのタスクを探索します。
• Azure DevOps のソリューション タスク - ソリューションのタスクを探索します。