Cordova-Anwendungen über die MobileFirst Platform CLI registrieren

Sie können die IBM MobileFirst Platform Command Line Interface (CLI) verwenden, um Ihre Cordova-Anwendung bei einer Instanz von MobileFirst Server zu registrieren.

Vorbereitende Schritte

Die IBM MobileFirst Platform Command Line Interface (CLI) muss installiert sein. Weitere Informationen finden Sie unter MobileFirst Platform CLI installieren.
Sie benötigen eine aktive MobileFirst-Server-Instanz. Der Server kann lokal ausgeführt werden oder ein ferner Server sein. Er muss jedoch in jedem Fall von Ihrem lokalen Computer aus erreichbar sein. Weitere Informationen finden Sie unter MobileFirst Development Server einrichten, IBM MobileFirst Platform Foundation Developer Kit installieren oder IBM MobileFirst Platform Server installieren.
Auf Ihrem lokalen Computer mit bereits installierten Plattformen muss sich eine Cordova-Anwendung befinden. Weitere Informationen finden Sie auf der Apache-Cordova-Website unter The Command-Line Interface.

Informationen zu diesem Vorgang

Nachdem Sie die Clientseite Ihrer Cordova-Anwendung definiert haben, können Sie weitere Entwicklungsschritte vorbereiten, indem Sie die Anwendung bei einem MobileFirst Server registrieren.

Vorgehensweise

Vergewissern Sie sich, dass der Ziel-MobileFirst-Server betriebsbereit ist.
Navigieren Sie zu dem Verzeichnis mit Ihrer App oder einem der zugehörigen Unterverzeichnisse.
Wichtig:
- Wenn das aktuelle Verzeichnis platforms/Plattform oder eines der zugehörigen Unterverzeichnisse ist, erfolgt die Registrierung nur für diese Plattform.
- Wenn Sie auf der Windows-Plattform nur bestimmte Versionen der Windows-App registrieren möchten, verwenden Sie die Option --windows des Befehls mfpdev app register, um die Versionen anzugeben. Der Befehl mfpdev app register --windows windows,windowsphone8 registriert die App beispielsweise für Windows 10 Universal und Windows Phone 8.1. Mit mfpdev app register --windows windows8 wird der Windows-8.1-Desktopabschnitt Ihrer Cordova-App registriert.
Registrieren Sie Ihre App beim Server. Verwenden Sie dafür eine der folgenden Methoden:
- Wenn Sie die App beim Standardserver registrieren möchten, führen Sie den folgenden Befehl aus:
```
mfpdev app register
```
  Anmerkung: Falls Sie noch keinen Standardserver festgelegt haben und auf dem lokalen System ein MobileFirst Server ausgeführt wird, wird die App mit diesem Befehl beim lokalen MobileFirst Server registriert. Gleichzeitig wird dieser Server zum Standardserver erklärt.
- Wenn Sie IHre App bei einem anderen als dem Standardserver registrieren möchten, gehen Sie wie folgt vor:
  1. Erstellen Sie ein Serverprofil. Führen Sie dazu den Befehl mfpdev server add aus. Beispiel:
```
mfpdev server add Server1 -url https://company.mobile.com:9080 -login admin -password secretPassword!
```
    Für weitere Informationen zum Befehl mfpdev server add können Sie mfpdev help server add ausführen.
  2. Zum Registrieren Ihrer App bei dem soeben definierten Server müssen Sie den Befehl mfpdev app register ausführen und das gerade erstellte Serverprofil angeben. Beispiel:
```
mfpdev app register Server1
```
Weitere Informationen zu diesem Befehl und dessen optionalen Parametern können Sie mit mfpdev help app register aufrufen.
Führen Sie den Befehl cordova prepare aus, um die Änderungen an alle Zielplattformen Ihrer Cordova-App weiterzugeben. Die Server-URL wird in die Datei config.xml kopiert, die sich im Unterverzeichnis für jede Plattform befindet.

Ergebnisse

Die App ist beim Zielserver registriert. Daten der App werden aus der Datei config.xml angefordert (z. B. der Anwendungsname, die Versionsnummer und die App-ID) und an den Server gesendet. Die Clienteigenschaftendatei config.xml im Stammverzeichnis wird mit dem Wert der Server-URL aktualisiert, da es in den Unterverzeichnissen für die verschiedenen App-Plattformen Kopien von config.xml gibt.

Nächste Schritte

Sie können mit weiteren Entwicklungsaufgaben fortfahren, bei denen der MobileFirst Server involviert ist. Sie können beispielsweise eine Vorschau Ihrer App anzeigen, die Sicherheitsfeatures Ihrer App testen und Ihre App in der MobileFirst Operations Console verwalten.