Erstellen und Bereitstellen von codierten Apps

Erstellen und Bereitstellen einer codierten App in UiPath: Was Sie benötigen, bevor Sie beginnen, wie die App in einer IDE erstellt wurde und wie sie in einem Orchestrator-Ordner veröffentlicht und bereitgestellt wird.

Eine codierte App startet als Webanwendung, die ein Entwickler in seine eigene IDE schreibt, und endet als App, die Ihre Benutzer über eine UiPath-URL öffnen. Auf dieser Seite werden dieser Ablauf und die Bereitstellungsschritte beschrieben, die in UiPath stattfinden.

Der Prozess umfasst vier Phasen:

1. Definieren der App-Logik in einer IDE.
2. Herstellung einer sicheren Verbindung zu UiPath.
3. Bereitstellen der App im Orchestrator.
4. Zugriff auf die App innerhalb des UiPath-Ökosystems.

Bevor Sie beginnen

Wichtig:

In Automation Cloud Dedicated and Test Cloud Dedicated, use UiPath CLI version 1.202.0 for the pack, publish, deploy, and push steps until your Dedicated production environment is upgraded to the Apps release dated September 24, 2026. Later CLI versions contain breaking changes that are incompatible with the Apps version currently running in Dedicated environments. After your Dedicated production environment is upgraded to the September 24, 2026 Apps release, you can use later versions of the UiPath CLI.

For troubleshooting, see Why do uip codedapp commands fail in Automation Cloud Dedicated?.

Stellen Sie sicher, dass Folgendes vorhanden ist:

• Eine lokale Entwicklungsumgebung mit Node.js 20.x oder neuer und npm, die zum Erstellen der App und zum Installieren der UiPath-Tools verwendet wird. Laden Sie das Installationsprogramm von Nodejs.org herunter, das npm enthält. Führen Sie node -v und npm -v aus, um zu überprüfen, was bereits installiert ist.
• Die UiPath CLI mit installiertem codedapp -Tool. Installationsanweisungen finden Sie im UiPath CLI -Handbuch.
• Eine externe App-ID aus einer externen Anwendung, die in Ihrer Organisation registriert ist. Die App verwendet es, um Benutzer anzumelden und UiPath-Dienste in deren Namen aufzurufen. Eine codierte App wird im Browser ausgeführt und kann kein App-Geheimnis speichern. Registrieren Sie sie daher als nicht vertrauliche Anwendung mit Benutzer-Scopes. Informationen zum Registrieren finden Sie unter Hinzufügen einer externen Anwendung im Administratorhandbuch zu Automation Cloud.
• Berechtigung zum Veröffentlichen von Paketen und Bereitstellen von Apps in dem Orchestrator-Ordner, den Sie anzielen.

Erstellen Sie die App

Der Entwickler erstellt die App auf die gleiche Weise wie jede Webanwendung, und zwar im Framework ihrer Wahl, z. B. React, Vue oder Angular. UiPath fügt diesem Workflow zwei Dinge hinzu:

• Eine Verbindung mit Ihrer Organisation. Eine Konfigurationsdatei im Stammverzeichnis des Projekts identifiziert Ihre Organisation, Ihren Mandanten und Ihre externe App-ID. Das UiPath TypeScript SDK liest diese Konfiguration, sodass die App UiPath-Dienste wie Orchestrator, Assets, Speicher-Buckets und Prozesse aufrufen kann.
• Ein lokales Entwicklungssetup. Ein UiPath-Plugin für das Build-Tool des Projekts liefert dieselbe Konfiguration, während die App auf der Maschine des Entwicklers ausgeführt wird, sodass die App mit einem echten Mandanten getestet werden kann, bevor sie bereitgestellt wird.

Beide sind ein einmaliges Setup pro Projekt. Das vollständige Entwicklersetup, einschließlich der Konfigurationsdatei, des Erstellungstool-Plugins und der Anpassungen, die die App benötigt, bevor sie verpackt wird, finden Sie unter Erste Schritte mit codierten Apps in der SDK-Dokumentation.

Stellen Sie die App bereit

Die Bereitstellung erfolgt in zwei Teilen: Der Entwickler verpackt und veröffentlicht die App, dann stellen Sie dieses Paket in einem Orchestrator-Ordner bereit.

Verpacken und Veröffentlichen der App

Eine codierte App wird im Orchestrator als .nupkg -Paket veröffentlicht, dem gleichen Paketformat, das für Automatisierungen verwendet wird.

1. Erstellen Sie die App:

   npm run build
   

2. Verpacken Sie die Buildausgabe:

   uip codedapp pack dist -n <appName> --version 1.0.0
   

3. Melden Sie sich bei Ihrer UiPath-Organisation an:

   uip login
   

4. Veröffentlichen Sie das Paket in einem Mandantenfeed oder einem Feed für den persönlichen Arbeitsbereich:

   uip codedapp publish
   

5. Stellen Sie die App bereit:

   uip codedapp deploy
   

Die vollständige Argumentliste jedes Befehls finden Sie unter uip codedapp im UiPath-CLI-Handbuch.

Stellen Sie die App über den Orchestrator bereit

Wenn das Paket bereits veröffentlicht wurde oder wenn Sie die Befehlszeile nicht verwenden möchten, stellen Sie die App stattdessen über den Orchestrator bereit.

1. Wechseln Sie im Orchestrator zu Mandant > Pakete.
2. Wählen Sie Hochladen aus und laden Sie die von uip codedapp pack erstellte Datei .nupkg hoch. Das detaillierte Verfahren finden Sie unter Verwalten von Paketen.
3. Wechseln Sie zu dem Ordner, in dem Sie die App bereitstellen möchten, und gehen Sie zu Automatisierungen > Apps.
4. Wählen Sie App bereitstellen und dann Ihre App und deren Version. Das detaillierte Verfahren finden Sie unter Verwalten von Apps.

Stellen Sie die App über Studio Web bereit

Wenn die App als codiertes App-Projekt innerhalb einer Studio Web-Lösung erstellt wurde, wird sie zusammen mit dieser Lösung gepackt und nicht eigenständig bereitgestellt. Die Version der codierten App bleibt im Gleichschritt mit den Workflows, Agents und Ressourcen, von denen sie abhängt.

1. Erstellen Sie die App lokal und pushen Sie sie dann in das Studio Web-Projekt:

   uip codedapp push --project-id <project-id>
   

2. Öffnen Sie in Studio Web die Lösung und wählen Sie Bereitstellen.

3. Legen Sie die Paketversion fest, wählen Sie, ob in Ihrem persönlichen Arbeitsbereich oder in einem freigegebenen Arbeitsbereich gepackt werden soll, benennen Sie die Bereitstellung, wählen Sie einen Ordner aus und wählen Sie Bereitstellen.

Den vollständigen Satz von Optionen im Bereitstellungsbereich finden Sie unter Veröffentlichen und Bereitstellen von Lösungen im Studio Web-Benutzerhandbuch.

Ihre App ist jetzt unter https://<orgName>.uipath.host/<appName> verfügbar.