BuildInfo

public class BuildInfo
extends Object implements IBuildInfo

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

הטמעה כללית של 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 >