Grundlegendes zu Forcedroid-Anwendungen

Ihre Anwendungsklasse erledigt zwei Hauptaufgaben:

• Sie überschreibt die Android Application.onCreate()-Methode.
• In ihrer onCreate()-Überschreibung geschieht Folgendes:
  • Die onCreate()-Methode der Superklasse wird aufgerufen.
  • Das Salesforce Mobile SDK wird durch Aufrufen von initNative() für das SDK-Manager-Objekt (MobileSyncSDKManager) initialisiert.
  • Es wird optionaler, kommentierter Code bereitgestellt, den Sie neu instanziieren können, um Ihre Anwendung als Salesforce-Identitätsanbieter zu nutzen.
  • Es wird optionaler, kommentierter Code bereitgestellt, den Sie neu instanziieren können, um Push-Benachrichtigungen zu unterstützen.

Die Klasse MainApplication ist ziemlich einfach. Sie definiert eine Überschreibung einer Single-Base-Klassenmethode, onCreate(). Was macht die Überschreibung? Sie ruft die OnCreate()-Methode der übergeordneten Klasse auf und initialisiert dann das Singleton-Objekt MobileSyncSDKManager.

/**
 * Application class for our application.
 */
public class MainApplication extends Application {

	@Override
	public void onCreate() {
		super.onCreate();
		MobileSyncSDKManager.initNative(getApplicationContext(), MainActivity.class);

              /*
               * Uncomment the following line to enable IDP login flow. This will allow the user to
               * either authenticate using the current app or use a designated IDP app for login.
               * Replace 'idpAppURIScheme' with the URI scheme of the IDP app meant to be used.
               */
		// MobileSyncSDKManager.getInstance().setIDPAppURIScheme(idpAppURIScheme);

		/*
		 * Un-comment the line below to enable push notifications in this app.
		 * Replace 'pnInterface' with your implementation of 'PushNotificationInterface'.
		 * Add your Google package ID in 'bootonfig.xml', as the value
		 * for the key 'androidPushNotificationClientId'.
		 */
		// SalesforceSDKManager.getInstance().setPushNotificationReceiver(pnInterface);
	}
}

Glücklicherweis ist forcedroid intelligent genug, Ihre MainActivity-Klasse dazu zu bringen, SalesforceActivity zu erweitern. Dieses kleine Glück bedeutet, dass Sie viele abgefahrene Dinge gratis bekommen. So verarbeitet z. B. SalesforceActivity automatisch Ereignisse zum Anhalten und Fortsetzen, einschließlich aller erforderlichen Neueingaben des Zugangscodes. Wenn Sie stattdessen die eine oder andere nicht auf Salesforce-Aktivitäten basierende Klasse verwendet hätten (keine unzulässige Strategie, aber auch nicht empfehlenswert), würden Sie diesen Code selber schreiben. Sie können so viele Aktivitätsklassen definieren wie Ihre Anwendung erfordert. Es ist jedoch ratsam, für jede Aktivität eine Mobile SDK-Basisklasse wie SalesforceActivity oder SalesforceListActivity zu erweitern.

Die MainActivity-Klasse ist meistens damit beschäftigt, eine REST-Abfrage an Salesforce zu senden und dann die Antwort zu verarbeiten. Sie nutzt die Datensätze, die sie von Salesforce erhält, um eine Listenansicht aufzufüllen. Außerdem bietet sie zwei Schaltflächen, über die der Benutzer wahlweise Accounts oder Kontakte abfragen kann, sowie eine Schaltfläche zum Löschen der Datensatzanzeige und eine weitere zum Abmelden.

<include layout="@layout/header" />

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.mytrail.android"
    android:versionCode="1"
    android:versionName="1.0"
    android:installLocation="internalOnly">

<application android:icon="@drawable/sf__icon"
    android:label="MyTrailNative"
    android:name=".MainApplication"
    ...

Außerdem erhält hier jede Aktivität, die Sie oder forcedroid definieren, eine Beschreibung. Beispielsweise stellt allein der Knoten application/activity in diesem Fall die erste Aktivität dar, die nach der Anmeldung erscheint. Wie Sie sehen, verweist die Eigenschaft android:name der Aktivität auf den Klassennamen Ihrer Hauptaktivität. Hier ist das XML-Fragment application/activity aus einer Datei AndroidManifest.xml in forcedroid.

<!-- Launcher screen -->
<activity android:name=".MainActivity"
    android:label="@string/app_name"
	android:theme="@android:style/Theme.NoTitleBar.Fullscreen">
	<intent-filter>
		<action android:name="android.intent.action.MAIN" />
		<category android:name="android.intent.category.LAUNCHER" />
	</intent-filter>
</activity>

Alles andere, was Sie in der Standard-Manifestdatei sehen, gehört zur Android-Standardkonfiguration. Wie bei jeder Android-Anwendung können Sie dem Knoten <application> die eigenen Komponenten Ihrer Anwendung, wie beispielsweise benutzerdefinierte Aktivitäten, Services und Empfänger, hinzufügen.

Sie haben nun gelernt, wie es im Inneren einer forcedroid-Anwendung aussieht. Kommen wir also zu der Info, auf die Sie gewartet haben: nämlich, wie Sie auf die Salesforce-Daten zugreifen.