Compreender aplicativos forcedroid

Sua classe application conclui duas tarefas principais:

• Substitui o método Application.onCreate() do Android.
• Em sua substituição onCreate():
  • Chama o método onCreate() da superclasse.
  • Inicializa Salesforce Mobile SDK chamando initNative() no objeto do SDK Manager (MobileSyncSDKManager).
  • Fornece código comentado opcional que você pode restaurar para utilizar seu aplicativo como um provedor de identidade do Salesforce.
  • Fornece código comentado opcional que você pode restaurar para dar suporte a notificações por push.

A classe MainApplication é muito simples. Ela define uma substituição de um único método de classe base, onCreate(). O que essa substituição faz? Ela chama o método de superclasse OnCreate() e inicializa o objeto 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 sorte, o forcedroid é inteligente o suficiente para fazer com que a classe MainActivity estenda SalesforceActivity. Isso significa que você recebe várias coisas interessantes de graça. Por exemplo, SalesforceActivity trata eventos de pausa e retomada automaticamente, inclusive novas inserções de senha necessárias. Se você usou alguma classe base de atividade que não é do Salesforce, o que não é proibido, mas também não é recomendado, terá que escrever esse código por conta própria. Você pode definir quantas classes de atividade forem necessárias para seu aplicativo. No entanto, é bom que cada atividade estenda uma classe base do Mobile SDK, como SalesforceActivity ou SalesforceListActivity.

A classe MainActivity se ocupa com o envio de uma consulta REST para o Salesforce e o processamento da resposta. Ela usa os registros recebidos do Salesforce para preencher um modo de exibição de lista. Ela também cria dois botões que permitem ao usuário optar por consultar Contas ou Contatos, além de um botão para limpar a exibição do registro e outro para fazer o logout.

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

Além disso, todas as atividades definidas por você ou pelo forcedroid ganham uma descrição aqui. Por exemplo, o nó único application/activity nesse caso representa a primeira atividade que aparece após o login. Como pode ver, a propriedade android:name da atividade faz referência ao nome de classe da sua atividade principal. Eis o fragmento XML application/activity de um arquivo AndroidManifest.xml do 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>

Todas as outras coisas que aparecem no arquivo de manifesto padrão são configurações padrão do Android. Assim como acontece com qualquer aplicativo Android, você pode adicionar os próprios componentes do seu aplicativo ao nó <application>, como atividades, serviços e receptores personalizados.

Agora que você aprendeu o que é um aplicativo forcedroid, vamos prosseguir com as informações que você tanto esperava: como acessar dados do Salesforce.