Comprender las aplicaciones forcedroid

Su clase de aplicación realiza dos tareas principales:

• Sustituye el método Application.onCreate() de Android.
• En su onCreate() sustituye:
  • Llamadas al método onCreate() de superclase.
  • Inicializa Salesforce Mobile SDK llamando a initNative() en el gestor de objetos del SDK (MobileSyncSDKManager).
  • Proporciona el código comentado opcional que puede reutilizar para emplear su aplicación como un proveedor de identidad de Salesforce.
  • Proporciona código comentado opcional que puede reutilizar para admitir notificaciones distribuidas.

La clase MainApplication es bastante sencilla. Define una sustitución de un método de clase de base única, en este caso onCreate(). ¿Qué hace la sustitución? Llama al método de superclase OnCreate() y, a continuación, inicializa el objeto de 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);
	}
}

Por suerte, forcedroid es lo bastante inteligente para que la clase MainActivity extienda SalesforceActivity. Esta buena suerte significa que puede lograr cosas increíbles de forma gratuita. Por ejemplo, SalesforceActivity controla automáticamente la pausa y reanudación de eventos, lo que incluye volver a ingresar el código de aprobación necesario. Si en lugar de esto, hubiera usado una clase base de actividad no proporcionada por Salesforce (lo cual no es un método prohibido, aunque no se recomienda), tendría que escribir el código. Puede definir tantas clases de actividad como requiera la aplicación. No obstante, es una buena idea para cada actividad extender una clase base de Mobile SDK, como SalesforceActivity o SalesforceListActivity.

La clase MainActivity está ocupada con el envío de una solicitud REST a Salesforce y el procesamiento de la respuesta. Usa los registros que recibe de Salesforce para completar una vista de lista. Además, proporciona dos botones que permiten al usuario elegir entre la consulta de cuentas o contactos además de un botón para borrar la pantalla de registros y otro botón para cerrar sesión.

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

Además, se asigna una descripción a cada actividad definida por usted o forcedroid. Por ejemplo, tan solo el nodo application/activity en este caso representa la primera actividad que se muestra después del inicio de sesión. Como puede ver, la propiedad android:name de la actividad hace referencia al nombre de clase de su actividad principal. Este es el fragmento XML de application/activity de un archivo AndroidManifest.xml de 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>

Aparte de esto, todo lo que vea en el archivo de manifiesto predeterminado es la configuración de Android estándar. Al igual que con cualquier aplicación Android, puede agregar los componentes propios de su aplicación al nodo <application>, como actividades, servicios y receptores.

Ahora que ya sabe lo que incluye una aplicación forcedroid, vamos a continuar con la información que estaba esperando: cómo acceder a los datos de Salesforce.