מידע על Build

public class BuildInfo
extends Object implements IBuildInfo

JavaScript.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 הזה לגרסה הזו.

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()

קבלת הנתיבים לפריטי מידע שנוצרו בתהליך פיתוח (Artifact) של ה-build שיש עיכוב בהורדה.

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)

מסירים שם מאפיין נתון מהמעקב.

void setBuildBranch(String branch)

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

void setBuildFlavor(String buildFlavor)

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

void setBuildId(String buildId)

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

void setDeviceSerial(String serial)

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

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)

מעבירים קובץ כחלק מקבצים מרוחקים ב-Root dir של פרטי ה-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()

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

מידע על Build

public BuildInfo ()

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

מידע על Build

public BuildInfo (String buildId, 
                String buildTargetName)

יצירת BuildInfo

פרמטרים
buildId String: מזהה ה-build
buildTargetName String: השם של יעד ה-build

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

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 ( buildAttributes)

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

פרמטרים
buildAttributes : מפת המאפיינים להוספה

AllowStagingremoteFile

public void allowStagingRemoteFile (boolean stageRemoteFile)

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

פרמטרים
stageRemoteFile boolean

ניקוי

public void cleanUp ()

מחיקת קובצי build זמניים

ניקוי

public void cleanUp ( doNotClean)

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

פרמטרים
doNotClean

לשכפל

public IBuildInfo clone ()

החזרות
IBuildInfo

CopyAllFileFrom (העתקה

public final void copyAllFileFrom (BuildInfo build)

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

פרמטרים
build BuildInfo

שווה ל-

public boolean equals (Object obj)

פרמטרים
obj Object

החזרות
boolean

מ-Proto

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 version). למשל, generic-linux-userdebug

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

getBuildId

public String getBuildId ()

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

החזרות
String

getBuildTargetName

public String getBuildTargetName ()

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

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

החזרות
String

getDeviceSeries

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 ()

קבלת הנתיבים לפריטי מידע שנוצרו בתהליך פיתוח (Artifact) של ה-build שיש עיכוב בהורדה.

החזרות

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 String: המאפיין שצריך להפסיק את המעקב

setBuildBranch

public void setBuildBranch (String branch)

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

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

setBuildFlavor (הגדרת BuildFlavor)

public void setBuildFlavor (String buildFlavor)

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

setBuildId

public void setBuildId (String buildId)

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

פרמטרים
buildId String

setDeviceSeries

public void setDeviceSerial (String serial)

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

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

St Remote File

public File stageRemoteFile (String fileName, 
                File workingDir)

מעבירים קובץ כחלק מקבצים מרוחקים ב-Root dir של פרטי ה-build.

TODO(b/138416078): הסרת הממשק הזה ואת הקריאה שלו כאשר מודולים נדרשים על ידי בדיקה יכול להיות מובנה כפלט לספרייה של מודול הבדיקה עצמה.

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

לפרוטו

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 האחר.

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

פרמטרים
build BuildInfo

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

החלתBuildProperties

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

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

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

getAttributesMultiMap

protected MultiMap<String, String> getAttributesMultiMap ()

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

getVersionedFileMap

protected  getVersionedFileMap ()

החזרות

getVersionedFileMapFull

protected MultiMap<String, VersionedFile> getVersionedFileMapFull ()

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