uip rpa-legacy

Commandes dans `uip rpa-legacy`, un wrapper Windows uniquement pour le fichier `uipcli.exe` Les commandes Studio ne sont pas encore portées sur `uip rpa`.

uip rpa-legacy is a Windows-only wrapper around the legacy uipcli.exe (the 2025.10 .NET CLI) for Studio-side commands that have not been ported to the cross-platform uip rpa tool. Use it for debug, validate, find-activities, find-package, type-definition, and the legacy pack path. Cross-platform users — Linux, macOS, or Windows pipelines that do not need these features — should use uip rpa instead.

L’outil est publié en tant que @uipath/rpa-legacy-tool dans le registre npm de GitHub. Il regroupe uipcli.exe sous le profil et le shell pour chaque verbe. La sortie est façonnée pour correspondre à l'enveloppe JSON uip standard, de sorte que les scripts existants qui utilisent JSON uip continuent de fonctionner.

Avertissement :

Windows uniquement

Chaque verbe uip rpa-legacy refuse de s’exécuter sur macOS ou Linux avec une ConfigError. Le fichier uipcli.exe fourni est un binaire Windows uniquement; il s’agit de la conception et ne changera pas. Pour les pipelines multiplate-formes, utilisez uip rpa.

Verbes

Verbe	Objectif
find-activities	Recherchez les activités exposées par les dépendances d'un projet.
type-definition	Inspectez un type.NET à partir des dépendances du projet.
find-package	Recherchez des packages NuGet dans les flux configurés.
validate	Validez un fichier ou un projet XAML pour les erreurs de compilation.
debug	Exécutez le workflow XAML localement via UiRobot.
pack	Compressez un projet RPA dans un .nupkg à l'aide du packageur hérité.

Quand utiliser cet outil

Besoin	Utiliser (Use)
Compresser un projet Studio sur Linux, macOS ou dans le cadre d'un pipeline multiplateforme	uip rpa pack
Exécuter l’analyseur de workflow sur Linux/macOS	uip rpa analyze
Restaurer les dépendances de Studio sur Linux/macOS	uip rpa restore
Déboguer un workflow XAML localement via UiRobot	uip rpa-legacy debug
Valider un workflow/projet XAML pour les erreurs de compilation	uip rpa-legacy validate
Inspecter un type.NET à partir des dépendances du projet	uip rpa-legacy type-definition
Rechercher des activités dans les dépendances du projet	uip rpa-legacy find-activities
Rechercher des packages NuGet dans les flux configurés	uip rpa-legacy find-package
Créer le package avec le package uipcli hérité directement	uip rpa-legacy pack

Prérequis

• Windows. Chaque verbe vérifie le système d'exploitation hôte et se termine avec un ConfigError sous Windows.
• Exécution.NET. Le bundle uipcli.exe nécessite.NET; rpa-legacy n'installe pas .NET pour vous.
• UiRobot installé localement pour debug — le verbe invoque l'UiRobot local pour exécuter le workflow.
• Outil installé: uip tools install @uipath/rpa-legacy-tool. L’installation automatique s’exécute également lors de la première invocation.

Synthèse

uip rpa-legacy <verb> [options]

Tous les verbes respectent les options globales (--output, --output-filter, --log-level, --log-file) et les codes de sortie standard.

Migration depuis la version héritée de uipcli

Si vous avez précédemment appelé uipcli debug, uipcli validate, uipcli package, etc., les verbes correspondent directement:

Invocation héritée	équivalent UIP
uipcli debug <xaml> -i <json>	uip rpa-legacy debug <xaml> --input <json>
uipcli validate <path>	uip rpa-legacy validate <path>
uipcli package <project> -o <dir>	uip rpa-legacy pack <project> -o <dir>
uipcli find-activities <project> --query <q>	uip rpa-legacy find-activities <project> --query <q>
uipcli find-package --query <q>	uip rpa-legacy find-package --query <q>
uipcli type-definition <project> --type <name>	uip rpa-legacy type-definition <project> --type <name>

La sortie est encapsulée dans l'enveloppe JSON uip ; les pipelines qui analysent la sortie de texte héritée doivent s’adapter ou transmettre --output table pour la lecture humaine.

Voir également

• uip rpa — le remplacement multiplate-forme des verbes qui ont été portées.
• Options globales
• Codes de sortie