為配合主幹穩定開發模型，並確保生態系統的平台穩定性，我們將於 2026 年起，在第 2 季和第 4 季將原始碼發布至 AOSP。如要建構及貢獻 AOSP，建議使用 android-latest-release，而非 aosp-main。android-latest-release 資訊清單分支版本一律會參照推送至 AOSP 的最新版本。詳情請參閱「Android 開放原始碼計畫變更」一文。

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

MallocDebug

public class MallocDebug
extends Object implements AutoCloseable

java.lang.Object
↳	com.android.sts.common.MallocDebug

用於在程序上設定 malloc 偵錯選項、檢查 malloc 偵錯錯誤，並在之後清理。

摘要

公用方法
`void`	`close()`
`static AutoCloseable`	`withLibcMallocDebugOnAllNewProcesses(ITestDevice device, String mallocDebugOptions)` 開始將 libc malloc 偵錯附加至此呼叫後啟動的所有程序，並在關閉時斷言沒有 malloc 偵錯錯誤。
`static AutoCloseable`	`withLibcMallocDebugOnNewProcess(ITestDevice device, String mallocDebugOptions, String processName)` 設定方式如下：malloc 偵錯會附加至指定的 processName，並在關閉時斷言沒有 malloc 偵錯錯誤。
`static AutoCloseable`	`withLibcMallocDebugOnService(ITestDevice device, String mallocDebugOptions, String processName)` 重新啟動指定的服務，並在其中啟用 malloc 偵錯功能，以便在關閉時斷言沒有 malloc 偵錯錯誤。

公用方法

關閉

public void close ()

擲回
`Exception`

withLibcMallocDebugOnAllNewProcesses

public static AutoCloseable withLibcMallocDebugOnAllNewProcesses (ITestDevice device, 
                String mallocDebugOptions)

開始將 libc malloc 偵錯功能附加至此呼叫後啟動的所有程序，並在關閉時斷言沒有 malloc 偵錯錯誤。

參數
`device`	`ITestDevice`：要使用的裝置
`mallocDebugOptions`	`String`：將 libc.debug.malloc.options 設為的值。

傳回
`AutoCloseable`	AutoCloseable 物件會停用 libc malloc 偵錯功能，並在關閉時檢查 malloc 偵錯錯誤。

擲回
`DeviceNotAvailableException`
`TimeoutException`
`ProcessUtil.KillException`

withLibcMallocDebugOnNewProcess

public static AutoCloseable withLibcMallocDebugOnNewProcess (ITestDevice device, 
                String mallocDebugOptions, 
                String processName)

設定方式如下：malloc 偵錯會附加至指定的 processName，並在關閉時斷言沒有 malloc 偵錯錯誤。請注意，這個呼叫後，您必須手動啟動 processName。

參數
`device`	`ITestDevice`：要使用的裝置
`mallocDebugOptions`	`String`：將 libc.debug.malloc.options 設為的值。
`processName`	`String`：要附加 libc malloc 偵錯的程序。不應執行。

傳回
`AutoCloseable`	AutoCloseable 物件會停用 libc malloc 偵錯功能，並在關閉時檢查 malloc 偵錯錯誤。

擲回
`DeviceNotAvailableException`
`IllegalArgumentException`
`TimeoutException`
`ProcessUtil.KillException`

withLibcMallocDebugOnService

public static AutoCloseable withLibcMallocDebugOnService (ITestDevice device, 
                String mallocDebugOptions, 
                String processName)

重新啟動指定的服務，並在該服務上啟用 malloc 偵錯功能，以便在關閉時斷言沒有 malloc 偵錯錯誤。

參數
`device`	`ITestDevice`：要使用的裝置
`mallocDebugOptions`	`String`：將 libc.debug.malloc.options 設為的值。
`processName`	`String`：要附加 libc malloc 偵錯的服務程序。應處於執行狀態。

傳回
`AutoCloseable`	AutoCloseable 物件會重新啟動/取消附加服務、停用 libc malloc 偵錯，並在關閉時檢查 malloc 偵錯錯誤。

擲回
`DeviceNotAvailableException`
`IllegalArgumentException`
`TimeoutException`
`ProcessUtil.KillException`