IBuildInfo

public interface IBuildInfo

com.android.tradefed.build.IBuildInfo

מכיל מידע על המבנה הנבדק.

סיכום

קבועים

String REMOTE_FILE_PREFIX

קידומת המשמשת בשם כדי לציין שהקובץ מוגדר לעיכוב בהורדה.

String REMOTE_FILE_VERSION

הקובץ המרוחק אינו בעל גרסה.

String UNKNOWN_BUILD_ID

ערך ברירת המחדל כאשר מזהה build אינו ידוע.

שיטות ציבוריות

default void addAppPackageFile (File appPackageFile, String version)

מוסיף את קובץ ה-apk המקומי ואת הגרסה הקשורה אליו.

abstract void addBuildAttribute (String attributeName, String attributeValue)

הוסף מאפיין build.

default void addBuildAttributes ( buildAttributes) addBuildAttributes ( buildAttributes)

הוסף תכונות בנייה

abstract void cleanUp ()

נקה כל קבצי בנייה זמניים

abstract void cleanUp ( doNotDelete) cleanUp ( doNotDelete)

גרסה של cleanUp() שבה חלק מהקבצים לא נמחקים.

abstract IBuildInfo clone ()

משבט את האובייקט IBuildInfo .

default getAppPackageFiles ()

מקבל עותק של ערכת קבצי ה-apk של האפליקציה המקומית וגרסאותיהם.

abstract getBuildAttributes ()

קבל קבוצה של זוגות שם-ערך של תכונות נוספות המתארות את המבנה.

abstract String getBuildBranch ()

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

abstract String getBuildFlavor ()

שיטה אופציונלית להחזרת סוג ה-build הנבדק.

abstract String getBuildId ()

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

abstract String getBuildTargetName ()

החזר שם מלא למבנה הנבדק.

abstract String getDeviceSerial ()
abstract File getFile (String name)

שיטת עוזר לאחזור קובץ בשם נתון.

default File getFile ( BuildInfoKey.BuildInfoFileKey key)

שיטת עוזר לאחזור קובץ עם נתון BuildInfoFileKey .

abstract getFiles ()

מחזירה את כל VersionedFile המאוחסנים ב- BuildInfo זה.

abstract getProperties ()

מחזיר עותק של המאפיינים המוגדרים כעת ב- IBuildInfo .

default getRemoteFiles ()

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

abstract String getTestTag ()

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

default String getVersion ( BuildInfoKey.BuildInfoFileKey key)

שיטת עוזר לאחזר גירסת קובץ עם נתון BuildInfoFileKey .

abstract String getVersion (String name)

שיטת עוזר לאחזר גרסת קובץ עם שם נתון.

default VersionedFile getVersionedFile ( BuildInfoKey.BuildInfoFileKey key)

שיטת עוזר לאחזר קובץ VersionedFile עם מפתח נתון BuildInfoFileKey .

default VersionedFile getVersionedFile (String name)

שיטת עוזר לאחזר VersionedFile עם שם נתון.

default getVersionedFileKeys ()

מחזירה את ערכת המפתחות הזמינה לשאילתה VersionedFile באמצעות getFile(BuildInfoFileKey) .

default getVersionedFiles ( BuildInfoKey.BuildInfoFileKey key)

שיטת מסייע לאחזור רשימה של VersionedFile המשויכים ל- BuildInfoFileKey נתון.

default void removeBuildAttribute (String attributeName)

הסר attributeName נתון מהמעקב.

abstract void setBuildBranch (String branch)

הגדר את ענף הבנייה

abstract void setBuildFlavor (String buildFlavor)

הגדר את טעם המבנה.

abstract void setBuildId (String buildId)

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

abstract void setDeviceSerial (String serial)

הגדר את סדרת ITestDevice המשויכת ל-build זה.

abstract void setFile (String name, File file, String version)

מאחסן קובץ בשם נתון בפרטי הבנייה הזה.

default void setFile ( BuildInfoKey.BuildInfoFileKey key, File file, String version)

מאחסן קובץ שקיבל BuildInfoFileKey במידע בנייה זה.

abstract void setProperties ( BuildInfoProperties... properties)

הגדר את BuildInfoProperties עבור מופע IBuildInfo .

abstract void setTestTag (String testTag)

מגדיר את השם הייחודי לבדיקות המופעלות.

default File stageRemoteFile (String fileName, File workingDir)

שלב קובץ שהוא חלק מקבצים מרוחקים ב-Dir root של מידע ה-build.

default BuildInformation.BuildInfo toProto ()

הפוך את המופע של BuildInfo ל-protobuf.

קבועים

REMOTE_FILE_PREFIX

public static final String REMOTE_FILE_PREFIX

קידומת המשמשת בשם כדי לציין שהקובץ מוגדר לעיכוב בהורדה.

ערך קבוע: "remote_file:"

REMOTE_FILE_VERSION

public static final String REMOTE_FILE_VERSION

הקובץ המרוחק אינו בעל גרסה.

ערך קבוע: ""

UNKNOWN_BUILD_ID

public static final String UNKNOWN_BUILD_ID

ערך ברירת המחדל כאשר מזהה build אינו ידוע.

ערך קבוע: "-1"

שיטות ציבוריות

addAppPackageFile

public void addAppPackageFile (File appPackageFile, 
                String version)

מוסיף את קובץ ה-apk המקומי ואת הגרסה הקשורה אליו. שימו לב ש-apks יוחזרו מ- getAppPackageFiles() בסדר שבו נוספו בשיטה זו.

פרמטרים
appPackageFile File

version String

addBuildAttribute

public abstract void addBuildAttribute (String attributeName, 
                String attributeValue)

הוסף מאפיין build. זה לא מאפשר לעקוף attributeName קיים.

פרמטרים
attributeName String : שם התכונה הייחודית

attributeValue String : ערך התכונה

addBuildAttributes

public void addBuildAttributes ( buildAttributes)

הוסף תכונות בנייה

פרמטרים
buildAttributes : מפה של תכונות שיש להוסיף

לנקות

public abstract void cleanUp ()

נקה כל קבצי בנייה זמניים

לנקות

public abstract void cleanUp ( doNotDelete)

גרסה של cleanUp() שבה חלק מהקבצים לא נמחקים.

פרמטרים
doNotDelete

שיבוט

public abstract IBuildInfo clone ()

משבט את האובייקט IBuildInfo .

החזרות
IBuildInfo

getAppPackageFiles

public  getAppPackageFiles ()

מקבל עותק של ערכת קבצי ה-apk של האפליקציה המקומית וגרסאותיהם. ההזמנה שהוחזרה תואמת את הסדר שבו נוספו ה-apks ל- IAppBuildInfo .

החזרות

getBuildAttributes

public abstract  getBuildAttributes ()

קבל קבוצה של זוגות שם-ערך של תכונות נוספות המתארות את המבנה.

החזרות
ERROR(/Map) של תכונות בנייה. לא יהיה null , אבל עשוי להיות ריק.

getBuildBranch

public abstract String getBuildBranch ()

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

החזרות
String ענף ה-build או null אם לא מוגדר/לא רלוונטי

getBuildFlavor

public abstract String getBuildFlavor ()

שיטה אופציונלית להחזרת סוג ה-build הנבדק.

יישום נפוץ עבור בניית פלטפורמת אנדרואיד הוא החזרת (בניית מוצר)-(build OS)-(גרסה לבנות). כלומר גנרי-linux-userdebug

החזרות
String טעם המבנה או null אם לא מוגדר/לא ישים

getBuildId

public abstract String getBuildId ()

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

החזרות
String

getBuildTargetName

public abstract String getBuildTargetName ()

החזר שם מלא למבנה הנבדק.

יישום נפוץ הוא בניית שם יעד הבנייה משילוב של טעם הבנייה ושם הענף. [כלומר (שם הסניף)-(בנה טעם)]

החזרות
String

getDeviceSerial

public abstract String getDeviceSerial ()

החזרות
String סדרת ITestDevice שעליה בוצע הבנייה הזו. מחזירה null אם אין מכשיר משויך ל-build זה.

getFile

public abstract File getFile (String name)

שיטת עוזר לאחזור קובץ בשם נתון.

החזרות
File קובץ התמונה או null אם לא נמצא

getFile

public File getFile (BuildInfoKey.BuildInfoFileKey key)

שיטת עוזר לאחזור קובץ עם נתון BuildInfoFileKey .

פרמטרים
key BuildInfoKey.BuildInfoFileKey : מפתח ה- BuildInfoFileKey שמתבקש.

החזרות
File קובץ התמונה או null אם לא נמצא

getFiles

public abstract  getFiles ()

מחזירה את כל VersionedFile המאוחסנים ב- BuildInfo זה.

החזרות

getProperties

public abstract  getProperties ()

מחזיר עותק של המאפיינים המוגדרים כעת ב- IBuildInfo .

החזרות

getRemoteFiles

public  getRemoteFiles ()

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

החזרות

getTestTag

public abstract String getTestTag ()

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

החזרות
String

getVersion

public String getVersion (BuildInfoKey.BuildInfoFileKey key)

שיטת עוזר לאחזר גירסת קובץ עם נתון BuildInfoFileKey .

פרמטרים
key BuildInfoKey.BuildInfoFileKey : BuildInfoFileKey המבוקש.

החזרות
String גרסת התמונה או null אם לא נמצאה

getVersion

public abstract String getVersion (String name)

שיטת עוזר לאחזר גרסת קובץ עם שם נתון.

החזרות
String גרסת התמונה או null אם לא נמצאה

getVersionedFile

public VersionedFile getVersionedFile (BuildInfoKey.BuildInfoFileKey key)

שיטת עוזר לאחזר קובץ VersionedFile עם מפתח נתון BuildInfoFileKey .

פרמטרים
key BuildInfoKey.BuildInfoFileKey : BuildInfoFileKey המבוקש.

החזרות
VersionedFile הקובץ עם הגרסה או null אם לא נמצא

getVersionedFile

public VersionedFile getVersionedFile (String name)

שיטת עוזר לאחזר VersionedFile עם שם נתון.

החזרות
VersionedFile הקובץ עם הגרסה או null אם לא נמצא

getVersionedFileKeys

public  getVersionedFileKeys ()

מחזירה את ערכת המפתחות הזמינה לשאילתה VersionedFile באמצעות getFile(BuildInfoFileKey) .

החזרות

getVersionedFiles

public  getVersionedFiles (BuildInfoKey.BuildInfoFileKey key)

שיטת מסייע לאחזור רשימה של VersionedFile המשויכים ל- BuildInfoFileKey נתון. אם המקש מאפשר לאחסן רשימה.

פרמטרים
key BuildInfoKey.BuildInfoFileKey : BuildInfoFileKey המבוקש.

החזרות
הקובץ עם הגרסה או null אם לא נמצא

removeBuildAttribute

public void removeBuildAttribute (String attributeName)

הסר attributeName נתון מהמעקב.

פרמטרים
attributeName String : התכונה להפסקת המעקב

setBuildBranch

public abstract void setBuildBranch (String branch)

הגדר את ענף הבנייה

פרמטרים
branch String : שם הסניף

setBuildFlavor

public abstract void setBuildFlavor (String buildFlavor)

הגדר את טעם המבנה.

setBuildId

public abstract void setBuildId (String buildId)

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

פרמטרים
buildId String

setDeviceSerial

public abstract void setDeviceSerial (String serial)

הגדר את סדרת ITestDevice המשויכת ל-build זה.

פרמטרים
serial String : המספר הסידורי של ה- ITestDevice שאיתו בוצע בנייה זו.

setFile

public abstract void setFile (String name, 
                File file, 
                String version)

מאחסן קובץ בשם נתון בפרטי הבנייה הזה.

פרמטרים
name String : השם הייחודי של הקובץ

file File : ERROR(/File)

version String : גרסת הקובץ

setFile

public void setFile (BuildInfoKey.BuildInfoFileKey key, 
                File file, 
                String version)

מאחסן קובץ שקיבל BuildInfoFileKey במידע בנייה זה.

פרמטרים
key BuildInfoKey.BuildInfoFileKey : השם הייחודי של הקובץ המבוסס על BuildInfoFileKey .

file File : ERROR(/File)

version String : גרסת הקובץ

setProperties

public abstract void setProperties (BuildInfoProperties... properties)

הגדר את BuildInfoProperties עבור מופע IBuildInfo . עוקף את כל המאפיינים הקיימים שהוגדרו קודם לכן.

פרמטרים
properties BuildInfoProperties : רשימת המאפיינים שיש להוסיף.

setTestTag

public abstract void setTestTag (String testTag)

מגדיר את השם הייחודי לבדיקות המופעלות.

פרמטרים
testTag String

stageRemoteFile

public File stageRemoteFile (String fileName, 
                File workingDir)

שלב קובץ שהוא חלק מקבצים מרוחקים ב-Dir root של מידע ה-build.

TODO(b/138416078): הסר את הממשק הזה ואת המתקשר שלו כאשר ניתן לבנות כראוי מודולים הנדרשים על ידי בדיקה פלט לספריית מודול הבדיקה עצמו.

פרמטרים
fileName String : שם הקובץ שיימצא בקבצים מרוחקים.

workingDir File : אובייקט ERROR(/File) של הספרייה לשלב את הקובץ.

החזרות
File האובייקט ERROR(/File) של הקובץ מבוים ב-workingDir המקומי.

לפרוטו

public BuildInformation.BuildInfo toProto ()

הפוך את המופע של BuildInfo ל-protobuf.

החזרות
BuildInformation.BuildInfo