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) הוסף תכונות בנייה |
default void | allowStagingRemoteFile (boolean stageRemoteFile) מגדיר הרשאה לאפשר העלאת קבצים מרוחקים. |
abstract void | cleanUp () נקה כל קבצי בנייה זמניים |
abstract void | cleanUp ( doNotDelete) cleanUp ( doNotDelete) גרסה של |
abstract IBuildInfo | clone () משבט את האובייקט |
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) שיטת עוזר לאחזור קובץ עם נתון |
abstract | getFiles () מחזירה את כל |
abstract | getProperties () מחזיר עותק של המאפיינים המוגדרים כעת ב- |
default | getRemoteFiles () קבל את הנתיבים לבניית חפצים שמתעכבים בהורדה. |
abstract String | getTestTag () החזר שם ייחודי עבור הבדיקות המתנהלות. |
default String | getVersion ( BuildInfoKey.BuildInfoFileKey key) שיטת עוזר לאחזר גירסת קובץ עם נתון |
abstract String | getVersion (String name) שיטת עוזר לאחזר גרסת קובץ עם שם נתון. |
default VersionedFile | getVersionedFile ( BuildInfoKey.BuildInfoFileKey key) שיטת עוזר לאחזר קובץ |
default VersionedFile | getVersionedFile (String name) שיטת עוזר לאחזר |
default | getVersionedFileKeys () מחזירה את ערכת המפתחות הזמינה לשאילתה |
default | getVersionedFiles ( BuildInfoKey.BuildInfoFileKey key) שיטת מסייע לאחזור רשימה של קבצי |
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) הגדר את סדרת |
abstract void | setFile (String name, File file, String version) מאחסן קובץ בשם נתון בפרטי הבנייה הזה. |
default void | setFile ( BuildInfoKey.BuildInfoFileKey key, File file, String version) מאחסן קובץ שקיבל |
abstract void | setProperties ( BuildInfoProperties... properties) הגדר את |
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 |
allowStagingRemoteFile
public void allowStagingRemoteFile (boolean stageRemoteFile)
מגדיר הרשאה לאפשר העלאת קבצים מרוחקים.
פרמטרים | |
---|---|
stageRemoteFile | boolean |
לנקות
public abstract void cleanUp ()
נקה כל קבצי בנייה זמניים
לנקות
public abstract void cleanUp (doNotDelete)
גרסה של cleanUp()
שבה חלק מהקבצים לא נמחקים.
פרמטרים | |
---|---|
doNotDelete |
getAppPackageFiles
publicgetAppPackageFiles ()
מקבל עותק של ערכת קבצי ה-apk של האפליקציה המקומית וגרסאותיהם. ההזמנה שהוחזרה תואמת את הסדר שבו נוספו ה-apks ל- IAppBuildInfo
.
החזרות | |
---|---|
getBuildAttributes
public abstractgetBuildAttributes ()
קבל קבוצה של זוגות שם-ערך של תכונות נוספות המתארות את המבנה.
החזרות | |
---|---|
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 אם לא נמצא |
getProperties
public abstractgetProperties ()
מחזיר עותק של המאפיינים המוגדרים כעת ב- IBuildInfo
.
החזרות | |
---|---|
getRemoteFiles
publicgetRemoteFiles ()
קבל את הנתיבים לבניית חפצים שמתעכבים בהורדה.
החזרות | |
---|---|
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
publicgetVersionedFileKeys ()
מחזירה את ערכת המפתחות הזמינה לשאילתה VersionedFile
באמצעות getFile(BuildInfoFileKey)
.
החזרות | |
---|---|
getVersionedFiles
publicgetVersionedFiles (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 |