Einrichten von UI-Erweiterungstools und -Konto

Bevor Sie eine Benutzeroberflächenerweiterung für Workfront Fusion erstellen können, müssen Sie Ihre Tools und Ihr Konto einrichten. Dies muss nur einmal geschehen.

NOTE
Dieser Artikel setzt eine gewisse Vertrautheit mit Software-Entwicklungs-Tools voraus.

Voraussetzungen

Um Ihre Tools und Ihr Konto für die Benutzeroberflächen-Erweiterbarkeit einzurichten, benötigen Sie Folgendes:

  • Eine Adobe ID mit Zugriff auf eine Adobe-Organisation. Dies ist das Konto, mit dem Sie sich bei Fusion anmelden.

  • Entwicklerzugriff auf App Builder. Ihr Organisationsadministrator muss Ihnen möglicherweise die Rolle Entwickler gewähren und Sie einem Produktprofil“, das App Builder enthält. Wenn Befehle später mit „Sie sind kein Entwickler“ fehlschlagen oder Ihr Unternehmen nicht angezeigt wird, bitten Sie Ihren Adobe-Organisationsadministrator, Sie hinzuzufügen.

  • Ein Systemadministrator (möglicherweise jemand anderes in Ihrem Team) für den letzten Veröffentlichungsschritt. Für das Erstellen und Bereitstellen ist nur die Rolle „Entwickler“ erforderlich „Zum Übermitteln einer Erweiterung zur Genehmigung/Veröffentlichung ist jedoch die Rolle „Systemadministrator“.

    Weitere Informationen zu Zugriffsebenen für Adobe finden Sie unter
    So erhalten Sie Zugriff in der Dokumentation zu Adobe.

  • Ein Computer, auf dem Sie Software installieren Terminal-Befehle ausführen können (macOS, Windows oder Linux).

Installieren von Node.js

Das Adobe-Tool wird auf Node.js ausgeführt. Sie müssen die Version LTS (18 oder 20) installieren.

  1. Gehen Sie zu https://nodejs.org und laden Sie das LTS-Installationsprogramm herunter.

  2. Führen Sie das Installationsprogramm aus und akzeptieren Sie die Standardeinstellungen.

  3. Bestätigen Sie, dass es funktioniert hat, indem Sie ein Terminal öffnen und Folgendes ausführen:

    code language-sh
    node --version
    npm --version
    

    Es sollten Versionsnummern angezeigt werden (z. B. v20.17.0 und 10.x).

  4. (Bedingt) Wenn node nicht gefunden wird, schließen und öffnen Sie das Terminal erneut oder starten Sie den Computer neu.

  5. Fahren Sie mit Installieren des Adobe I/O-CLI (aio)) ​.

TIP
  • Wenn Sie mit mehreren Knotenversionen arbeiten, ist ein Versionsmanager wie nvm praktisch, aber er ist optional.
  • Für die Adobe-CLI ist Knoten 18 oder neuer erforderlich. Sehr neue Nicht-LTS-Versionen können gelegentlich Probleme verursachen. Daher empfehlen wir die Verwendung von LTS.

Installieren des Adobe I/O-CLI (aio)

Das Befehlszeilen-Tool, mit dem Sie Ihre Erweiterung erstellen, erstellen und veröffentlichen, heißt aio.

So installieren Sie es global:

  1. Verwenden Sie den folgenden npm-Befehl in der Befehlszeile.

    code language-sh
    npm install -g @adobe/aio-cli
    
  2. Vergewissern Sie sich mithilfe des folgenden Befehls, dass es installiert ist:

    code language-sh
    aio --version
    

    Du solltest so etwas wie @adobe/aio-cli/11.x.x sehen.

  3. Fahren Sie Bei Adobe anmelden fort.

NOTE
Wenn unter macOS/Linux ein Berechtigungsfehler angezeigt wird, verwenden nicht die sudo. Korrigieren Sie stattdessen die globalen Ordnerberechtigungen von npm oder verwenden Sie einen Knotenversions-Manager, der in Ihr Basisverzeichnis installiert wird.

Bei Adobe anmelden

  1. Verbinden Sie die CLI mit dem folgenden Befehl mit Ihrem Adobe-Konto:

    code language-sh
    aio login
    
  2. Melden Sie sich in dem sich öffnenden Browser-Fenster bei Ihrer Adobe ID an und genehmigen Sie den Zugriff.

  3. Schließen Sie nach erfolgreicher Anmeldung die Browser-Registerkarte und kehren Sie zum Terminal zurück.

  4. (Optional) Um sich später abzumelden (z. B. um zu einem anderen Konto zu wechseln), verwenden Sie den Befehl: aio logout.

  5. Fahren Sie fort Bestätigen Sie Ihre aktive Organisation.

Bestätigen der aktiven Organisation

Überprüfen Sie, auf welche Organisation das CLI verweist:

aio console org list      # see organizations you can use
aio console where         # see your currently selected org/project/workspace

Wenn Sie mehreren Organisationen angehören, wählen Sie die richtige aus:

aio console org select

Jetzt können Sie das Projekt erstellen.

recommendation-more-help
workfront-fusion-help-workfront-fusion