BuildInfo
public
class
BuildInfo
extends Object
implements
IBuildInfo
java.lang.Object | |
↳ | com.android.tradefed.build.BuildInfo |
הטמעה גנרית של IBuildInfo
שצריך לשייך ל-ITestDevice
.
סיכום
קונסטרוקטורים גלויים לכולם | |
---|---|
BuildInfo()
יצירת |
|
BuildInfo(String buildId, String buildTargetName)
יצירת |
שיטות ציבוריות | |
---|---|
void
|
addAppPackageFile(File appPackageFile, String version)
הוספת קובץ ה-apk המקומי והגרסה המשויכת אליו. |
void
|
addBuildAttribute(String attributeName, String attributeValue)
מוסיפים מאפיין build. |
void
|
addBuildAttributes(
הוספת מאפייני build |
void
|
allowStagingRemoteFile(boolean stageRemoteFile)
הגדרת הרשאה שמאפשרת להעביר קבצים מרוחקים ל-staging. |
void
|
cleanUp()
ניקוי של קבצי build זמניים |
void
|
cleanUp(
גרסה של |
IBuildInfo
|
clone()
|
final
void
|
copyAllFileFrom(BuildInfo build)
מעתיקים את כל הקבצים מסוג |
boolean
|
equals(Object obj)
|
static
IBuildInfo
|
fromProto(BuildInformation.BuildInfo protoBuild)
מבצעים פעולה הפוכה ל- |
|
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)
שיטה מסייעת לאחזור קובץ עם |
|
getFiles()
הפונקציה מחזירה את כל ה- |
|
getProperties()
הפונקציה מחזירה עותק של המאפיינים שמוגדרים כרגע ב- |
|
getRemoteFiles()
הצגת הנתיבים של פריטי המידע שנוצרו בתהליך הפיתוח (artifacts) שההורדה שלהם מושהית. |
String
|
getTestTag()
החזרת שם ייחודי לבדיקות שפועלות. |
String
|
getVersion(BuildInfoKey.BuildInfoFileKey key)
שיטה מסייעת לאחזור גרסת קובץ לפי |
String
|
getVersion(String name)
שיטה מסייעת לאחזור גרסה של קובץ עם שם נתון. |
VersionedFile
|
getVersionedFile(BuildInfoKey.BuildInfoFileKey key)
שיטה מסייעת לאחזור |
final
VersionedFile
|
getVersionedFile(String name)
שיטה מסייעת לאחזור |
|
getVersionedFileKeys()
הפונקציה מחזירה את קבוצת המפתחות שזמינים לשאילתה |
final
|
getVersionedFiles(BuildInfoKey.BuildInfoFileKey key)
שיטה מסייעת לאחזור רשימה של |
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)
מגדירים את המספר הסידורי |
void
|
setFile(String name, File file, String version)
שמירת קובץ בשם נתון בפרטי ה-build האלה. |
void
|
setFile(BuildInfoKey.BuildInfoFileKey key, File file, String version)
שמירת קובץ עם |
void
|
setProperties(BuildInfoProperties... properties)
מגדירים את |
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)
מאפשרים להחיל חלק מהאפשרויות של |
MultiMap<String, String>
|
getAttributesMultiMap()
|
|
getVersionedFileMap()
|
MultiMap<String, VersionedFile>
|
getVersionedFileMapFull()
|
קונסטרוקטורים גלויים לכולם
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 |
|
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
publicgetAppPackageFiles ()
הפונקציה מקבלת עותק של קבוצת קובצי ה-APK המקומיים של האפליקציה והגרסאות שלהם. הסדר המוחזר תואם לסדר שבו קובצי ה-apk נוספו ל-IAppBuildInfo
.
החזרות | |
---|---|
|
getBuildAttributes
publicgetBuildAttributes ()
הצגת קבוצה של צמדי שם-ערך של מאפיינים נוספים שמתארים את ה-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 אם הוא לא נמצא |
getProperties
publicgetProperties ()
הפונקציה מחזירה עותק של המאפיינים שמוגדרים כרגע ב-IBuildInfo
.
החזרות | |
---|---|
|
getRemoteFiles
publicgetRemoteFiles ()
הצגת הנתיבים של פריטי המידע שנוצרו בתהליך הפיתוח (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
publicgetVersionedFileKeys ()
הפונקציה מחזירה את קבוצת המפתחות שזמינים לשאילתה VersionedFile
דרך getFile(BuildInfoFileKey)
.
החזרות | |
---|---|
|
getVersionedFiles
public finalgetVersionedFiles (BuildInfoKey.BuildInfoFileKey key)
שיטה מסייעת לאחזור רשימה של VersionedFile
s שמשויכים ל-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
protectedgetVersionedFileMap ()
החזרות | |
---|---|
|
getVersionedFileMapFull
protected MultiMap<String, VersionedFile> getVersionedFileMapFull ()
החזרות | |
---|---|
MultiMap<String, VersionedFile> |