Plate-forme d'installation UiPath

Utilisez la tâche UiPath Install Platform pour télécharger et installer la CLI sur les agents de build Jenkins.

La tâche UiPathInstallPlatform télécharge et installe une version spécifique de la CLI UiPath dans le cache d’outils de l’agent Jenkins. Cette tâche s’applique à la fois aux projets d’automatisation autonomes (processus, bibliothèques, tests) et aux solutions.

Quand utiliser cette tâche

Utilisez la tâche UiPathInstallPlatform lorsque :

• Vous souhaitez contrôler explicitement la version CLI utilisée dans votre pipeline.
• Vous devez installer une version CLI spécifique en fonction de vos types de projet.
• Vos agents de développement n'ont pas accès Internet au flux public UiPath.
• Vous souhaitez mettre la CLI en cache sur l'agent afin d'accélérer les génération suivantes.

Exécutez la tâche UiPathInstallPlatform avant toutes les autres tâches UiPath de votre pipeline.

Remarque :

Cette tâche est facultative. En l’absence d’indication, Jenkins utilisera automatiquement la version CLI fournie avec le plug-in. Cependant, l’utilisation de cette tâche vous donne un contrôle explicite et améliore les performances du générateur grâce à la mise en cache.

Formats CLI

CLI UiPath est distribuée sous forme de packages spécifiques à la plateforme :

Plate-forme	Architecture	Package CLI	Types de projet pris en charge
Windows	x64	UiPath.CLI.Windows	Multiplate-forme, Windows (non hérité), Solutions
Linux	x64	UiPath.CLI.Linux	Multiplate-forme, solutions
macOS	ARM64 (Apple Silicon)	UiPath.CLI.macOS	Multiplate-forme, solutions
Windows	x64	UiPath.CLI.Windows.Legacy	Projets hérités depuis Windows uniquement

Tous les packages CLI nécessitent le runtime .NET 8 :

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

Gérer les types de projets mixtes

Si votre référentiel contient plusieurs types de projets, vous devez installer plusieurs versions de CLI et traiter chaque type de projet avec la CLI correcte :

Approche recommandée

1. Installez UiPath.CLI.Windows et traitez tous les projets multiplateformes et Windows.
2. Installez UiPath.CLI.Windows.Legacy et traitez tous les projets Windows Héritage séparément.

Vous pouvez y parvenir dans le même pipeline Jenkins en :

• Utilisation de plusieurs étapes UiPathInstallPlatform avec différentes versions de CLI.
• Organisation de vos étapes de développement pour traiter chaque type de projet avec la CLI appropriée.
• Utilisation d'une logique conditionnelle basée sur la structure des dossiers ou les conventions d'affectation de noms pour identifier les types de projet.

Astuce :

Il n'existe aucun moyen automatique pour la CLI UiPath de détecter les types de projet. Vous devez savoir quels projets de votre référentiel sont Windows - Legacy et organiser votre pipeline en conséquence.

Sélecteur de version de la CLI UiPath

Sélectionnez la version de la CLI UiPath que vous souhaitez utiliser dans la liste déroulante Choisir une version de CLI .

Les options de la liste déroulante incluent :

• Versions disponibles de UiPath CLI 25.10 et ultérieures.
• Version CLI (Windows, Linux ou Windows.Legacy).
• La configuration requise pour chaque version sur le runtime .NET.

Chemin d’accès au nupkg de la CLI UiPath (scénario hors ligne)

Si vos agents Jenkins ne peuvent pas accéder au flux public UiPath, vous pouvez fournir manuellement le package CLI :

1. Téléchargez la version de la CLI UiPath souhaitée à partir du flux public UiPath.

2. Placez le fichier .nupkg téléchargé dans un emplacement accessible du répertoire de l’espace de travail de l’agent.

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

3. Dans la configuration de la tâche UiPathInstallPlatform , définissez la version de la CLI sur « CustomVersion » et indiquez le chemin d’accès au fichier .nupkg dans le champ Chemin d’accès à la CLI nupkg .

Important :

Assurez-vous que le nom du package CLI de la version personnalisée correspond exactement à celui du flux officiel tel que ci-dessous :

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

Exemple de pipeline

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

Prochaines étapes

• Exécution des tâches Jenkins : découvrez comment configurer et exécuter les pipelines Jenkins.
• Tâches de projet Jenkins - Parcourez les tâches pour les projets d’automatisation autonomes.
• Tâches de solution Jenkins : parcourez les tâches pour les solutions.