Compréhension des applications Forcedroid

Votre classe d’application effectue deux tâches principales :

• Remplace la méthode Android Application.onCreate ().
• Dans le remplacement de onCreate () :
  • appelle la méthode de la super-classe onCreate ().
  • Initialise le kit de développement mobile Salesforce en appelant initNative () sur l’objet de gestionnaire du kit de développement (MobileSyncSDKManager).
  • fournit du code commenté facultatif que vous pouvez rétablir pour utiliser votre application en tant que fournisseur d’identité Salesforce ;
  • fournit du code commenté facultatif que vous pouvez rétablir pour prendre en charge les notifications automatiques.

La classe MainApplication est très simple. Elle définit un remplacement d’une méthode de classe de base unique, onCreate(). Quelles sont les autres fonctions du remplacement ? Il appelle la méthode OnCreate() de la super classe, puis initialise l’objet singleton 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);
	}
}

Fort heureusement, forcedroid est suffisamment intelligente, votre classe MainActivity peut étendre SalesforceActivity. C’est une chance, car de nombreuses actions sont ainsi automatiquement exécutées pour vous. Par exemple, SalesforceActivity interrompt et reprend automatiquement les événements, y compris les nouvelles saisies de code secret si nécessaire. Si vous aviez utilisé à la place la classe de base d’activité non-Salesforce (stratégie pas interdite, mais pas non plus recommandée), vous auriez dû écrire le code vous-même. Vous pouvez définir autant de classes d’activité que votre application l’exige. Cependant, pour chaque activité, il est préférable d’étendre une classe de base du kit de développement Mobile SDK, telle que SalesforceActivity ou SalesforceListActivity.

La classe MainActivity se charge d’envoyer une requête REST à Salesforce, puis de traiter la réponse. Elle utilise les enregistrements qu’elle reçoit de Salesforce pour renseigner une vue de liste. Elle fournit également deux boutons qui permettent à l’utilisateur d’interroger les Comptes ou bien les Contacts, un bouton pour effacer l’affichage de l’enregistrement et un autre pour se déconnecter.

<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"
    ...

De plus, chaque activité que vous ou forcedroid définissez a une description ici. Par exemple, ici le nœud unique application/activity représente la première activité qui s’affiche après la connexion. Comme vous pouvez le constater, la propriété android:name de l’activité référence le nom de classe de votre activité principale. Voici le fragment XML application/activity d’un fichier AndroidManifest.xml 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>

Toutes les autres informations du fichier manifest par défaut correspondent à la configuration Android standard. Comme avec n’importe quelle application Android, vous pouvez ajouter les propres composants de votre application au nœud <application>, notamment les activités personnalisées, les services et les récepteurs.

Vous avez découvert ce que contient une application forcedroid. Examinons maintenant les informations que vous êtes impatient de connaître : comment accéder aux données Salesforce.