UiPath-Installationsplattform

Verwenden Sie die Aufgabe UiPath Install Platform, um die CLI auf Azure DevOps Build Agents herunterzuladen und zu installieren.

Die UiPath InstallPlatform- Aufgabe lädt eine bestimmte Version der UiPath-CLI in den Toolcache des Azure DevOps-Agenten herunter und installiert sie. Diese Aufgabe gilt sowohl für eigenständige Automatisierungsprojekte (Prozesse, Bibliotheken, Tests) als auch für Lösungen.

Wann diese Aufgabe verwendet werden soll

Verwenden Sie die Aufgabe UiPath InstallPlatform in folgenden Fällen:

• Sie möchten explizit steuern, welche CLI-Version in Ihrer Pipeline verwendet wird.
• Sie müssen eine bestimmte CLI-Variante basierend auf Ihren Projekttypen installieren ( siehe CLI-Varianten unten).
• Ihre Build-Agents haben keinen Internetzugang zum öffentlichen UiPath-Feed.
• Sie möchten die CLI auf dem Agent zwischenspeichern, um nachfolgende Builds zu beschleunigen.

Führen Sie die Aufgabe UiPath InstallPlatform vor allen anderen UiPath-Aufgaben in Ihrer Pipeline aus.

Hinweis:

Diese Aufgabe ist optional. Wenn nicht angegeben, verwendet Azure DevOps automatisch die mit der Erweiterung gebündelte CLI-Version. Die Verwendung dieser Aufgabe gibt Ihnen jedoch explizite Kontrolle und verbessert die Buildleistung durch Zwischenspeichern.

CLI-Varianten

UiPath CLI wird in plattformspezifischen Paketen verteilt:

Plattform	Architektur	CLI-Paket	Unterstützte Projekttypen
Windows	x64	UiPath.CLI.Windows	Plattformübergreifend, Windows (nicht veraltet), Lösungen
Linux	x64	UiPath.CLI.Linux	Plattformübergreifend, Lösungen
macOS	ARM64 (Apple Silicon)	UiPath.CLI.macOS	Plattformübergreifend, Lösungen
Windows	x64	UiPath.CLI.Windows.Legacy	Nur Windows-Legacy-Projekte

Hinweis:

macOS-Unterstützung ist derzeit nur für ARM64-Prozessoren (Apple Silicon) verfügbar. Intel-basierte Macs werden nicht unterstützt.

Alle CLI-Pakete erfordern .NET 8-Runtime:

• Windows-Agents: .NET Desktop Runtime 8
• Linux-Agents: .NET Runtime 8
• macOS-Agents: .NET Runtime 8

Umgang mit gemischten Projekttypen

Wenn Ihr Repository mehrere Projekttypen enthält (z. B. sowohl Windows-Legacy- als auch plattformübergreifende Projekte), müssen Sie mehrere CLI-Varianten installieren und jeden Projekttyp mit der richtigen CLI verarbeiten:

Empfohlener Ansatz

1. Installieren Sie UiPath.CLI.Windows und verarbeiten Sie alle plattformübergreifenden und Windows-Projekte (nicht Legacy).
2. Installieren Sie UiPath.CLI.Windows.Legacy und verarbeiten Sie alle Windows-Legacy-Projekte separat.

Sie können dies in derselben Azure DevOps-Pipeline erreichen, indem Sie:

• Verwenden mehrerer UiPath InstallPlatform- Aufgaben mit unterschiedlichen CLI-Versionen.
• Organisieren Ihrer Pipelinephasen, um jeden Projekttyp mit der entsprechenden CLI zu verarbeiten.
• Verwenden Sie bedingte Logik basierend auf der Ordnerstruktur oder Namenskonventionen zur Identifizierung von Projekttypen.

Tipp:

Es gibt keine automatische Möglichkeit für die UiPath-CLI, Projekttypen zu erkennen. Sie müssen wissen, welche Projekte in Ihrem Repository Windows-Legacy sind, und Ihre Pipeline entsprechend organisieren.

CLI-Versionsauswahl

Wählen Sie die Version der CLI, die Sie verwenden möchten, aus der Dropdownliste CLI-Version auswählen (Erforderlich) aus.

Die Optionen in der Dropdownliste umfassen:

• Verfügbare Versionen der UiPath-CLI 25.10 und höher.
• Die CLI-Variante (Windows, Linux, macOS oder Windows.Legacy).

Pfad zu NUPKG-Datei der CLI (Offlineszenario)

Wenn Ihre Azure DevOps-Agents nicht auf den öffentlichen UiPath-Feed zugreifen können, können Sie das CLI-Paket manuell bereitstellen:

1. Laden Sie die gewünschte CLI-Version aus dem öffentlichen UiPath-Feed herunter.

2. Platzieren Sie die heruntergeladene .nupkg -Datei im Agent.Tools -Verzeichnis Ihres Build-Agents.

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

3. Legen Sie in der UiPath InstallPlatform- Aufgabenkonfiguration die CLI-Version auf „CustomVersion“ fest und geben Sie den Pfad zur .nupkg -Datei im Feld Pfad zum nupkg-Element der CLI an.

Wichtig:

Stellen Sie sicher, dass der Name des CLI-Pakets der benutzerdefinierten Version genau mit dem aus dem offiziellen Feed übereinstimmt, wie unten:

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

YAML-Pipeline

Sie können die UiPath Install Platform-Aufgabe im YAML-Format konfigurieren:

Grundlegende Beispiele

# 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'

Installieren Sie bei Repositorys mit gemischten Projekttypen beide CLI-Varianten:

# 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'

So installieren Sie eine benutzerdefinierte Version der CLI:

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

Nächste Schritte

• Ausführen von Azure DevOps-Aufgaben – Erfahren Sie, wie Sie Azure DevOps-Pipelines konfigurieren und ausführen.
• Azure DevOps-Projektaufgaben – Erkunden Sie Aufgaben für eigenständige Automatisierungsprojekte.
• Azure DevOps Solution Tasks – Erkunden Sie Aufgaben für Lösungen.