Direkt zum Hauptinhalt

Eine benutzerdefinierte React-App öffnen

Ziel​

Eine benutzerdefinierte React-App, die in einer Umgebung registriert wurde, über die Startseite der Plattform-Shell öffnen.

Voraussetzungen​

  • Sie sind bei der Plattform-Shell angemeldet.
  • Sie haben Zugriff auf die Umgebung, in der die benutzerdefinierte React-App installiert ist.
  • Die benutzerdefinierte React-App ist in dieser Umgebung registriert (siehe Eine benutzerdefinierte React-App registrieren).

Schritte​

  1. Wählen Sie in der Plattform-Shell mit dem Umgebungswechsler die Umgebung aus, in der die benutzerdefinierte React-App installiert ist.
  2. Wechseln Sie zur Startseite der Shell. Die benutzerdefinierte React-App erscheint neben den integrierten modellgesteuerten Apps, mit dem Anzeigenamen, unter dem sie registriert wurde.
  3. Wählen Sie die benutzerdefinierte React-App aus. Die Shell lädt sie, und sie öffnet sich direkt an Ort und Stelle.

Was im Hintergrund passiert​

Bevor die App geladen wird, fordert die Plattform-Shell ein eng begrenztes, kurzlebiges Zugriffstoken an, das nur für diese App und diese Umgebung gilt. Dann lädt sie den Remote-Code der App und rendert ihn direkt – die App teilt sich die eine React-Laufzeit der Shell, statt in einem isolierten Frame zu laufen. Die App erreicht Plattformdaten und Protokollierung nur über das Runtime SDK, das die Shell bereitstellt, und handelt daher immer mit den Berechtigungen des angemeldeten Benutzers in der aktuellen Umgebung. Eine App, deren Code von einem Ursprung ausgeliefert wird, der nicht auf der Positivliste der Umgebung steht, wird abgewiesen, bevor sie geladen wird.

Fehlerbehebung​

  • Die App wird auf der Startseite nicht aufgeführt. – Prüfen Sie, ob Sie sich in der Umgebung befinden, in der die App registriert wurde; eine in einer Umgebung installierte benutzerdefinierte React-App erscheint in keiner anderen, bis ihre Lösung dort importiert wird.
  • „Der Code dieser App wird von einem blockierten Ursprung ausgeliefert.“ – Die remoteEntry-URL der App steht nicht auf der Positivliste der Umgebung. Ein Administrator muss den Ursprung hinzufügen, bevor die Shell die App lädt.

Verwandte Szenarien​

  • Eine benutzerdefinierte React-App registrieren.