BuildInfo

public class BuildInfo
extends Object implements IBuildInfo

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

הטמעה גנרית של IBuildInfo שצריך לשייך ל-ITestDevice.

סיכום

‫constructors ציבוריים

BuildInfo()

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

BuildInfo(String buildId, String buildTargetName)

יצירת BuildInfo

‫methods ציבוריים

void addAppPackageFile(File appPackageFile, String version)

הוספה של קובץ ה-APK המקומי והגרסה שמשויכת אליו.

void addBuildAttribute(String attributeName, String attributeValue)

מוסיפים מאפיין build.

void addBuildAttributes(Map<String, String> buildAttributes)

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

void allowStagingRemoteFile(boolean stageRemoteFile)

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

void cleanUp()

ניקוי של קבצים זמניים של גרסת build

void cleanUp(List<File> doNotClean)

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

IBuildInfo clone()

final void copyAllFileFrom(BuildInfo build)

מעתיקים את כל VersionedFile מגרסה נתונה לגרסה הזו.

boolean equals(Object obj)

static IBuildInfo fromProto(BuildInformation.BuildInfo protoBuild)

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

List<VersionedFile> getAppPackageFiles()

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

Map<String, String> getBuildAttributes()

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

String getBuildBranch()

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

String getBuildFlavor()

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

String getBuildId()

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

String getBuildTargetName()

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

String getDeviceSerial()

File getFile(String name)

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

File getFile(BuildInfoKey.BuildInfoFileKey key)

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

Collection<VersionedFile> getFiles()

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

Set<IBuildInfo.BuildInfoProperties> getProperties()

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

Set<File> getRemoteFiles()

קבלת הנתיבים של פריטי מידע שנוצרים בתהליך פיתוח (Artifact) שלא הורדו בזמן.

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 עם שם נתון.

Set<String> getVersionedFileKeys()

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

final List<VersionedFile> getVersionedFiles(BuildInfoKey.BuildInfoFileKey key)

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

int hashCode()

void removeBuildAttribute(String attributeName)

הסרה של attributeName מסוים מהמעקב.

void setBuildBranch(String branch)

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

void setBuildFlavor(String buildFlavor)

מגדירים את טעם ה-build.

void setBuildId(String buildId)

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

void setDeviceSerial(String serial)

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

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

שומר קובץ בהינתן BuildInfoFileKey בפרטי הגרסה האלה.

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

שומר קובץ עם שם נתון בפרטי הגרסה הזו.

void setProperties(BuildInfoProperties... properties)

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

void setTestTag(String testTag)

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

File stageRemoteFile(String fileName, File workingDir)

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

BuildInformation.BuildInfo toProto()

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

String toString()

שיטות מוגנות

void addAllBuildAttributes(BuildInfo build)

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

void addAllFiles(BuildInfo build)

שיטה עזר להעתקת כל הקבצים מהגרסה השנייה.

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

לאפשר להחיל חלק מההגדרות של IBuildInfo.BuildInfoProperties ולטפל בהן בצורה שונה.

MultiMap<String, String> getAttributesMultiMap()
Map<String, VersionedFile> getVersionedFileMap()
MultiMap<String, VersionedFile> getVersionedFileMapFull()

‫constructors ציבוריים

BuildInfo

public BuildInfo ()

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

BuildInfo

public BuildInfo (String buildId, 
                String buildTargetName)

יצירת BuildInfo

פרמטרים
buildId ‫String: מזהה גרסת ה-build
buildTargetName ‫String: השם של יעד הבנייה

‫methods ציבוריים

addAppPackageFile

public void addAppPackageFile (File appPackageFile, 
                String version)

הוספה של קובץ ה-APK המקומי והגרסה שמשויכת אליו. שימו לב: קובצי ה-APK יוחזרו מ-getAppPackageFiles() לפי הסדר שבו הם נוספו באמצעות השיטה הזו.

פרמטרים
appPackageFile File

version String

addBuildAttribute

public void addBuildAttribute (String attributeName, 
                String attributeValue)

מוסיפים מאפיין build. אי אפשר להשתמש בשיטה הזו כדי לבטל מאפיין קיים.

פרמטרים
attributeName String: שם המאפיין הייחודי
attributeValue ‫String: ערך המאפיין

addBuildAttributes

public void addBuildAttributes (Map<String, String> buildAttributes)

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

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

allowStagingRemoteFile

public void allowStagingRemoteFile (boolean stageRemoteFile)

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

פרמטרים
stageRemoteFile boolean

cleanUp

public void cleanUp ()

ניקוי של קבצים זמניים של גרסת build

cleanUp

public void cleanUp (List<File> doNotClean)

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

פרמטרים
doNotClean List

שכפל

public IBuildInfo clone ()

החזרות
IBuildInfo

copyAllFileFrom

public final void copyAllFileFrom (BuildInfo build)

מעתיקים את כל VersionedFile מגרסה נתונה לגרסה הזו.

פרמטרים
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 List<VersionedFile> getAppPackageFiles ()

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

החזרות
List<VersionedFile>

getBuildAttributes

public Map<String, String> getBuildAttributes ()

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

החזרות
Map<String, String> Map של מאפייני בנייה. לא יהיה null, אבל יכול להיות ריק.

getBuildBranch

public String getBuildBranch ()

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

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

getBuildFlavor

public String getBuildFlavor ()

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

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

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

getBuildId

public String getBuildId ()

מחזירה את המזהה הייחודי של הגרסה שנבדקת. הערך אף פעם לא יכול להיות null. ברירת המחדל היא UNKNOWN_BUILD_ID.

החזרות
String

getBuildTargetName

public String getBuildTargetName ()

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

הטמעה נפוצה היא בניית שם יעד הבנייה משילוב של טעם הבנייה ושם הענף. [ie (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 Collection<VersionedFile> getFiles ()

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

החזרות
Collection<VersionedFile>

getProperties

public Set<IBuildInfo.BuildInfoProperties> getProperties ()

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

החזרות
Set<IBuildInfo.BuildInfoProperties>

getRemoteFiles

public Set<File> getRemoteFiles ()

קבלת הנתיבים של פריטי מידע שנוצרים בתהליך פיתוח (Artifact) שלא הורדו בזמן.

החזרות
Set<File>

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 Set<String> getVersionedFileKeys ()

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

החזרות
Set<String>

getVersionedFiles

public final List<VersionedFile> getVersionedFiles (BuildInfoKey.BuildInfoFileKey key)

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

פרמטרים
key ‫BuildInfoKey.BuildInfoFileKey: BuildInfoFileKey שהתבקש.
החזרות
List<VersionedFile> הקובץ עם הגרסה או 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)

מגדירים את טעם ה-build.

setBuildId

public void setBuildId (String buildId)

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

פרמטרים
buildId String

setDeviceSerial

public void setDeviceSerial (String serial)

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

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

setFile

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

שומר קובץ בהינתן BuildInfoFileKey בפרטי הגרסה האלה.

פרמטרים
key ‫BuildInfoKey.BuildInfoFileKey: השם הייחודי של הקובץ על סמך BuildInfoFileKey.
file ‫File: File המקומי
version ‫String: גרסת הקובץ

setFile

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

שומר קובץ עם שם נתון בפרטי הגרסה הזו.

פרמטרים
name ‫String: השם הייחודי של הקובץ
file ‫File: 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)

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

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: אובייקט File של הספרייה שבה רוצים להכין את הקובץ.
החזרות
File האובייקט File של הקובץ שהועבר להמתנה ב-local 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)

שיטה עזר להעתקת כל הקבצים מהגרסה השנייה.

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

פרמטרים
build BuildInfo

הקפצת הודעות שגיאה (throw)
IOException אם מתרחשת חריגה במהלך יצירת הקישור הקשיח.

applyBuildProperties

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

לאפשר להחיל חלק מההגדרות של IBuildInfo.BuildInfoProperties ולטפל בהן בצורה שונה.

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

getAttributesMultiMap

protected MultiMap<String, String> getAttributesMultiMap ()

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

getVersionedFileMap

protected Map<String, VersionedFile> getVersionedFileMap ()

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

getVersionedFileMapFull

protected MultiMap<String, VersionedFile> getVersionedFileMapFull ()

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