forcedroid アプリケーションについて

アプリケーションクラスは、次の 2 つの主要なタスクを実行します。

• Android Application.onCreate() メソッドを上書きします。
• onCreate() 上書きで次を実行します。
  • スーパークラス onCreate() メソッドをコールする。
  • SDK マネージャーオブジェクトクト (MobileSyncSDKManager) で initNative() をコールして Salesforce Mobile SDK を初期化する。
  • 元に戻すことができるコメント付きコードを必要に応じて提供し、アプリケーションを Salesforce ID プロバイダーとして使用する。
  • 元に戻すことができるコメント付きコードを必要に応じて提供し、プッシュ通知をサポートする。

MainApplication クラスは非常にシンプルで、1 つの基本クラスメソッド onCreate() の上書きを定義します。この上書きは何をするものなのでしょうか? スーパークラス OnCreate() メソッドをコールしてから、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);
	}
}

幸いにも、forcedroid は優れていて、MainActivity クラスが SalesforceActivity を拡張できます。つまり、無償で多くの便利なものを手に入れることができることになります。たとえば、SalesforceActivity は自動的に一時停止および再開イベントを処理し、必要なパスコードも再入力されます。Salesforce 以外のアクティビティ基本クラスを使用している場合 (この方法は禁止されているわけではありませんが、お勧めしません)、自分でそのコードを記述することになります。アクティビティクラスは、アプリケーションに必要なだけ定義できます。ただし、すべてのアクティビティで SalesforceActivity や SalesforceListActivity などの Mobile SDK 基本クラスを拡張することをお勧めします。

MainActivity クラスは、Salesforce に REST クエリを送信し、応答を処理します。また、Salesforce から受信したレコードを使用してリストビューに入力します。さらに、ユーザーが取引先責任者または取引先へのクエリを選択できる 2 つのボタンと、レコード表示をクリアするボタン、ログアウトするボタンを表示します。

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

また、ユーザーまたは forcedroid によって定義されたすべてのアクティビティもここで説明されます。たとえば、この場合、単独の application/activity ノードはログイン後の最初のアクティビティを表します。ご覧のとおり、アクティビティの android:name プロパティはメインアクティビティのクラス名を参照します。forcedroid の AndroidManifest.xml ファイルの application/activity XML フラグメントを次に示します。

<!-- 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>

デフォルトのマニフェストファイルの他の部分はすべて標準の Android 設定です。他の Android アプリケーションと同様に、アプリケーション独自のコンポーネント (カスタムアクティビティ、サービス、レシーバーなど) を <application> ノードに追加できます。

forcedroid アプリケーションの内容を学習したので、次は、お待ちかねの Salesforce データへのアクセス方法に進みましょう。