MemoryBudgetManager クラス

定義

[Android.Runtime.Register("android/app/MemoryBudgetManager", ApiSince=37, DoNotGenerateAcw=true)]
public sealed class MemoryBudgetManager : Java.Lang.Object

[<Android.Runtime.Register("android/app/MemoryBudgetManager", ApiSince=37, DoNotGenerateAcw=true)>]
type MemoryBudgetManager = class
    inherit Object

継承

Object

JavaObject

Object

MemoryBudgetManager

属性

RegisterAttribute

注釈

このクラスは、アプリケーションとプロセスのメモリ予算に対するクライアント インターフェイスです。 メモリの予算は、アプリケーションまたはそのプロセスの 1 つによって、そのメモリ要件が一部の制限を超えないという約束です。 予算はハード制限ではありません。超過しても、メモリを解放して予算制限を下回ろうとすると、プロセスの速度が低下する可能性があります。

予算宣言は、システムからのメモリ要求ではなく、システムがプロセスにメモリを割り当てる方法にも影響しません。 予算により、アプリケーションは独自のリソースの使用を監視できます。

これらの予算に対して追跡されるメモリ使用量には、次のものが含まれます。

匿名割り当て。最も一般的には、Java ヒープとネイティブ ヒープです。

ファイルベースのページ (メモリにマップされたファイルやプロセスによってキャッシュされたファイルなど)。

プロセス間で共有されるメモリ (共有メモリ セグメントなど) の場合、使用量は、それをマップまたは割り当てる最初のプロセスに課金されます。

追跡対象のメモリ使用量には、ネイティブ グラフィックス バッファーや DMA-BUF は含まれません。

このインターフェイスで管理される予算に加えて、メモリには 2 セットの制限があります。 システムの制限とマニフェストの予算があります (マニフェストで <memory-budget> を使用して宣言されます)。 このインターフェイスを通じて管理される予算は、システムまたはマニフェストの制限を超えない場合があります。 システムまたはマニフェストの制限を超えようとすると、IllegalArgumentException が発生します。 ただし、このインターフェイスを介して設定された予算は、新しい値がシステムまたはマニフェストの制限を超えない限り、いつでも変更できます。

予算は肯定的である必要があります。0 または負の予算を設定しようとすると、IllegalArgumentException が発生します。

パッケージ (アプリケーション) 予算は、アプリケーション内のすべてのプロセス (具体的には、アプリケーションの UID で実行されているすべてのプロセス) に適用されます。 アプリケーションが UID を他のアプリケーションと共有する場合、その予算は、その共有 UID で実行されているすべてのプロセスの集計使用量に適用されます。

プロセス予算は、1 つのプロセスに適用されます。 プロセスに大きな予算を設定し、パッケージに小さな予算を設定することができます。パッケージ予算が優勢であり、大きなプロセス予算は無関係です。 これはエラーではありません。

このクラスによって提供される主なインターフェイスは次のとおりです。メモリ予算の構成:;setPackageBudgetBytes(long) / clearPackageBudget() - アプリケーションのメモリ予算を設定またはクリアします。setProcessBudgetBytes(long) / clearProcessBudget() - 呼び出し元プロセスのメモリ予算を設定またはクリアします。メモリ予算クエリ:;getPackageBudgetBytes() - アプリケーションの現在の予算を返します。getProcessBudgetBytes() - 呼び出し元プロセスの現在の予算を返します。メモリ使用量クエリ:;getPackageCurrentUsageBytes() - アプリケーション パッケージ内のすべてのプロセスの合計メモリ使用量を返します。getProcessCurrentUsageBytes() - 呼び出し元の特定のプロセスのメモリ使用量を返します。Over-Budget イベントの監視:;OnOverBudgetListener - メモリ使用量が予算のしきい値を超えたときに通知されるコールバック インターフェイス。registerPackageOverBudgetListener(Looper,OnOverBudgetListener) / unregisterPackageOverBudgetListener(OnOverBudgetListener) - パッケージ レベルの予算違反のリスナーを登録または登録解除します。registerProcessOverBudgetListener(Looper,OnOverBudgetListener) / unregisterProcessOverBudgetListener(OnOverBudgetListener) - プロセス レベルの予算違反のリスナーを登録または登録解除します。

android.app.MemoryBudgetManagerの Android リファレンス。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。