UiPath-Installationsplattform

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

Die Aufgabe UiPath InstallPlatform lädt eine bestimmte Version der UiPath-CLI in den Toolcache des Jenkins-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 Jenkins automatisch die mit dem Plugin 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

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 Jenkins-Pipeline erreichen, indem Sie:

• Verwenden mehrerer UiPath InstallPlatform -Schritte mit unterschiedlichen CLI-Versionen.
• Organisieren Ihrer Buildphasen, 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.

Selektor für die UiPath-CLI-Version

Wählen Sie die Version der UiPath-CLI, die Sie verwenden möchten, aus der Dropdownliste CLI-Version auswählen 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).
• Die .NET-Laufzeitanforderungen für jede Version.

Pfad zur NUPKG-Datei der UiPath-CLI (Offlineszenario)

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

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

2. Legen Sie die heruntergeladene .nupkg -Datei an einem zugänglichen Speicherort im Arbeitsbereich-Verzeichnis des Agents ab.

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

3. Legen Sie in der UiPathInstallPlatform- Aufgabenkonfiguration die CLI-Version auf „CustomVersion“ fest und geben Sie den Pfad zur .nupkg -Datei im Feld Pfad zur nupkg-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

Pipeline-Beispiel

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',
         )
      }
    }
  }
}

Nächste Schritte

• Ausführen von Jenkins-Aufträgen – Erfahren Sie, wie Sie Jenkins-Pipelines konfigurieren und ausführen.
• Jenkins-Projektaufgaben – Erkunden Sie Aufgaben für eigenständige Automatisierungsprojekte.
• Jenkins-Lösungsaufgaben – Erkunden Sie Aufgaben für Lösungen.