MobileFirst-CLI in Eclipse verwenden

Übersicht

Mit der Cordova-CLI können Sie Ihre Cordova-Anwendungen erstellen und verwalten. Für denselben Zweck können Sie die Eclipse-IDE nutzen. Verwenden Sie in dem Fall das Plug-in THyM.

THyM bietet Unterstützung für den Import und die Verwaltung von Cordova-Projekten in Eclipse. Sie können sowohl neue Cordova-Projekte erstellen als auch vorhandene Cordova-Projekte importieren. Über das genannte Plug-in können Sie zudem Cordova-Plug-ins in Ihrem Projekt installieren.

Machen Sie sich auf der offiziellen Website mit THyM vertraut.

Das MobileFirst-Studio-Plug-in für Eclipse macht MobileFirst-Befehle in der Eclipse-IDE verfügbar. Namentlich werden die folgenden Befehle bereitgestellt: Open Server Console, Preview App, Register App, Encrypt App, Pull App, Push App, Update App.

In diesem Lernprogramm werden wir uns mit der Installation des Plug-ins THyM und des MobileFirst-Eclipse-Plug-ins beschäftigen.

Voraussetzungen:

• MobileFirst Server wird lokal oder fern ausgeführt.
• Die MobileFirst CLI ist auf der Entwicklerworkstation installiert.

Fahren Sie mit folgenden Abschnitten fort:

• MobileFirst-Plug-in installieren
• Plug-in THyM installieren
• Cordova-Projekt erstellen
• Vorhandenes Cordova-Projekt importieren
• MobileFirst-SDK zu einem Cordova-Projekt hinzufügen
• MobileFirst-Befehle
• Tipps und Tricks

MobileFirst-Plug-in installieren

1. Klicken Sie in Eclipse auf Hilfe → Eclipse Marketplace…
2. Suchen Sie nach “MobileFirst” und klicken Sie auf “Go”.

3. Klicken Sie auf “Install”.

   

4. Schließen Sie den Installationsprozess ab.
5. Starten Sie Eclipse neu, damit die Installation wirksam wird.

Plug-in THyM installieren

Hinweis: Wenn Sie THyM ausführen möchten, müssen Sie mit Eclipse Mars oder einer neueren Eclipse-Version arbeiten.

1. Klicken Sie in Eclipse auf Hilfe → Eclipse Marketplace…
2. Suchen Sie nach “thym” und klicken Sie auf “Go”.

3. Klicken Sie für “Eclipse Thym” auf “Install”.

   

4. Schließen Sie den Installationsprozess ab.
5. Starten Sie Eclipse neu, damit die Installation wirksam wird.

Cordova-Projekt erstellen

In diesem Abschnitt geht es um die Ertellung eines neuen Cordova-Projekts unter Verwendung von THyM.

1. Klicken Sie in Eclipse auf Datei → Neu → Andere…

2. Grenzen Sie die Optionen ein, indem Sie nach “Cordova” suchen. Wählen Sie unter Mobile den Eintrag Hybrid Mobile (Cordova) Application Project aus und klicken Sie auf Next.

   

3. Benennen Sie das Projekt und klicken Sie auf Next.

   

4. Fügen Sie die gewünschte Plattform zu Ihrem Projekt hinzu und klicken Sie auf Finish.

Hinweis: Wenn Sie nach der Erstellung zusätzliche Plattformen benötigen, lesen Sie die Informationen unter Plattformen hinzufügen.

Vorhandenes Cordova-Projekt importieren

In diesem Abschnitt geht es um den Import eines vorhandenen Cordova-Projekts, das unter Verwendung der Cordova-CLI erstellt wurde.

1. Klicken Sie in Eclipse auf Datei → Importieren…
2. Wählen Sie unter Mobile den Eintrag Cordova-Projekt importieren aus und klicken Sie auf Weiter >.
3. Klicken Sie auf Durchsuchen… und wählen Sie das Stammverzeichnis des vorhandenen Cordova-Projekts aus.
4. Vergewissern Sie sich, dass das Projekt im Abschnitt “Projekte:” markiert ist. Klicken Sie dann auf Fertigstellen.

Wenn Sie ein Projekt ohne Plattformen importieren, wird der folgende Fehler angezeigt. Im Abschnitt Plattformen hinzufügen erfahren Sie, wie dieser Fehler behoben wird.

Hinweis: Wenn Sie nach einem Import zusätzliche Plattformen benötigen, lesen Sie die Informationen unter Plattformen hinzufügen.

MobileFirst-SDK zu einem Cordova-Projekt hinzufügen

Wenn Sie THyM und das MobileFirst-Studio-Plug-in in Eclipse installiert und ein Cordova-Projekt erstellt oder importiert haben, können Sie die folgenden Schritte ausführen, um mit dem Cordova-Plug-in das MobileFirst-SDK zu installieren.

1. Klicken Sie im Projektexplorer mit der rechten Maustaste auf den Ordner plugins und wählen Sie Install Cordova Plug-in aus.

2. Suchen Sie im angezeigten Dialogfenster auf der Registerkarte “Registry” nach mfp und wählen Sie cordova-plugin-mfp aus. Klicken Sie dann auf Finish.

   

MobileFirst-Befehle

Für den Zugriff auf die Direktaufrufe der Mobile Foundation klicken Sie mit der rechten Maustaste auf das Projektstammverzeichnis und navigieren Sie zu IBM MobileFirst Foundation.

Die folgenden Befehle stehen zur Auswahl:

Tipps und Tricks

Externe IDEs

Wenn Sie Tests oder Implementierungen auf einem Gerät über eine externe IDE (Android Studio oder Xcode) ausführen möchten, verwenden Sie das Kontextmenü.

Hinweis: Sie müssen Ihr Projekt manuell in Android Studio impotieren, um die Gradle-Konfiguration zu definieren, bevor Sie das Projekt in Eclipse starten. Tun Sie dies nicht, können unnötige Schritte erforderlich sein oder Fehler auftreten. Wählen Sie in Android Studio Import project (Eclipse ADT Gradle, etc.) aus und navigieren Sie zu Ihrem Projekt. Wählen Sie im Ordner platforms das Verzeichnis android aus.

Klicken Sie im Eclipse-Projektexplorer mit der rechten Maustaste auf die gewünschte Plattform (d. h. android oder ios im Ordner platforms). Bewegen Sie den Mauszeiger im Kontextmenü auf Ausführen als und wählen Sie die entsprechende externe IDE aus.

Plattformen hinzufügen

Das Hinzufügen weiterer Plattformen ist ein einfacher Prozess, der im Plug-in THyM nicht intuitiv ist. Es gibt daher die beiden folgenden zusätzlichen Möglichkeiten, Plattformen hinzufügen:

1. Mithilfe von Eigenschaften
   1. Klicken Sie mit der rechten Maustaste auf das Projekt und wählen Sie im Kontextmenü Eigenschaften aus.
   2. Im daraufhin erscheinenden Dialogfenster müssen Sie im linken Menü Hybrid Mobile Engine auswählen.
   3. Nun erscheint ein Fenster, in dem Sie die gewünschten Plattformen auswählen oder herunterladen können.
2. Mithilfe eines Terminals
   1. Klicken Sie mit der rechten Maustaste auf Ihr Projekt und bewegen Sie den Mauszeiger auf Anzeigen in. Wählen Sie im Kontextmenü Terminal aus.
   2. Nun müssten Sie neben der Konsole in Eclipse eine neue Registerkarte sehen.
   3. Auf dieser Registerkarte können Sie Cordova-CLI-Befehle ausführen, um manuell Plattformen hinzuzufügen.
      • Mit cordova platform ls können Sie die installierten und verfügbaren Plattformen auflisten.
      • Mit cordova platform add <Plattform> wird die angegebene Plattform zum Projekt hinzugefügt. Hier steht ** für die gewünschte Plattform.
      • Informationen zu plattformspezifischen Cordova-Befehlen finden Sie in der Dokumentation Cordova platform command.

Debugmodus

Wenn Sie den Debugmodus aktivieren und in einem Browser die Anwendungsvorschau anzeigen, werden in der Eclipse-Konsole Protokolle mit Debugstufe angezeigt. Gehen Sie zum Aktivieren des Debugmodus wie folgt vor:

1. Öffnen Sie die Eclipse-Benutzervorgaben.
2. Wählen Sie MobileFirst-Studio-Plug-ins aus, um die Seite mit den Plug-in-Vorgaben anzuzeigen.
3. Vergewissern Sie sich, dass das Kontrollkästchen Debugmodus aktivieren ausgewählt ist. Klicken Sie dann auf Anwenden → OK.

Liveaktualisierung

Während einer Anwendungsvorschau ist die Liveaktualisierung der Anwendung möglich. Sie können Aktualisierungen vornehmen, Ihre Änderungen speichern und sie in der Vorschau sehen, nachdem Sie die Anzeige aktualisiert haben.

MobileFirst Server in Eclipse integrieren

Sie können das MobileFirst Developer Kit nutzen, um die obigen Schritte mit der Ausführung von MobileFirst Server in Eclipse zu verbinden und so eine integrierte Entwicklungsumgebung erzeugen.

Demo-Video