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)

הוספת מאפייני build

void allowStagingRemoteFile(boolean stageRemoteFile)

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

void cleanUp()

ניקוי של קבצי build זמניים

void cleanUp( doNotClean)

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

IBuildInfo clone()

final void copyAllFileFrom(BuildInfo build)

מעתיקים את כל הקבצים מסוג VersionedFile מ-build מסוים ל-build הזה.

boolean equals(Object obj)

static IBuildInfo fromProto(BuildInformation.BuildInfo protoBuild)

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

getAppPackageFiles()

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

getBuildAttributes()

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

String getBuildBranch()

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

String getBuildFlavor()

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

String getBuildId()

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

String getBuildTargetName()

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

String getDeviceSerial()

File getFile(String name)

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

File getFile(BuildInfoKey.BuildInfoFileKey key)

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

getFiles()

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

getProperties()

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

getRemoteFiles()

הצגת הנתיבים של פריטי המידע שנוצרו בתהליך הפיתוח (artifacts) שההורדה שלהם מושהית.

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)

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

int hashCode()

void removeBuildAttribute(String attributeName)

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

void setBuildBranch(String branch)

הגדרת ההסתעפות ל-build

void setBuildFlavor(String buildFlavor)

מגדירים את סוג ה-build.

void setBuildId(String buildId)

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

void setDeviceSerial(String serial)

מגדירים את המספר הסידורי ITestDevice שמשויך לגרסה הזו.

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

שמירת קובץ בשם נתון בפרטי ה-build האלה.

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

שמירת קובץ עם BuildInfoFileKey בנתוני ה-build האלה.

void setProperties(BuildInfoProperties... properties)

מגדירים את BuildInfoProperties למופע IBuildInfo.

void setTestTag(String testTag)

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

File stageRemoteFile(String fileName, File workingDir)

העברת קובץ שנמצא בקבצים מרוחקים ל-stage בספריית הבסיס של פרטי ה-build.

BuildInformation.BuildInfo toProto()

סריאליזציה של מופע BuildInfo ל-protobuf.

String toString()

שיטות מוגנות

void addAllBuildAttributes(BuildInfo build)

שיטה מסייעת להעתקת מאפייני build, ההסתעפות והסוג מ-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: מזהה ה-build
buildTargetName String: שם היעד של ה-build

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

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)

הוספת מאפייני build

פרמטרים
buildAttributes : מפה של המאפיינים שרוצים להוסיף

allowStagingRemoteFile

public void allowStagingRemoteFile (boolean stageRemoteFile)

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

פרמטרים
stageRemoteFile boolean

cleanUp

public void cleanUp ()

ניקוי של קבצי build זמניים

cleanUp

public void cleanUp ( doNotClean)

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

פרמטרים
doNotClean

לשכפל

public IBuildInfo clone ()

החזרות
IBuildInfo

copyAllFileFrom

public final void copyAllFileFrom (BuildInfo build)

מעתיקים את כל הקבצים מסוג VersionedFile מ-build מסוים ל-build הזה.

פרמטרים
build BuildInfo

שווה ל-

public boolean equals (Object obj)

פרמטרים
obj Object

החזרות
boolean

fromProto

public static IBuildInfo fromProto (BuildInformation.BuildInfo protoBuild)

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

פרמטרים
protoBuild BuildInformation.BuildInfo

החזרות
IBuildInfo

getAppPackageFiles

public  getAppPackageFiles ()

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

החזרות

getBuildAttributes

public  getBuildAttributes ()

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

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

getBuildBranch

public String getBuildBranch ()

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

החזרות
String ההסתעפות של ה-build או null אם לא הוגדרה או לא רלוונטית

getBuildFlavor

public String getBuildFlavor ()

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

הטמעה נפוצה של גרסאות build לפלטפורמת Android היא להחזיר את הערכים (build product)-(build os)-(build variant). למשל generic-linux-userdebug

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

getBuildId

public String getBuildId ()

הפונקציה מחזירה את המזהה הייחודי של ה-build שנמצא בבדיקה. הערך לא יכול להיות null. ברירת המחדל היא UNKNOWN_BUILD_ID.

החזרות
String

getBuildTargetName

public String getBuildTargetName ()

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

הטמעה נפוצה היא ליצור את שם היעד של ה-build משילוב של סוג ה-build ושם ההסתעפות. [למשל (branch name)-(build flavor)]

החזרות
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 ()

הצגת הנתיבים של פריטי המידע שנוצרו בתהליך הפיתוח (artifacts) שההורדה שלהם מושהית.

החזרות

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)

שיטה מסייעת לאחזור רשימה של VersionedFiles שמשויכים ל-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)

הגדרת ההסתעפות ל-build

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

setBuildFlavor

public void setBuildFlavor (String buildFlavor)

מגדירים את סוג ה-build.

setBuildId

public void setBuildId (String buildId)

הגדרת המזהה הייחודי של ה-build שנמצא בבדיקה. הערך לא יכול להיות null.

פרמטרים
buildId String

setDeviceSerial

public void setDeviceSerial (String serial)

מגדירים את המספר הסידורי ITestDevice שמשויך לגרסה הזו.

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

setFile

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

שמירת קובץ בשם נתון בפרטי ה-build האלה.

פרמטרים
name String: השם הייחודי של הקובץ
file File: ERROR(/File) המקומי
version String: גרסת הקובץ

setFile

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

שמירת קובץ עם BuildInfoFileKey בנתוני ה-build האלה.

פרמטרים
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)

העברת קובץ שנמצא בקבצים מרוחקים ל-stage בספריית הבסיס של פרטי ה-build.

TODO(b/138416078): Remove this interface and its caller when modules required by a test can be properly built output to the test module's directory itself.

פרמטרים
fileName String: שם הקובץ שיהיה ממוקם בקובצי מרוחק.
workingDir File: אובייקט ERROR(/File) של הספרייה שבה רוצים להעביר את הקובץ.
החזרות
File האובייקט ERROR(/File) של הקובץ שהועמד ב-workingDir המקומי.

toProto

public BuildInformation.BuildInfo toProto ()

סריאליזציה של מופע BuildInfo ל-protobuf.

החזרות
BuildInformation.BuildInfo

toString

public String toString ()

החזרות
String

שיטות מוגנות

addAllBuildAttributes

protected void addAllBuildAttributes (BuildInfo build)

שיטה מסייעת להעתקת מאפייני build, ההסתעפות והסוג מ-build אחר.

פרמטרים
build BuildInfo

addAllFiles

protected void addAllFiles (BuildInfo build)

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

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

פרמטרים
build BuildInfo

זריקות
אם מתרחשת חריגה בזמן יצירת הקישור הקבוע.

applyBuildProperties

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

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

פרמטרים
origFileConsidered VersionedFile: הVersionedFile הנוכחי שנמצא בבדיקה.
build IBuildInfo: ה-build המקורי שרוצים לשכפל
receiver IBuildInfo: ה-build שמקבל את המידע.
החזרות
boolean הערך True אם מחילנו את המאפיינים וצריך לדלג על הטיפול הנוסף. אחרת, הערך יהיה false.

getAttributesMultiMap

protected MultiMap<String, String> getAttributesMultiMap ()

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

getVersionedFileMap

protected  getVersionedFileMap ()

החזרות

getVersionedFileMapFull

protected MultiMap<String, VersionedFile> getVersionedFileMapFull ()

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