自 2025 年 3 月 27 日起，我們建議您使用 android-latest-release 而非 aosp-main 建構及貢獻 AOSP。詳情請參閱「Android 開放原始碼計畫變更」。
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
LargeOutputReceiver
public
class
LargeOutputReceiver
extends Object
implements
IShellOutputReceiver
| java.lang.Object
|
| ↳ |
com.android.tradefed.device.LargeOutputReceiver
|
這個類別旨在協助執行長時間執行的指令收集輸出內容。
tmp 檔案的大小上限約為 maxFileSize。為避免達到限制時資料遺失，這個檔案會保留一組暫存主機檔案。
摘要
公用建構函式
LargeOutputReceiver
public LargeOutputReceiver (String descriptor,
String serialNumber,
long maxDataSize)
建立 LargeOutputReceiver。
| 參數 |
|---|
descriptor |
String：要執行的指令描述項。僅供記錄。 |
serialNumber |
String：裝置的序號。僅供記錄。 |
maxDataSize |
long：大約要保留的資料量。 |
公用方法
addOutput
public void addOutput (byte[] data,
int offset,
int length)
| 參數 |
|---|
data |
byte |
offset |
int |
length |
int |
cancel
public void cancel ()
取消指令。
清除
public void clear ()
刪除目前累積的資料，然後重新建立新檔案。
刪除
public void delete ()
刪除所有累積資料。
getData
public InputStreamSource getData ()
以 InputStreamSource 的形式取得收集到的輸出內容。
| 傳回 |
|---|
InputStreamSource |
收集到的指令輸出內容。 |
getData
public InputStreamSource getData (int maxBytes)
取得收集到的輸出內容的最後一個 maxBytes，做為 InputStreamSource。
| 參數 |
|---|
maxBytes |
int：傳回的資料數量上限。應為可輕鬆放入記憶體的數量 |
| 傳回 |
|---|
InputStreamSource |
指令收集的輸出內容，儲存在記憶體中 |
getData
public InputStreamSource getData (int maxBytes,
int offset)
取得收集到的輸出內容的最後一個 maxBytes，做為 InputStreamSource。
| 參數 |
|---|
maxBytes |
int：傳回的資料數量上限。應為可輕鬆放入記憶體的數量 |
offset |
int：從緩衝區開始擷取資料的偏移量。 |
| 傳回 |
|---|
InputStreamSource |
指令收集的輸出內容，儲存在記憶體中 |
isCancelled
public boolean isCancelled ()
這個頁面中的內容和程式碼範例均受《內容授權》中的授權所規範。Java 與 OpenJDK 是 Oracle 和/或其關係企業的商標或註冊商標。
上次更新時間：2025-07-26 (世界標準時間)。
[[["容易理解","easyToUnderstand","thumb-up"],["確實解決了我的問題","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["缺少我需要的資訊","missingTheInformationINeed","thumb-down"],["過於複雜/步驟過多","tooComplicatedTooManySteps","thumb-down"],["過時","outOfDate","thumb-down"],["翻譯問題","translationIssue","thumb-down"],["示例/程式碼問題","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["上次更新時間：2025-07-26 (世界標準時間)。"],[],[],null,["# LargeOutputReceiver\n===================\n\n\n`\npublic\n\n\nclass\nLargeOutputReceiver\n`\n\n\n`\n\nextends Object\n\n\n`\n\n`\n\n\nimplements\n\nIShellOutputReceiver\n\n\n`\n\n|---|-------------------------------------------------|\n| java.lang.Object ||\n| ↳ | com.android.tradefed.device.LargeOutputReceiver |\n\n\u003cbr /\u003e\n\n*** ** * ** ***\n\nA class designed to help run long running commands collect output.\n\n\nThe maximum size of the tmp file is limited to approximately `maxFileSize`.\nTo prevent data loss when the limit has been reached, this file keeps set of tmp host\nfiles.\n\n\u003cbr /\u003e\n\nSummary\n-------\n\n| ### Public constructors ||\n|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---|\n| ` `[LargeOutputReceiver](../../../../../../reference/tradefed/com/android/tradefed/device/LargeOutputReceiver.html#LargeOutputReceiver(java.lang.String,%20java.lang.String,%20long))`(String descriptor, String serialNumber, long maxDataSize) ` Creates a [LargeOutputReceiver](../../../../../../reference/tradefed/com/android/tradefed/device/LargeOutputReceiver.html). |\n\n| ### Public methods ||\n|----------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ` void` | ` `[addOutput](../../../../../../reference/tradefed/com/android/tradefed/device/LargeOutputReceiver.html#addOutput(byte[],%20int,%20int))`(byte[] data, int offset, int length) ` |\n| ` void` | ` `[cancel](../../../../../../reference/tradefed/com/android/tradefed/device/LargeOutputReceiver.html#cancel())`() ` Cancels the command. |\n| ` void` | ` `[clear](../../../../../../reference/tradefed/com/android/tradefed/device/LargeOutputReceiver.html#clear())`() ` Delete currently accumulated data, and then re-create a new file. |\n| ` void` | ` `[delete](../../../../../../reference/tradefed/com/android/tradefed/device/LargeOutputReceiver.html#delete())`() ` Delete all accumulated data. |\n| ` void` | ` `[flush](../../../../../../reference/tradefed/com/android/tradefed/device/LargeOutputReceiver.html#flush())`() ` |\n| ` InputStreamSource` | ` `[getData](../../../../../../reference/tradefed/com/android/tradefed/device/LargeOutputReceiver.html#getData())`() ` Gets the collected output as a [InputStreamSource](../../../../../../reference/tradefed/com/android/tradefed/result/InputStreamSource.html). |\n| ` InputStreamSource` | ` `[getData](../../../../../../reference/tradefed/com/android/tradefed/device/LargeOutputReceiver.html#getData(int))`(int maxBytes) ` Gets the last \u003cvar translate=\"no\"\u003emaxBytes\u003c/var\u003e of collected output as a [InputStreamSource](../../../../../../reference/tradefed/com/android/tradefed/result/InputStreamSource.html). |\n| ` InputStreamSource` | ` `[getData](../../../../../../reference/tradefed/com/android/tradefed/device/LargeOutputReceiver.html#getData(int,%20int))`(int maxBytes, int offset) ` Gets the last \u003cvar translate=\"no\"\u003emaxBytes\u003c/var\u003e of collected output as a [InputStreamSource](../../../../../../reference/tradefed/com/android/tradefed/result/InputStreamSource.html). |\n| ` boolean` | ` `[isCancelled](../../../../../../reference/tradefed/com/android/tradefed/device/LargeOutputReceiver.html#isCancelled())`() ` |\n\nPublic constructors\n-------------------\n\n### LargeOutputReceiver\n\n```\npublic LargeOutputReceiver (String descriptor, \n String serialNumber, \n long maxDataSize)\n```\n\nCreates a [LargeOutputReceiver](../../../../../../reference/tradefed/com/android/tradefed/device/LargeOutputReceiver.html).\n\n\u003cbr /\u003e\n\n| Parameters ||\n|----------------|--------------------------------------------------------------------------|\n| `descriptor` | `String`: the descriptor of the command to run. For logging only. \u003cbr /\u003e |\n| `serialNumber` | `String`: the serial number of the device. For logging only. \u003cbr /\u003e |\n| `maxDataSize` | `long`: the approximate max amount of data to keep. \u003cbr /\u003e |\n\nPublic methods\n--------------\n\n### addOutput\n\n```\npublic void addOutput (byte[] data, \n int offset, \n int length)\n```\n\n\n\u003cbr /\u003e\n\n| Parameters ||\n|----------|---------------|\n| `data` | `byte` \u003cbr /\u003e |\n| `offset` | `int` \u003cbr /\u003e |\n| `length` | `int` \u003cbr /\u003e |\n\n### cancel\n\n```\npublic void cancel ()\n```\n\nCancels the command.\n\n\u003cbr /\u003e\n\n### clear\n\n```\npublic void clear ()\n```\n\nDelete currently accumulated data, and then re-create a new file.\n\n\u003cbr /\u003e\n\n### delete\n\n```\npublic void delete ()\n```\n\nDelete all accumulated data.\n\n\u003cbr /\u003e\n\n### flush\n\n```\npublic void flush ()\n```\n\n\n\u003cbr /\u003e\n\n### getData\n\n```\npublic InputStreamSource getData ()\n```\n\nGets the collected output as a [InputStreamSource](../../../../../../reference/tradefed/com/android/tradefed/result/InputStreamSource.html).\n\n\u003cbr /\u003e\n\n| Returns ||\n|---------------------|-----------------------------------------------|\n| `InputStreamSource` | The collected output from the command. \u003cbr /\u003e |\n\n### getData\n\n```\npublic InputStreamSource getData (int maxBytes)\n```\n\nGets the last \u003cvar translate=\"no\"\u003emaxBytes\u003c/var\u003e of collected output as a [InputStreamSource](../../../../../../reference/tradefed/com/android/tradefed/result/InputStreamSource.html).\n\n\u003cbr /\u003e\n\n| Parameters ||\n|------------|------------------------------------------------------------------------------------------------------------|\n| `maxBytes` | `int`: the maximum amount of data to return. Should be an amount that can comfortably fit in memory \u003cbr /\u003e |\n\n| Returns ||\n|---------------------|----------------------------------------------------------------|\n| `InputStreamSource` | The collected output from the command, stored in memory \u003cbr /\u003e |\n\n### getData\n\n```\npublic InputStreamSource getData (int maxBytes, \n int offset)\n```\n\nGets the last \u003cvar translate=\"no\"\u003emaxBytes\u003c/var\u003e of collected output as a [InputStreamSource](../../../../../../reference/tradefed/com/android/tradefed/result/InputStreamSource.html).\n\n\u003cbr /\u003e\n\n| Parameters ||\n|------------|------------------------------------------------------------------------------------------------------------|\n| `maxBytes` | `int`: the maximum amount of data to return. Should be an amount that can comfortably fit in memory \u003cbr /\u003e |\n| `offset` | `int`: The offset of when to start getting the data from the buffer. \u003cbr /\u003e |\n\n| Returns ||\n|---------------------|----------------------------------------------------------------|\n| `InputStreamSource` | The collected output from the command, stored in memory \u003cbr /\u003e |\n\n### isCancelled\n\n```\npublic boolean isCancelled ()\n```\n\n\n\u003cbr /\u003e\n\n| Returns ||\n|-----------|--------|\n| `boolean` | \u003cbr /\u003e |"]]
