החל משנת 2026, כדי להתאים למודל הפיתוח היציב שלנו ולשמור על יציבות הפלטפורמה בסביבה העסקית, נפרסם קוד מקור ב-AOSP ברבעון השני וברבעון הרביעי. כדי ליצור ולתרום ל-AOSP, צריך להשתמש ב-android-latest-release. הענף android-latest-release manifest תמיד יפנה לגרסה האחרונה שנדחפה ל-AOSP. מידע נוסף זמין במאמר שינויים ב-AOSP.

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

ShardMainResultForwarder

public class ShardMainResultForwarder
extends ResultForwarder implements ILogSaverListener

java.lang.Object
↳	com.android.tradefed.result.ResultForwarder
	↳	com.android.tradefed.invoker.ShardMainResultForwarder

‫ResultForwarder שמשלב את התוצאות של הפעלות בדיקה עם חלוקה למקטעים. הוא מדווח על השלמת ההפעלה למאזינים רק אחרי שכל ההפעלות המפוצלות מסתיימות.

המחלקות האלה לא בטוחות לשימוש עם שרשורים. הלקוחות צפויים להסתמך על המחלקה הזו כששולחים תוצאות של בדיקות, כדי למנוע קריאה לפונקציות callback שלא לפי הסדר.

סיכום

‫constructors ציבוריים
`ShardMainResultForwarder(List<ITestInvocationListener> listeners, int expectedShards)` יצירת `ShardMainResultForwarder`.

‫methods ציבוריים
`List<ITestInvocationListener>`	`getListeners()` קבלת רשימת ה-listeners.
`void`	`invocationEnded(long elapsedTime)` הפונקציה מדווחת שההפעלה הסתיימה, בין אם בהצלחה ובין אם בגלל שגיאה כלשהי.
`void`	`invocationEnded(long elapsedTime, IInvocationContext context)` קריאה חוזרת מפורטת יותר כדי להבחין בין הרסיסים שהסתיימו.
`void`	`invocationFailed(FailureDescription failure)` הפונקציה מחזירה קריאה לא שלמה בגלל תנאי שגיאה מסוים.
`void`	`invocationFailed(Throwable cause)` הפונקציה מחזירה קריאה לא שלמה בגלל תנאי שגיאה מסוים.
`void`	`invocationSkipped(SkipReason reason)` דיווח על הפעלה שנדלגה
`void`	`invocationStarted(IInvocationContext context)` הפונקציה מחזירה את תחילת ההפעלה של הבדיקה.
`void`	`logAssociation(String dataName, LogFile logFile)` במקרים מסוימים, צריך לשייך את היומן באופן חזק לתרחישי בדיקה, אבל אי אפשר לעשות את זה באמצעות הקריאה החוזרת הישירה `testLogSaved(String,LogDataType,InputStreamSource,LogFile)`.
`void`	`testLogForward(String dataName, LogDataType dataType, InputStreamSource dataStream)` במקום לשמור את היומן קודם, מעבירים רק את testLog.
`void`	`testLogSaved(String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)` מופעל כשיומן הבדיקה נשמר.

‫constructors ציבוריים

ShardMainResultForwarder

public ShardMainResultForwarder (List<ITestInvocationListener> listeners, 
                int expectedShards)

יצירת ShardMainResultForwarder.

פרמטרים
`listeners`	‫`List`: רשימת `ITestInvocationListener` שאליהן יועברו התוצאות אחרי שכל הרסיסים יסיימו את העיבוד
`expectedShards`	‫`int`: מספר הרסיסים

‫methods ציבוריים

getListeners

public List<ITestInvocationListener> getListeners ()

קבלת רשימת ה-listeners.

החזרות
`List<ITestInvocationListener>`	רשימה של `ITestInvocationListener`.

invocationEnded

public void invocationEnded (long elapsedTime)

הפונקציה מדווחת שההפעלה הסתיימה, בין אם בהצלחה ובין אם בגלל שגיאה כלשהי.

הפונקציה הזו תופעל אוטומטית על ידי מסגרת TradeFederation.

פרמטרים
`elapsedTime`	‫`long`: הזמן שחלף מאז ההפעלה במילישניות

invocationEnded

public void invocationEnded (long elapsedTime, 
                IInvocationContext context)

קריאה חוזרת מפורטת יותר כדי להבחין בין הרסיסים שהסתיימו.

פרמטרים
`elapsedTime`	`long`
`context`	`IInvocationContext`

invocationFailed

public void invocationFailed (FailureDescription failure)

הפונקציה מחזירה קריאה לא שלמה בגלל תנאי שגיאה מסוים.

הפונקציה הזו תופעל אוטומטית על ידי מסגרת TradeFederation.

פרמטרים
`failure`	‫`FailureDescription`: `FailureDescription` שמתאר את הסיבה לכשל

invocationFailed

public void invocationFailed (Throwable cause)

הפונקציה מחזירה קריאה לא שלמה בגלל תנאי שגיאה מסוים.

הפונקציה הזו תופעל אוטומטית על ידי מסגרת TradeFederation.

פרמטרים
`cause`	‫`Throwable`: הסיבה לכישלון `Throwable`

invocationSkipped

public void invocationSkipped (SkipReason reason)

דיווח על הפעלה שנדלגה

פרמטרים
`reason`	`SkipReason`

invocationStarted

public void invocationStarted (IInvocationContext context)

הפונקציה מחזירה את תחילת ההפעלה של הבדיקה.

הפונקציה הזו תופעל אוטומטית על ידי מסגרת TradeFederation. כדי לתמוך בדיווח ממספר מכשירים, צריך להגדיר מחדש את השיטה הזו.

פרמטרים
`context`	‫`IInvocationContext`: מידע על הקריאה

logAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

במקרים מסוימים, צריך לשייך את היומן באופן חזק לתרחישי בדיקה, אבל אי אפשר לעשות את זה באמצעות הקריאה החוזרת הישירה testLogSaved(String,LogDataType,InputStreamSource,LogFile). לכן, פונקציית הקריאה החוזרת הזו מאפשרת לספק שיוך חזק באופן מפורש.

פרמטרים
`dataName`	`String`: שם הנתונים
`logFile`	‫`LogFile`: `LogFile` שנרשם קודם וצריך להיות משויך לתרחיש הבדיקה.

testLogForward

public void testLogForward (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream)

במקום לשמור את היומן קודם, מעבירים רק את testLog.

פרמטרים
`dataName`	`String`
`dataType`	`LogDataType`
`dataStream`	`InputStreamSource`

testLogSaved

public void testLogSaved (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream, 
                LogFile logFile)

מופעל כשיומן הבדיקה נשמר.

צריך להשתמש במקומה במדיניות ITestInvocationListener.testLog(String,LogDataType,InputStreamSource).

פרמטרים
`dataName`	‫`String`: שם תיאורי של הנתונים. לדוגמה, device_logcat.`String` הערה יכול להיות ש-dataName לא יהיה ייחודי לכל הפעלה. כלומר, המטמיעים צריכים להיות מסוגלים לטפל בכמה קריאות עם אותו dataName
`dataType`	‫`LogDataType`: `LogDataType` הנתונים
`dataStream`	`InputStreamSource`: `InputStreamSource` הנתונים. מטמיעים צריכים להפעיל את הפונקציה createInputStream כדי להתחיל לקרוא את הנתונים, ולוודא שסוגרים את InputStream שמתקבל בסיום.
`logFile`	‫`LogFile`: `LogFile` שמכיל את המטא-נתונים של הקובץ שנשמר.