Plate-forme d'installation UiPath

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 Azure DevOps. 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, Azure DevOps utilisera automatiquement la version CLI fournie avec l'extension. 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

Remarque :

La prise en charge de macOS n’est actuellement disponible que pour les processeurs ARM64 (Apple Silicon) . Les Mac basés sur Intel ne sont pas pris en charge.

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

• Agents Windows : .NET Desktop Runtime 8
• Agents Linux : .NET Runtime 8
• agents macOS : .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 Azure DevOps en :

• Utilisation de plusieurs tâches UiPathInstallPlatform avec différentes versions de CLI.
• Organisation de vos étapes de pipeline 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 CLI

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

Les options de la liste déroulante incluent :

• Versions disponibles de UiPath CLI 25.10 et ultérieures.
• La version CLI (Windows, Linux, macOS ou Windows.Legacy).

Chemin d’accès au nupkg de la CLI

Si vos agents Azure DevOps 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 souhaitée à partir du flux public UiPath.

2. Placez le fichier .nupkg téléchargé dans le répertoire Agent.Tools de votre agent de développement.

   Exemple : $(Agent.ToolsDirectory)\nupkg\UiPath.CLI.Windows.25.10.3.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 au nupkg de la CLI .

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

Pipeline YAML

Vous pouvez configurer la tâche UiPath Install Platform au format YAML :

Exemples de base

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

Pour les référentiels avec des types de projets mixtes, installez les deux versions 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'

Pour installer une version personnalisée de la CLI :

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

Prochaines étapes

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