Oracle Mobile Hub Tooling für das Deployment benutzerdefinierter APIs installieren und konfigurieren

Sie können zusätzliche Tools herunterladen und konfigurieren, um benutzerdefinierte APIs in Oracle Mobile Hub bereitzustellen.

Node.js Tooling installieren

Wenn Sie das SDK von Oracle Technology Network (OTN) herunterladen, können Sie die Datei omce-tools-vXX.X.X herunterladen, die ein Node.js-Skript enthält, mit dem Sie Ihre Anwendungen in Oracle Mobile Hub bereitstellen können.

So installieren Sie das Node.js-Tooling in Ihrem Projekt:

Laden Sie die ZIP-Datei omce-tools-vXX.X.X herunter, und dekomprimieren Sie die ZIP-Datei in einem Verzeichnis
Öffnen Sie auf Ihrem Rechner ein Terminalfenster (möglicherweise muss dieser Befehl als Admin-Benutzer ausgeführt werden), und ändern Sie dann das Verzeichnis omce-tools/node-configurations.
Legen Sie die Knotenkonfiguration fest, die Sie für die benutzerdefinierte API verwenden müssen, die Sie testen. Verwenden Sie 6.10 als Knotenversions-6.10.0 oder -kompatibel, und verwenden Sie 8.9 als Knotenversions-8.9.4 oder -kompatibel. Die Standardknotenkonfiguration für Oracle Mobile Hub ist 8.9.
Wechseln Sie zu dem Verzeichnis für die Knotenkonfiguration, die Sie verwenden möchten: entweder `6.10` oder `8.9`
Führen Sie den folgenden Befehl aus:
```
npm install
```
Wechseln Sie zum Verzeichnis omce-tools.
Führen Sie den Befehl aus:
```
npm install -g
```
Dieser Befehl stellt das Tooling global in Ihrer lokalen Umgebung zur Verfügung. Sie müssen vor dem Ausführen dieses Befehls Node.js und den Package-Manager npm installiert haben.
Legen Sie die Umgebungsvariable NODE_PATH auf das Verzeichnis node_modules für die Knotenkonfiguration fest, die Sie verwenden möchten, oder auf path/omce-tools/node-configurations/8.9/node_modules.
Um zu testen, ob die Installation erfolgreich war, führen Sie den Befehl aus:
```
omce-test --version
```

JavaScript-Gerüst für eine benutzerdefinierte API herunterladen

Nachdem Sie die benutzerdefinierte API erstellt haben, können Sie ein scaffold herunterladen, das auf dem RAML-Dokument Ihrer API basiert. Danach verwenden Sie das scaffold als Schnellstart zur Implementierung Ihrer benutzerdefinierten API.

Das scaffold wird in Form eines Knotenmoduls, den Schlüsselkomponenten, von denen es sich um die JavaScript-Hauptdatei handelt, die Stub-Methoden für jeden Endpunkt (Ressource plus HTTP-Methode) und eine package.json-Datei enthält, die als Manifest für das Modul dient.

So laden Sie das Format herunter:

Klicken Sie auf , um das Seitenmenü zu öffnen, klicken Sie auf Entwicklung, und klicken Sie dann auf APIs.
Öffnen Sie die API, die Sie herunterladen möchten.
Klicken Sie im linken Navigationsbereich von API Designer auf Implementierungen .
Klicken Sie auf JavaScript-Gerüst , um die ZIP-Datei herunterzuladen.
Entpacken Sie die heruntergeladene Datei auf Ihrem System.

Wenn Sie die API später ändern, können Sie ein neues Format basierend auf den aktualisierten Endpunkten herunterladen. Jede Codierung, die Sie möglicherweise vorgenommen und hochgeladen haben, wird jedoch nicht in dem neuen Format wiedergegeben.

toolsConfig.jsin Datei konfigurieren

Nachdem Sie eine scaffalte-Datei heruntergeladen haben, die auf dem RAML-Dokument Ihrer API basiert, können Sie eine JavaScript Notation-(JSON-)Datei mit dem Namen toolsConfig.json manuell konfigurieren.

Oracle Mobile Hub verwendet eine toolsConfig.json-Datei, die die Deployment-Informationen für eine benutzerdefinierte API enthält. Beim Erstellen einer benutzerdefinierten API wird ein toolsConfig.json-Standard generiert, und Sie laden das scaffold herunter. So konfigurieren Sie die Datei toolsConfig.json:

Öffnen Sie die Seite "Einstellungen" des mobilen Backends in Oracle Mobile Hub
Beachten Sie die Informationen auf der Seite "Einstellungen ".
Die Seite "Einstellungen " enthält Informationen wie die Typen der Authentifizierung (HTTP Basic, OAuth Consumer) und die Umgebungs-URLs.

Aktualisieren Sie mit einem Texteditor die Datei toolsConfig.json mit den Werten der Seite "Einstellungen " in Oracle Mobile Hub.

    "backend":{
        "backendId":"<YOUR_BACKEND_ID>",
        "backendName":"<YOUR_BACKEND_NAME>",
        "backendVersion":"<YOUR_BACKEND_VERSION>",
        "authorization":{
            "anonymousKey":"<BACKEND_ANONYMOUS_KEY>",
            "clientId":"<BACKEND_CLIENT_ID>",
            "clientSecret":"<BACKEND_CLIENT_SECRET>"
        }
    },

Öffnen Sie die Entwicklungsseite.
Klicken Sie auf Instanzdetails .
Notieren Sie die Werte für Client Secret von Teammitglieder-App und Teammitglied .

Aktualisieren Sie die Datei toolsConfig.json mit diesen Werten.

    "tools":{
        ...,
        "authorization":{
            "clientId":"<TEAM_MEMBER_APP_CLIENT_ID>",
            "clientSecret":"<TEAM_MEMBER_APP_CLIENT_SECRET>"
        }
    },

(Optional) Um zu testen, ob toolsConfig.json richtig ist, können Sie einen Deployment-Test ausführen. Öffnen Sie ein Terminalfenster, navigieren Sie zum Verzeichnis omce-tools, und stellen Sie die benutzerdefinierte API mit dem Befehl bereit:
```
node omce-deploy toolsConfig.json
```
Nachdem Sie diesen Befehl ausgeführt haben, werden Sie zur Eingabe Ihrer Zugangsdaten für Oracle Mobile Hub aufgefordert. Wenn die Datei toolsConfig.json korrekt ist, wird eine Meldung mit dem Hinweis Deployment completed successfully angezeigt. Mit diesem Befehl können Sie Ihre benutzerdefinierte API in Zukunft bereitstellen.