BuildInfo

public class BuildInfo
extends Object implements IBuildInfo

java.lang.Object
↳	com.android.tradefed.build.BuildInfo

תת מחלקות ישירות ידועות AppBuildInfo , DeviceBuildInfo , FolderBuildInfo , OtatoolsBuildInfo AppBuildInfo IBuildInfo המייצג אפליקציית אנדרואיד וחבילות הבדיקה שלה. DeviceBuildInfo IBuildInfo המייצג מבנה שלם של מכשיר אנדרואיד ו(אופציונלי) הבדיקות שלו. FolderBuildInfo יישום קונקרטי של IFolderBuildInfo . OtatoolsBuildInfo IBuildInfo שמכיל חפצי אוטטולס.

תת-מחלקות עקיפות ידועות AppDeviceBuildInfo , ClusterBuildInfo , DeviceFolderBuildInfo , OtaDeviceBuildInfo AppDeviceBuildInfo מחלקה זו הוצאה משימוש. השתמש ישירות IDeviceBuildInfo . ClusterBuildInfo מחלקה IBuildInfo ל-builds מ-TFC. DeviceFolderBuildInfo IDeviceBuildInfo שמכיל גם חפצי בנייה אחרים הכלולים בספרייה במערכת הקבצים המקומית. OtaDeviceBuildInfo IDeviceBuildInfo המשמש לבדיקת עדכונים באוויר.

---

הטמעה כללית של IBuildInfo שאמורה להיות משויכת ל- ITestDevice .

סיכום

בנאים ציבוריים
BuildInfo () יוצר BuildInfo באמצעות ערכי ברירת מחדל של תכונה.
BuildInfo (String buildId, String buildTargetName) יוצר BuildInfo

שיטות ציבוריות
void	addAppPackageFile (File appPackageFile, String version) מוסיף את קובץ ה-apk המקומי ואת הגרסה הקשורה אליו.
void	addBuildAttribute (String attributeName, String attributeValue) הוסף מאפיין build.
void	addBuildAttributes ( buildAttributes) addBuildAttributes ( buildAttributes) הוסף תכונות בנייה
void	cleanUp () נקה כל קבצי בנייה זמניים
void	cleanUp ( doNotClean) cleanUp ( doNotClean) גרסה של cleanUp() שבה חלק מהקבצים לא נמחקים.
IBuildInfo	clone ()
final void	copyAllFileFrom ( BuildInfo build) העתק את כל ה- VersionedFile ממבנה נתון לקובץ הזה.
boolean	equals (Object obj)
static IBuildInfo	fromProto (BuildInformation.BuildInfo protoBuild) פעולה הפוכה ל- toProto() כדי להחזיר את המופע.
	getAppPackageFiles () מקבל עותק של ערכת קבצי ה-apk של האפליקציה המקומית וגרסאותיהם.
	getBuildAttributes () קבל קבוצה של זוגות שם-ערך של תכונות נוספות המתארות את המבנה.
String	getBuildBranch () שיטה אופציונלית להחזרת ענף בקרת המקור שממנו הופק ה-build הנבדק.
String	getBuildFlavor () שיטה אופציונלית להחזרת סוג ה-build הנבדק.
String	getBuildId () מחזירה את המזהה הייחודי של הבנייה בבדיקה.
String	getBuildTargetName () החזר שם מלא למבנה הנבדק.
String	getDeviceSerial ()
File	getFile (String name) שיטת עוזר לאחזור קובץ בשם נתון.
File	getFile ( BuildInfoKey.BuildInfoFileKey key) שיטת עוזר לאחזור קובץ עם נתון BuildInfoFileKey .
	getFiles () מחזירה את כל VersionedFile המאוחסנים ב- BuildInfo זה.
	getProperties () מחזיר עותק של המאפיינים המוגדרים כעת ב- IBuildInfo .
	getRemoteFiles () קבל את הנתיבים לבניית חפצים שמתעכבים בהורדה.
String	getTestTag () החזר שם ייחודי עבור הבדיקות המתנהלות.
String	getVersion ( BuildInfoKey.BuildInfoFileKey key) שיטת עוזר לאחזר גירסת קובץ עם נתון BuildInfoFileKey .
String	getVersion (String name) שיטת עוזר לאחזר גרסת קובץ עם שם נתון.
VersionedFile	getVersionedFile ( BuildInfoKey.BuildInfoFileKey key) שיטת עוזר לאחזר קובץ VersionedFile עם מפתח נתון BuildInfoFileKey .
final VersionedFile	getVersionedFile (String name) שיטת עוזר לאחזר VersionedFile עם שם נתון.
	getVersionedFileKeys () מחזירה את ערכת המפתחות הזמינה לשאילתה VersionedFile באמצעות getFile(BuildInfoFileKey) .
final	getVersionedFiles ( BuildInfoKey.BuildInfoFileKey key) שיטת מסייע לאחזור רשימה של VersionedFile המשויכים ל- BuildInfoFileKey נתון.
int	hashCode ()
void	removeBuildAttribute (String attributeName) הסר attributeName נתון מהמעקב.
void	setBuildBranch (String branch) הגדר את ענף הבנייה
void	setBuildFlavor (String buildFlavor) הגדר את טעם המבנה.
void	setBuildId (String buildId) מגדיר את המזהה הייחודי של בנייה בבדיקה.
void	setDeviceSerial (String serial) הגדר את סדרת ITestDevice המשויכת ל-build זה.
void	setFile (String name, File file, String version) מאחסן קובץ בשם נתון בפרטי הבנייה הזה.
void	setFile ( BuildInfoKey.BuildInfoFileKey key, File file, String version) מאחסן קובץ שקיבל BuildInfoFileKey במידע בנייה זה.
void	setProperties ( BuildInfoProperties... properties) הגדר את BuildInfoProperties עבור מופע IBuildInfo .
void	setTestTag (String testTag) מגדיר את השם הייחודי לבדיקות המופעלות.
File	stageRemoteFile (String fileName, File workingDir) שלב קובץ שהוא חלק מקבצים מרוחקים ב-Dir root של מידע ה-build.
BuildInformation.BuildInfo	toProto () הפוך את המופע של BuildInfo ל-protobuf.
String	toString ()

שיטות מוגנות
void	addAllBuildAttributes ( BuildInfo build) שיטת עוזר להעתקת תכונות בנייה, ענף וטעם ממבנה אחר.
void	addAllFiles ( BuildInfo build) שיטת עוזר להעתקת כל הקבצים מה-build השני.
boolean	applyBuildProperties ( VersionedFile origFileConsidered, IBuildInfo build, IBuildInfo receiver) אפשר להחיל חלק מהמאפיינים IBuildInfo.BuildInfoProperties ואולי בצע טיפול אחר.
MultiMap <String, String>	getAttributesMultiMap ()
	getVersionedFileMap ()
MultiMap <String, VersionedFile >	getVersionedFileMapFull ()

בנאים ציבוריים

BuildInfo

public BuildInfo ()

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

BuildInfo

public BuildInfo (String buildId, 
                String buildTargetName)

יוצר BuildInfo

פרמטרים
buildId	String : מזהה הבנייה
buildTargetName	String : שם יעד הבנייה

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

addAppPackageFile

public void addAppPackageFile (File appPackageFile, 
                String version)

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

פרמטרים
appPackageFile	File
version	String

addBuildAttribute

public void addBuildAttribute (String attributeName, 
                String attributeValue)

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

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

addBuildAttributes

public void addBuildAttributes ( buildAttributes)

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

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

לנקות

public void cleanUp ()

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

לנקות

public void cleanUp ( doNotClean)

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

פרמטרים
doNotClean

שיבוט

public IBuildInfo clone ()

החזרות
IBuildInfo

copyAllFileFrom

public final void copyAllFileFrom (BuildInfo build)

העתק את כל ה- VersionedFile ממבנה נתון לקובץ הזה.

פרמטרים
build	BuildInfo

שווים

public boolean equals (Object obj)

פרמטרים
obj	Object

החזרות
boolean

מפרוטו

public static IBuildInfo fromProto (BuildInformation.BuildInfo protoBuild)

פעולה הפוכה ל- toProto() כדי להחזיר את המופע.

פרמטרים
protoBuild	BuildInformation.BuildInfo

החזרות
IBuildInfo

getAppPackageFiles

public  getAppPackageFiles ()

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

החזרות

getBuildAttributes

public  getBuildAttributes ()

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

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

getBuildBranch

public String getBuildBranch ()

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

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

getBuildFlavor

public String getBuildFlavor ()

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

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

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

getBuildId

public String getBuildId ()

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

החזרות
String

getBuildTargetName

public String getBuildTargetName ()

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

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

החזרות
String

getDeviceSerial

public String getDeviceSerial ()

החזרות
String

getFile

public File getFile (String name)

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

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

getFile

public File getFile (BuildInfoKey.BuildInfoFileKey key)

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

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

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

getFiles

public  getFiles ()

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

החזרות

getProperties

public  getProperties ()

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

החזרות

getRemoteFiles

public  getRemoteFiles ()

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

החזרות

getTestTag

public String getTestTag ()

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

החזרות
String

getVersion

public String getVersion (BuildInfoKey.BuildInfoFileKey key)

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

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

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

getVersion

public String getVersion (String name)

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

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

getVersionedFile

public VersionedFile getVersionedFile (BuildInfoKey.BuildInfoFileKey key)

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

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

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

getVersionedFile

public final VersionedFile getVersionedFile (String name)

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

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

getVersionedFileKeys

public  getVersionedFileKeys ()

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

החזרות

getVersionedFiles

public final  getVersionedFiles (BuildInfoKey.BuildInfoFileKey key)

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

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

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

hashcode

public int hashCode ()

החזרות
int

removeBuildAttribute

public void removeBuildAttribute (String attributeName)

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

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

setBuildBranch

public void setBuildBranch (String branch)

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

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

setBuildFlavor

public void setBuildFlavor (String buildFlavor)

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

setBuildId

public void setBuildId (String buildId)

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

פרמטרים
buildId	String

setDeviceSerial

public void setDeviceSerial (String serial)

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

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

setFile

public 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 void setProperties (BuildInfoProperties... properties)

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

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

setTestTag

public 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

toString

public String toString ()

החזרות
String

שיטות מוגנות

addAllBuildAttributes

protected void addAllBuildAttributes (BuildInfo build)

שיטת עוזר להעתקת תכונות בנייה, ענף וטעם ממבנה אחר.

פרמטרים
build	BuildInfo

addAllFiles

protected void addAllFiles (BuildInfo build)

שיטת עוזר להעתקת כל הקבצים מה-build השני.

יוצר קישורים קשיחים חדשים לקבצים כך שלכל build יהיה נתיב קובץ ייחודי לקובץ.

פרמטרים
build	BuildInfo

זורק
	אם נזרק חריג בעת יצירת ה-hardlink.

applicationBuildProperties

protected boolean applyBuildProperties (VersionedFile origFileConsidered, 
                IBuildInfo build, 
                IBuildInfo receiver)

אפשר להחיל חלק מהמאפיינים IBuildInfo.BuildInfoProperties ואולי בצע טיפול אחר.

פרמטרים
origFileConsidered	VersionedFile : הקובץ הנבדק כעת על VersionedFile .
build	IBuildInfo : המבנה המקורי המשובט
receiver	IBuildInfo : ה-build שמקבל את המידע.

החזרות
boolean	נכון אם החלנו את המאפיינים ויש לדלג על טיפול נוסף. שקר אחרת.

getAttributesMultiMap

protected MultiMap<String, String> getAttributesMultiMap ()

החזרות
MultiMap <String, String>

getVersionedFileMap

protected  getVersionedFileMap ()

החזרות

getVersionedFileMapFull

protected MultiMap<String, VersionedFile> getVersionedFileMapFull ()

החזרות
MultiMap <String, VersionedFile >