Erste Schritte mit der nativen Android-Entwicklung
Lernziele
Nachdem Sie diese Lektion abgeschlossen haben, sind Sie in der Lage, die folgenden Aufgaben auszuführen:
- Beschreiben von zwei Hauptfunktionen des Mobile SDK für Android
- Installieren des Mobile SDK für Android
- Erstellen einer Android-Anwendung und Angeben von Anwendungsoptionen
- Importieren und Erstellen Ihrer Anwendung in Android Studio
Bevor Sie beginnen: Erstellen einer externen Client-Anwendung
Bevor Sie Schritte in diesem Badge durchführen, sollten Sie unbedingt die praktischen Aufgaben in den Badges Set Up Your Mobile SDK Development Environment (Einrichten Ihrer Mobile SDK-Entwicklungsumgebung) und Salesforce Mobile SDK Basics (Salesforce Mobile SDK – Grundlagen) abschließen und dazu denselben Trailhead Playground oder dieselbe Developer Edition verwenden. Sie können die Aufgaben in diesem Badge nicht abschließen, ohne zuvor Ihre mobile Entwicklungsumgebung einzurichten und in den entsprechenden Badges eine externe Clientanwendung zu erstellen.
Um eine Verbindung mit dem Salesforce-Service herzustellen, benötigt jede mobile Anwendung eine externe Client-Anwendung außerhalb von Salesforce. Eine externe Client-Anwendung berechtigt Ihre Anwendung, mit Salesforce zu kommunizieren und sicher auf Salesforce-APIs zuzugreifen.
Nachdem Sie Ihre externe Client-Anwendung erstellt haben, beachten Sie ihre Details.
- Kopieren Sie die Werte "Rückmeldungs-URL" und "Verbraucherschlüssel". Diese Werte nutzen Sie zum Einrichten der Authentifizierung in Ihrer Anwendung.
- Das Verbrauchergeheimnis wird von Mobile SDK-Anwendungen nicht verwendet. Sie können diesen Wert daher ignorieren.
Native Android-Entwicklung
Das Mobile SDK für Android bietet Ihnen alle Tools und Ressourcen, die Sie brauchen, um Salesforce-fähige Anwendungen für eine der beliebtesten mobilen Plattform weltweit zu entwickeln. In diesem Badge werden die grundlegenden Funktionen des nativen SDK für Android behandelt.
- Automatisierung des OAuth2-Authentifizierungs-Flows, um eine Integration des Prozesses in Ihre Anwendung zu erleichtern.
- Zugriff auf die Salesforce REST-API mit Dienstprogrammklassen, die den Zugriff vereinfachen.
Auf geht's! Denken Sie daran: Sie müssen das Projekt Einrichten Ihrer Mobile SDK-Entwicklungsumgebung sowie den Badge Salesforce Mobile SDK – Grundlagen abschließen, bevor Sie mit dieser Lektion fortfahren. Falls Sie das noch nicht getan haben, holen Sie das jetzt kurz nach. Im Anschluss können Sie beginnen, eine einfache native Android-Anwendung zu erstellen. Nach einem kurzen Blick unter die Haube passen Sie Ihre Android-Entwicklungsfunktionen individuell an, indem Sie die REST-Interaktionen der Anwendung und die Benutzeroberfläche bearbeiten.
Erstellen eines Android-Projekts
Nachdem Sie Ihre Android-Entwicklungsumgebung eingerichtet und eine Client-Anwendung außerhalb von Salesforce erstellt haben, sind Sie bereit, Ihre erste forcedroid-Anwendung zu erstellen.
- Wechseln Sie an der Eingabeaufforderung in das Verzeichnis, in dem das Projekt gespeichert werden soll, und geben Sie Folgendes ein:
forcedroid create - Geben Sie bei den forcedroid-Eingabeaufforderungen die folgenden Werte ein:
-
Anwendungsname: MyTrailNative
-
Paketname: com.mytrail.android
-
-
Ausgabeverzeichnis: TrailAndroidApps
-
OAuth consumer key (OAuth-Verbraucherschlüssel): YOUR_CONSUMER_KEY
-
OAuth callback URL (OAuth-Callback-URL): YOUR_CALLBACK_URL
-
Login server URL (Anmeldeserver-URL): https://login.salesforce.com
Nach mehreren Protokollmeldungen wird eine Glückwunschmeldung angezeigt und Sie kehren zur Eingabeaufforderung zurück. Herzlichen Glückwunsch! Ihre neue Anwendung kann jetzt ausgeführt werden.
Ausführen Ihrer neuen Android-Anwendung
Das von forcedroid erzeugte Projekt kann nun sofort ausgeführt werden. Viel passiert da noch nicht – es wird eine einfache SOQL-Abfrage ausgeführt und eine Tabelle mit Namen angezeigt. Aber zumindest wissen Sie jetzt, dass die Infrastruktur steht und auf Ihre Befehle wartet. Sehen wir uns an, wie sie funktioniert.
- Starten Sie Android Studio.
- Wählen Sie File (Datei) | New (Neu) | Import Project (Projekt importieren) aus.
- Wechseln Sie zu Ihrem Zielverzeichnis, TrailAndroidApps, und klicken Sie auf OK.
Android Studio erstellt automatisch Ihre Arbeitsumgebung. Dieser Vorgang kann einige Minuten dauern. Wenn in der Statusleiste die Meldung "Gradle build successful" angezeigt wird, können Sie das Projekt ausführen.
- Klicken Sie auf Run (Ausführen) | Run app (Anwendung ausführen) oder drücken Sie UMSCHALTTASTE+F10 ((Windows) bzw. ^R (Mac).
- Wählen Sie einen Emulator oder ein verbundenes Gerät aus, auf dem Android 12 (API 31) oder höher ausgeführt wird.
Android Studio startet Ihre Anwendung im Emulator oder angeschlossenen Android-Gerät.
Ressourcen
- Salesforce Developer Guide: Android Preparation (in englischer Sprache)
- GitHub: Android SDK für Salesforce Mobile
