このページは Cloud Translation API によって翻訳されました。

Parcelable と Bundle

Parcelable オブジェクトと Bundle オブジェクトは、 IPC/Binder など、プロセスの境界を越えて使用トランザクション、インテントとアクティビティ間のトランザクション、構成全体での一時的な状態の保存などの機能を利用できます。できます。このページでは、Terraform の使用に関する推奨事項とベストプラクティスについて説明します。 Parcelable オブジェクトと Bundle オブジェクト。

注: Parcel は汎用ではありません。シリアライゼーションメカニズムであるため、 Parcel データをディスクに保存するか、ネットワーク経由で送信します。

アクティビティ間でデータを送信する

アプリが Cloud Storage で使用する Intent オブジェクトを新しい Activity を開始する際に startActivity(android.content.Intent) アプリはパラメータ（putExtra(java.lang.String, java.lang.String) を使用）メソッドを呼び出します。

次のコードスニペットに、この処理を実行する方法の例を示します。

Kotlin

val intent = Intent(this, MyActivity::class.java).apply {
    putExtra("media_id", "a1b2c3")
    // ...
}
startActivity(intent)

Java

Intent intent = new Intent(this, MyActivity.class);
intent.putExtra("media_id", "a1b2c3");
// ...
startActivity(intent);

OS は、インテントの基となる Bundle をパーセル化します。その後、OS は新しいアクティビティデータのパーセルを解除し、インテントを新しいアクティビティに渡します。

Bundle クラスを使用して、OS が認識しているプリミティブを設定することをおすすめします。 Intent オブジェクト。Bundle クラスは、パーセルを使用したマーシャリングとアンマーシャリングに最適化されています。

場合によっては、複合オブジェクトまたは複合オブジェクトをアクティビティ間で送信するメカニズムが必要になることがあります。このような場合、カスタムクラスで Parcelable を実装し、 writeToParcel(android.os.Parcel, int) メソッドを使用します。また、null ではない CREATOR フィールドも用意する必要があります。 Parcelable.Creator インターフェースを実装します。このインターフェース createFromParcel() メソッドは、Parcel を現在のオブジェクトに戻すために使用されます。詳しくは Parcelable オブジェクトのリファレンスドキュメントをご覧ください。

インテントを介してデータを送信する場合は、データサイズを数 KB に制限するよう注意する必要があります。送信するデータが多すぎると、システムから TransactionTooLargeException 例外。

プロセス間でデータを送信する

プロセス間でデータを送信する方法は、アクティビティ間で行う方法と似ています。ただし、カスタム Parcelable は使用しないことをおすすめします。カスタムの Parcelable オブジェクトをアプリから別のアプリに転送するには、そのアプリがカスタムクラスとまったく同じバージョンの送信側のアプリと受信側のアプリの両方に存在します。通常、これは共通ライブラリ使用しています。アプリがカスタム Parcelable をこれは、システムが認識していないクラスをアンマーシャリングできないためです。

たとえば、アプリでのアラームの設定には、 AlarmManager クラスを使用し、カスタムの Parcelable を使用する定義しますアラームが鳴ると、システムはインテントの追加する特典の Bundle 繰り返し回数を表します。この変更により、システムでカスタムバックエンドが削除され、エクストラの Parcelable。その結果、アプリの変更されたアラームインテントを受け取ると、アプリがクラッシュする存在しないデータを受信できます

Binder トランザクションバッファには、現在 1 MB の固定サイズが限られており、処理中のトランザクションを検出できますこのプロセスでは場合、これらのトランザクションには、すべてのバインダートランザクションが onSaveInstanceState、startActivity、システムとのやり取りなどのアプリに関する操作。サイズが制限を超えると、TransactionTooLargeException がスローされます。

savedInstanceState の特定のケースでは、データの量を小さくする必要があります。これは、提供されたデータを、ユーザーがそのアクティビティに戻ることができる（アクティビティのプロセスが強制終了された場合でも）保存済み状態は 5 万未満のデータに保つことをおすすめします。

注: Android 7.0（API レベル 24）以降では、システムは TransactionTooLargeException がランタイム例外として発生しました。それより前のバージョンの Android では、logcat に警告のみが表示されます。