MobileFirst-Foundation-SDK zu Ionic-Anwendungen hinzufügen
improve this page | report issueÜbersicht
In diesem Lernprogramm erfahren Sie, wie das MobileFirst-SDK zu einer neuen oder vorhandenen Ionic-Anwendung, die über die Ionic-CLI erstellt wurde, hinzugefügt wird. Sie werden auch lernen, wie MobileFirst Server konfiguriert werden muss, um die Anwendung zu erkennen. Außerdem erfahren Sie, wie Sie Informationen zu den MobileFirst-Konfigurationsdateien, die im Projekt geändert werden, finden können.
Das MobileFirst-Ionic-SDK wird in Form von Typescript-Wrappern und Cordova-Plug-ins bereitgestellt und ist bei NPM registriert.
Folgende Plug-ins sind verfügbar:
- cordova-plugin-mfp - zentrales SDK-Plug-in
- cordova-plugin-mfp-push - Unterstützung für Push-Benachrichtigungen
- cordova-plugin-mfp-jsonstore - Unterstützung für JSONStore
Support-Level
Von den MobileFirst-Plug-ins werden folgende Ionic-Cordova-Plattformversionen unterstützt:
- cordova-ios: >= 4.1.1 und < 5.0
- cordova-android: >= 6.1.2 und < 7.0
- cordova-windows: >= 4.3.2 und < 6.0
Fahren Sie mit folgenden Abschnitten fort:
- Ionic-SDK-Komponenten
- MobileFirst-Ionic-SDK hinzufügen
- MobileFirst-Ionic-SDK aktualisieren
- Generierte Artefakte des MobileFirst-Ionic-SDK
- Nächste Lernprogramme
Ionic-SDK-Komponenten
cordova-plugin-mfp
Das Plug-in cordova-plugin-mfp ist das zentrale MobileFirst-Plug-in für Cordova und ein erforderliches Plug-in. Wenn Sie eines der anderen MobileFirst-Plug-ins installieren, wird das Plug-in cordova-plugin-mfp automatisch mitinstalliert, sofern es noch nicht installiert ist.
Die folgenden Cordova-Plug-ins werden als Abhängigkeiten von cordova-plugin-mfp installiert:
- cordova-plugin-device
- cordova-plugin-dialogs
- cordova-plugin-globalization
- cordova-plugin-okhttp
cordova-plugin-mfp-jsonstore
Das Plug-in cordova-plugin-mfp-jsonstore ermöglicht Ihrer App die Verwendung von JSONstore. Weitere Informationen zu JSONStore enthält das Lernprogramm JSONStore.
cordova-plugin-mfp-push
Das Plug-in cordova-plugin-mfp-push stellt die Berechtigungen bereit, die für Android-Anwendungen erforderlich sind, um Push-Benachrichtigungen von MobileFirst Server erhalten zu können. Für die Verwendung von Push-Benachrichtigungen ist ein zusätzliches Setup erforderlich. Weitere Informationen zu Push-Benachrichtigungen enthält das Lernprogramm zu Push-Benachrichtigungen.
cordova-plugin-mfp-fips
Das Plug-in cordova-plugin-mfp-fips stellt FIPS-140-2-Unterstützung für die Android-Plattform bereit. Weitere Informationen enthält der Artikel Unterstützung für FIPS 140-2.
cordova-plugin-mfp-encrypt-utils
Das Plug-in cordova-plugin-mfp-encrypt-utils stellt iOS-OpenSSL-Frameworks für die Verschlüsselung von Cordova-Anwendungen auf der iOS-Plattform bereit. Weitere Informationen finden Sie unter OpenSSL für Cordova iOS aktivieren.
Voraussetzungen:
- Ionic CLI und die MobileFirst CLI sind auf der Entwicklerworkstation installiert.
- Eine lokale oder ferne Instanz von MobileFirst Server ist aktiv.
- Sie haben die Lernprogramme MobileFirst-Entwicklungsumgebung einrichten und Cordova-Entwicklungsumgebung einrichten durchgearbeitet.
- Für Cordova für Windows muss eine Version von Visual C++ installiert sein, die mit den auf der Maschine installierten Versionen von Visual Studio und .NET kompatibel ist.
- Im Falle von Visual-Studio-Tools für universelle Windows-Apps müssen Sie sicherstellen, dass erstellte Cordova-Windows-Anwendungen über alle erforderlichen unterstützenden Bibliotheken verfügen.
Mobile Foundation-Ionic-SDK hinzufügen
Folgen Sie den nachstehenden Anweisungen, um das Ionic-SDK der Mobile Foundation zu einem neuen oder vorhandenen Ionic-Projekt hinzuzufügen und bei MobileFirst Server zu registrieren.
Vergewissern Sie sich als Erstes, dass der MobileFirst Server aktiv
ist.
Wenn Sie einen lokal installierten Server verwenden, navigieren Sie in einem Befehlszeilenfenster zum Serverordner und führen Sie den Befehl ./run.sh
aus.
SDK hinzufügen
Sie können das Projekt mit der MobileFirst-Ionic-Anwendungsschablone erstellen. Die Schablone fügt die erforderlichen MobileFirst-spezifischen Plug-in-Einträge zur Datei config.xml des Ionic-Projekts hinzu und stellt eine einsatzbereite MobileFirst-spezifische Datei index.js bereit, die für die MobileFirst-Anwendungsentwicklung konzipiert ist.
Neue Anwendung
-
Erstellen Sie mit folgendem Befehl ein Ionic-Projekt:
ionic start Projektname Starter-Schablone
.
Beispiel:ionic start Hello blank
- “Hello” ist der Ordnername und der Name der Anwendung.
- “blank” ist der Name der Starter-Schablone.
Mit der von der Schablone bereitgestellten Datei index.js können Sie zusätzliche MobileFirst-Features verwenden, z. B. die Anwendungsübersetzung in mehrere Sprachen und Initialisierungsoptionen. (Weitere Informationen finden Sie in der Benutzerdokumentation.)
-
Navigieren Sie mit
cd hello
zum Stammverzeichnis des Ionic-Projekts. -
Fügen Sie die MobileFirst-Plug-ins mit dem folgenden Ionic-CLI-Befehl hinzu:
ionic cordova plugin add Cordova-Plug-in-Name
. Beispiel:ionic cordova plugin add cordova-plugin-mfp
Mit dem obigen Befehl wird das zentrale MobileFirst-SDK-Plug-in zum Ionic-Projekt hinzugefügt.
-
Fügen Sie mindestens eine unterstützte Plattform zum Cordova-Projekt hinzu. Verwenden Sie dazu den Ionic-CLI-Befehl
ionic cordova platform add ios|android|windows|browser
. Beispiel:cordova platform add ios
-
Erstellen Sie die Anwendungsressourcen mit dem Befehl
ionic cordova prepare
:ionic cordova prepare
Vorhandene Anwendung
Navigieren Sie zum Stammverzeichnis Ihres vorhandenen Ionic-Projekts und fügen Sie das zentrale MobileFirst-Ionic-Cordova-Plug-in hinzu:
ionic cordova plugin add cordova-plugin-mfp
Die MobileFirst-API-Methoden sind nach dem Laden des MobileFirst-Client-SDK verfügbar. Das Ereignis mfjsloaded
wird aufgerufen.
Anwendung registrieren
-
Öffnen Sie ein Befehlszeilenfenster und navigieren Sie zum Stammverzeichnis des Ionic-Projekts.
-
Registrieren Sie die Anwendung bei MobileFirst Server:
mfpdev app register
- Wenn ein ferner Server verwendet wird, fügen Sie ihn mit dem Befehl
mfpdev server add
hinzu.
- Wenn ein ferner Server verwendet wird, fügen Sie ihn mit dem Befehl
Der CLI-Befehl mfpdev app register
stellt zunächst eine Verbindung zu MobileFirst Server her, um die Anwendung zu registrieren. Anschließend wird die Datei config.xml im Stammverzeichnis des Ionic-Projekts mit Metadaten aktualisiert, die den MobileFirst Server angeben.
Jede Plattform wird in MobileFirst Server als Anwendung registriert.
Tipp: Sie können Anwendungen auch über die MobileFirst Operations Console registrieren:
- Laden Sie die MobileFirst Operations Console.
- Klicken Sie neben Anwendungen auf die Schaltfläche Neu, um eine neue Anwendung zu registrieren. Folgen Sie den angezeigten Anweisungen.
SDK verwenden
Die MobileFirst-API-Methoden sind nach dem Laden des MobileFirst-Client-SDK verfügbar. Das Ereignis mfjsloaded
wird aufgerufen.
Rufen Sie die verschiedenen MobileFirst-API-Methoden erst auf, wenn das Ereignis aufgerufen wurde.
MobileFirst-Ionic-SDK aktualisieren
Wenn Sie das MobileFirst-Ionic-Cordova-SDK auf den neuesten Releasestand bringen möchten, entfernen Sie das Plug-in cordova-plugin-mfp. Führen Sie dazu den Befehl ionic cordova plugin remove cordova-plugin-mfp
aus. Führen Sie dann den Befehl ionic cordova plugin add cordova-plugin-mfp
aus, um das Plug-in wieder hinzuzufügen.
SDK-Releases sind im NPM-Repository für das jeweilige SDK enthalten.
Generierte Artefakte des MobileFirst-Ionic-SDK
config.xml
Die Ionic-Konfigurationsdatei ist eine obligatorische XML-Datei, die Anwendungsmetadaten enthält und im Stammverzeichnis der App gespeichert wird.
Wenn das MobileFirst-Ionic-SDK zum Projekt hinzugefügt wurde, empfängt die von Ionic generierte Datei config.xml neue Elemente, die über den Namespace mfp:
identifiziert werden können. Die hinzugefügten Elemente enthalten Informtionen zu
MobileFirst-Features und zu MobileFirst Server.
Beispiel für zur Datei config.xml hinzugefügte MobileFirst-Einstellungen
<?xml version='1.0'encoding='utf-8'?>
<widget id="..." xmlns:mfp="http://www.ibm.com/mobilefirst/cordova-plugin-mfp">
<mfp:android>
<mfp:sdkChecksum>3563350808</mfp:sdkChecksum>
<mfp:appChecksum>0</mfp:appChecksum>
<mfp:security>
<mfp:testWebResourcesChecksum enabled="false" ignoreFileExtensions="png, jpg, jpeg, gif, mp4, mp3" />
</mfp:security>
</mfp:android>
<mfp:windows>
<mfp:sdkChecksum>3563350808</mfp:sdkChecksum>
<mfp:windows10>
<mfp:sdkChecksum>...</mfp:sdkChecksum>
<mfp:security>
<mfp:testWebResourcesChecksum/>
</mfp:security>
</mfp:windows>
<mfp:platformVersion>8.0.0.00-20151214-1255</mfp:platformVersion>
<mfp:clientCustomInit enabled="false" />
<mfp:server runtime="mfp" url="http://10.0.0.1:9080" />
<mfp:directUpdateAuthenticityPublicKey>the-key</mfp:directUpdateAuthenticityPublicKey>
<mfp:languagePreferences>en</mfp:languagePreferences>
</widget>
Element | Beschreibung | Konfiguration |
widget | Stammelement des Dokuments config.xml. Das Element enthält zwei erforderliche Attribute:
|
|
mfp:platformVersion | Erforderlich. Produktversion, mit der die Anwendung entwickelt wurde | Standardmäßig festgelegt; darf nicht geändert werden |
mfp:directUpdateAuthenticityPublicKey | Optional; wenn Sie das Feature für die Authentizität direkter Aktualisierungen aktivieren, wird das Paket für direkte Aktualisierung während der Implementierung digital signiert. Nachdem der Client das Paket heruntergeladen hat, wird eine Sicherheitsüberprüfung ausgeführt, um die Paketauthentizität zu validieren. Dieser Zeichenfolgewert ist der öffentliche Schlüssel, mit dem die ZIP-Datei für die direkte Aktualisierung authentifiziert wird. | Wird mit dem Befehl mfpdev app config direct_update_authenticity_public_key Schlüsselwert festgelegt |
mfp:languagePreferences | Optional; enthält eine Liste mit Ländereinstellungen für die Anzeige von Systemnachrichten. Die einzelnen Einträge sind jeweils durch ein Komma getrennt. | Wird mit dem Befehl mfpdev app config language_preferences Schlüsselwert festgelegt |
mfp:clientCustomInit | Steuert, wie die Methode WL.Client.init aufgerufen wird. Standardmäßig ist dieses Attribut auf den Wert "false" gesetzt, sodass die Methode WL.Client.init automatisch aufgerufen wird, sobald das MobileFirst-Plug-in initialisiert ist. Setzen Sie dieses Attribut auf den Wert true, wenn der Clientcode explizit steuern soll, wann WL.Client.init aufgerufen wird. |
Wird manuell bearbeitet; Sie können das Attribut enabled auf den Wert true oder false setzen. |
mfp:server | Verbindungsinformationen für die Verbindung zum fernen Server, die der Client standardmäßig für die Kommunikation mit MobileFirst Server verwendet
|
|
mfp:ios | Dieses Element enthält die gesamte, MobileFirst-bezogene Clientanwendungskonfiguration für die iOS-Plattform.
|
|
mfp:android | Dieses Element enthält die gesamte, MobileFirst-bezogene Clientanwendungskonfiguration für die Android-Plattform.
|
|
mfp:windows | Dieses Element enthält die gesamte, MobileFirst-bezogene Clientanwendungskonfiguration für die Windows-Plattform.
|
|
mfp:windows8 | Dieses Element enthält die gesamte, MobileFirst-bezogene Clientanwendungskonfiguration für die Windows-8.1-Plattform.
|
|
mfp:windows10 | Dieses Element enthält die gesamte, MobileFirst-bezogene Clientanwendungskonfiguration für die Windows-10-Plattform.
|
|
mfp:windowsphone8 | Dieses Element enthält die gesamte, MobileFirst-bezogene Clientanwendungskonfiguration für die Windows-Phone-8.1-Plattform.
|
|
mfp:appChecksum | Dieser Wert ist die Kontrollsumme der Anwendungswebressourcen. Er wird bei Ausführung von mfpdev app webupdate berechnet. |
Kann nicht vom Benutzer konfiguiert werden; der Kontrollsummenwert wird bei Ausführung des Befehls mfpdev app webupdate aktualisiert. Wenn Sie weitere Informationen zum Befehl mfpdev app webupdate benötigen, geben Sie im Befehlsfenster mfpdev help app webupdate ein. |
mfp:sdkChecksum | Dieser Wert ist die Kontrollsumme des IBM MobileFirst-Platform-SDK, über die der eindeutige Level des MobileFirst-SDK identifiziert wird. | Kenn nicht vom Benutzer konfiguriert werden; standardmäßig festgelegter Wert |
mfp:security | Dieses Element enthält die plattformspezifische Konfiguration der Clientanwendung für die MobileFirst-Sicherheit. Enthält
|
|
mfp:testWebResourcesChecksum | Steuert, ob die Anwendung die Integrität ihrer Webressourcen bei jedem Start auf dem mobilen Gerät überprüft. Attribute:
|
|
Abschnitt schließen
MobileFirst-Einstellungen in der Datei config.xml bearbeiten
Sie können die MobileFirst CLI verwenden, um mit folgendem Befehl die obigen Einstellungen zu bearbeiten:
mfpdev app config
Nächste Lernprogramme
Jetzt, da das MobileFirst-Ionic-SDK integriert ist, können Sie Folgendes tun:
- Gehen Sie die Lernprogramme zu SDKs der Mobile Foundation durch.
- Gehen Sie die Lernprogramme zur Adapterentwicklung durch.
- Gehen Sie die Lernprogramme zu Authentifizierung und Sicherheit durch.
- Gehen Sie die Lernprogramme zu Benachrichtigungen durch.
- Sehen Sie sich alle Lernprogramme an.
Inclusive terminology note: The Mobile First Platform team is making changes to support the IBM® initiative to replace racially biased and other discriminatory language in our code and content with more inclusive language. While IBM values the use of inclusive language, terms that are outside of IBM's direct influence are sometimes required for the sake of maintaining user understanding. As other industry leaders join IBM in embracing the use of inclusive language, IBM will continue to update the documentation to reflect those changes.