UiPath-Installationsplattform

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 drei plattformspezifischen Paketen verteilt:

CLI-Paket	OS	Unterstützte Projekttypen
UiPath.CLI.Windows	Windows	Plattformübergreifend, Windows (nicht veraltet), Lösungen
UiPath.CLI.Linux	Linux	Plattformübergreifend, Lösungen
UiPath.CLI.Windows.Legacy	Windows	Nur Windows-Legacy-Projekte

Alle CLI-Pakete erfordern .NET 8-Runtime:

• Windows-Agents: .NET Desktop Runtime 8
• Linux-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 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.1-20251105-9.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.1-20251105-9.nupkg
• UiPath.CLI.Linux.25.10.1-20251105-9.nupkg

YAML-Pipeline

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

- task: UiPathInstallPlatform@6  displayName: 'UiPath Install Platform'  inputs:    cliVersion: 'Windows.25.10.1-20251105-9'  # For UiPath.CLI.Windows    # or 'Linux.25.10.1-20251105-9'         # For UiPath.CLI.Linux    # or 'Windows.Legacy.25.10.9424.14050'  # For UiPath.CLI.Windows.Legacy

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.1-20251105-9'# 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.1-20251105-9.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.