语言

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
继承
MemoryBudgetManager
特性

注解

此类是应用程序和进程的内存预算的客户端接口。 内存预算是由应用程序或其进程之一承诺,其内存要求不会超过一些限制。 预算不是硬性限制:可以超过,但这可能会导致进程在尝试释放内存并低于预算限制时减慢速度。

预算声明不是从系统请求内存,声明也不会影响系统向进程分配内存的方式。 预算允许应用程序监视其自己的资源使用情况。

根据这些预算跟踪的内存使用情况包括:

匿名分配,通常是Java堆和本机堆。

文件支持的页面(如映射到内存或进程缓存的文件)。

在进程之间共享的内存(例如共享内存段)的情况下,使用量将计入映射或分配它的第一个进程。

跟踪的内存使用情况不包括本机图形缓冲区或 DMA-BUF。

除了通过此接口管理的预算外,内存还有两组限制。 存在系统限制和清单预算(通过 <清单中的内存预算> 声明)。 通过此接口管理的预算可能不超过系统或清单限制。 任何超出系统或清单限制的尝试都将导致 IllegalArgumentException。 但是,只要新值不超过系统或清单限制,就可以随时更改通过此接口设置的预算。

预算必须是积极的;尝试设置零或负预算将导致 IllegalArgumentException。

包(应用程序)预算适用于应用程序中的所有进程作为组(具体而言,应用程序 UID 下运行的所有进程)。 如果应用程序与其他应用程序共享 UID,则预算适用于在该共享 UID 下运行的所有进程的聚合使用情况。

流程预算适用于单个进程。 可以在流程上设置大型预算,对包设置一个小预算:包预算占主导地位,大型流程预算无关紧要。 这不是一个错误。

此类提供的主要接口为:内存预算配置:;setPackageBudgetBytes(long) / clearPackageBudget() - 设置或清除应用程序的内存预算;setProcessBudgetBytes(long) / clearProcessBudget() - 设置或清除调用进程的内存预算;内存预算查询:;getPackageBudgetBytes() - 返回应用程序的当前预算;getProcessBudgetBytes() - 返回调用进程的当前预算;内存使用情况查询:;getPackageCurrentUsageBytes() - 返回应用程序包中所有进程的聚合内存使用情况;getProcessCurrentUsageBytes() - 返回调用方特定进程的内存使用情况;Over-Budget 事件监视:;OnOverBudgetListener - 内存使用量超过预算阈值时通知回调接口;registerPackageOverBudgetListener(Looper,OnOverBudgetListener) / unregisterPackageOverBudgetListener(OnOverBudgetListener) - 注册或取消注册包级预算违规的侦听器;registerProcessOverBudgetListener(Looper,OnOverBudgetListener) / unregisterProcessOverBudgetListener(OnOverBudgetListener) - 注册或取消注册进程级预算违规的侦听器。

Android 参考。android.app.MemoryBudgetManager

本页的某些部分是根据 Android 开放源代码项目创建和共享的工作进行的修改,并根据 Creative Commons 2.5 属性许可证中所述的术语使用。

字段

名称 说明
LimitIsDisabled

此值由 #getPackageBudgetBytes() 应用程序或进程分别返回且 #getProcessBudgetBytes() 没有与应用程序或进程关联的内存限制。

属性

名称 说明
Class

返回此 Object的运行时类。

(继承自 Object)
Handle

基础 Android 实例的句柄。

(继承自 Object)
JniIdentityHashCode

获取互操作运行时分配给此Java对等的标识哈希代码。

(继承自 Object)
JniManagedPeerState

获取运行时上次分配的状态标志。

(继承自 JavaObject)
JniPeerMembers

获取用于访问此Java绑定成员的 JNI 元数据。

PackageBudgetBytes

返回调用方应用程序的预算。 - 或 - 设置调用方应用程序的内存预算。

PackageCurrentUsageBytes

返回调用方的应用程序 UID 下运行的所有进程的聚合内存使用情况。

PeerReference

获取此Java对等方的 JNI 对象引用。

(继承自 Object)
ProcessBudgetBytes

返回调用方流程的预算。 - 或 - 设置调用方进程的内存预算。

ProcessCurrentUsageBytes

返回调用方进程的当前内存使用情况。

ThresholdClass

此 API 支持 Mono for Android 基础结构,不打算直接从代码使用。

(继承自 Object)
ThresholdType

此 API 支持 Mono for Android 基础结构,不打算直接从代码使用。

(继承自 Object)

方法

名称 说明
ClearPackageBudget()

删除调用方应用程序的包预算(如果有)。

ClearProcessBudget()

删除调用方流程的进程预算(如果有)。

Clone()

创建并返回此对象的副本。

(继承自 Object)
Construct(JniObjectReference, JniObjectReferenceOptions)

将此对等方的构造委托给运行时的值管理器。

(继承自 JavaObject)
Dispose()

释放此Java对等方持有的资源。

(继承自 Object)
Dispose(Boolean)

释放此Java对等方持有的资源。

(继承自 Object)
DisposeUnlessReferenced()

要求值管理器释放此对等方,除非其映射保留此相同的托管实例。

(继承自 JavaObject)
Equals(Object)

测试另一个托管对等方是否引用同一Java对象。

(继承自 JavaObject)
Equals(Object)

指示其他对象是否“等于”此对象。

(继承自 Object)
GetHashCode()

返回对象的哈希代码值。

(继承自 Object)
JavaFinalize()
已过时.

当垃圾回收确定不再引用该对象时,由对象上的垃圾回收器调用。

(继承自 Object)
Notify()

唤醒正在等待此对象的监视器的单个线程。

(继承自 Object)
NotifyAll()

唤醒正在等待此对象的监视器的所有线程。

(继承自 Object)
RegisterPackageOverBudgetListener(Looper, MemoryBudgetManager+IOnOverBudgetListener)

如果调用方的应用程序超出其包预算,则注册以接收通知。

RegisterProcessOverBudgetListener(Looper, MemoryBudgetManager+IOnOverBudgetListener)

如果调用方的进程超出其进程预算,则注册要通知。

SetHandle(IntPtr, JniHandleOwnership)

设置 Handle 属性。

(继承自 Object)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)

在不创建 JNI 引用副本的情况下,将引用值存储在控制块中。

(继承自 JavaObject)
ToArray<T>()

从此Java数组包装器创建托管数组。

(继承自 Object)
ToString()

返回对象的字符串表示形式。

(继承自 Object)
UnregisterFromRuntime()

从互操作运行时取消注册此Java对等。

(继承自 Object)
UnregisterPackageOverBudgetListener(MemoryBudgetManager+IOnOverBudgetListener)

取消注册包预算侦听器。

UnregisterProcessOverBudgetListener(MemoryBudgetManager+IOnOverBudgetListener)

取消注册进程预算侦听器。

Wait()

导致当前线程等待,直到它被唤醒,通常是通过 通知 或 中断。

(继承自 Object)
Wait(Int64, Int32)

使当前线程等待直到唤醒,通常是通过 通知 或 中断,或直到经过一定数量的实时。

(继承自 Object)
Wait(Int64)

使当前线程等待直到唤醒,通常是通过 通知 或 中断,或直到经过一定数量的实时。

(继承自 Object)

显式接口实现

名称 说明
IJavaPeerable.Disposed()

将此对等方标记为已释放,并将disposing调用Dispose设置为 true.

(继承自 JavaObject)
IJavaPeerable.Finalized()

将此对等方标记为已释放,并将disposing调用Dispose设置为 false.

(继承自 JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock

获取此对等方使用的本机控制块指针。

(继承自 JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)

存储运行时提供的标识哈希代码。

(继承自 JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)

替换存储的托管对等状态标志。

(继承自 JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)

更新对等引用,并在引用无效时释放已释放的对等方控制块。

(继承自 JavaObject)

扩展方法

名称 说明
GetJniTypeName(IJavaPeerable)

获取实例 self类型的 JNI 名称。

JavaAs<TResult>(IJavaPeerable)

尝试强制self键入TResult,检查强制是否在Java端有效。

JavaCast<TResult>(IJavaObject)

执行 Android 运行时检查的类型转换。

JavaCast<TResult>(IJavaObject)

重复使用兼容的托管对等,或获取请求类型的包装器。

TryJavaCast<TResult>(IJavaPeerable, TResult)

尝试强制self键入TResult,检查强制是否在Java端有效。

适用于