معلومات البناء
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) إضافة سمة البناء. |
void | addBuildAttributes ( buildAttributes) addBuildAttributes ( buildAttributes) إضافة سمات البناء |
void | allowStagingRemoteFile (boolean stageRemoteFile) يضبط الإذن للسماح بتنظيم الملفات عن بعد. |
void | cleanUp () تنظيف أي ملفات بناء مؤقتة |
void | cleanUp ( doNotClean) cleanUp ( doNotClean) إصدار |
IBuildInfo | clone () |
final void | copyAllFileFrom ( BuildInfo build) انسخ كل |
boolean | equals (Object obj) |
static IBuildInfo | fromProto (BuildInformation.BuildInfo protoBuild) العملية العكسية لـ |
getAppPackageFiles () الحصول على نسخة من مجموعة ملفات (ملفات) APK للتطبيقات المحلية وإصداراتها. | |
getBuildAttributes () احصل على مجموعة من أزواج الاسم والقيمة للسمات الإضافية التي تصف البنية. | |
String | getBuildBranch () طريقة اختيارية لإرجاع فرع التحكم بالمصدر الذي تم إنتاج البنية الجاري اختبارها منها. |
String | getBuildFlavor () طريقة اختيارية لإرجاع نوع البناء الذي يتم اختباره. |
String | getBuildId () إرجاع المعرف الفريد للبناء قيد الاختبار. |
String | getBuildTargetName () قم بإرجاع الاسم الكامل للبنية التي يتم اختبارها. |
String | getDeviceSerial () |
File | getFile (String name) طريقة مساعد لاسترداد ملف بالاسم المحدد. |
File | getFile ( BuildInfoKey.BuildInfoFileKey key) أسلوب مساعد لاسترداد ملف باستخدام |
getFiles () تقوم بإرجاع جميع | |
getProperties () إرجاع نسخة من الخصائص المعينة حاليًا على | |
getRemoteFiles () احصل على مسارات عناصر البناء التي تأخر تنزيلها. | |
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) تعيين فرع البناء |
void | setBuildFlavor (String buildFlavor) ضبط نكهة البناء. |
void | setBuildId (String buildId) يعين المعرف الفريد للبناء قيد الاختبار. |
void | setDeviceSerial (String serial) قم بتعيين مسلسل |
void | setFile (String name, File file, String version) يخزن ملفًا بالاسم المحدد في معلومات البناء هذه. |
void | setFile ( BuildInfoKey.BuildInfoFileKey key, File file, String version) يخزن ملفًا معطى |
void | setProperties ( BuildInfoProperties... properties) قم بتعيين |
void | setTestTag (String testTag) يضبط الاسم الفريد للاختبارات التي يتم إجراؤها. |
File | stageRemoteFile (String fileName, File workingDir) قم بتنظيم ملف يمثل جزءًا من الملفات البعيدة في الدليل الجذر لمعلومات البناء. |
BuildInformation.BuildInfo | toProto () قم بإجراء تسلسل لمثيل BuildInfo في protobuf. |
String | toString ()
|
الأساليب المحمية | |
---|---|
void | addAllBuildAttributes ( BuildInfo build) طريقة مساعدة لنسخ سمات البناء والفروع والنكهة من البنية الأخرى. |
void | addAllFiles ( BuildInfo build) طريقة مساعد لنسخ كافة الملفات من البنية الأخرى. |
boolean | applyBuildProperties ( VersionedFile origFileConsidered, IBuildInfo build, IBuildInfo receiver) السماح بتطبيق بعض |
MultiMap <String, String> | getAttributesMultiMap () |
getVersionedFileMap () | |
MultiMap <String, VersionedFile > | getVersionedFileMapFull () |
المقاولين العامة
معلومات البناء
public BuildInfo (String buildId, String buildTargetName)
إنشاء BuildInfo
حدود | |
---|---|
buildId | String : معرف البناء |
buildTargetName | String : اسم هدف البناء |
الأساليب العامة
addAppPackageFile
public void addAppPackageFile (File appPackageFile, String version)
يضيف ملف APK المحلي والإصدار المرتبط به. لاحظ أنه سيتم إرجاع التطبيقات من getAppPackageFiles()
بالترتيب الذي تمت إضافتها به بهذه الطريقة.
حدود | |
---|---|
appPackageFile | File |
version | String |
addBuildAttribute
public void addBuildAttribute (String attributeName, String attributeValue)
إضافة سمة البناء. لا يسمح هذا بتجاوز attributeName الموجود.
حدود | |
---|---|
attributeName | String : اسم السمة الفريدة |
attributeValue | String : قيمة السمة |
addBuildAttributes
public void addBuildAttributes (buildAttributes)
إضافة سمات البناء
حدود | |
---|---|
buildAttributes |
allowStagingRemoteFile
public void allowStagingRemoteFile (boolean stageRemoteFile)
يضبط الإذن للسماح بتنظيم الملفات عن بعد.
حدود | |
---|---|
stageRemoteFile | boolean |
تنظيف
public void cleanUp ()
تنظيف أي ملفات بناء مؤقتة
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
publicgetAppPackageFiles ()
الحصول على نسخة من مجموعة ملفات (ملفات) APK للتطبيقات المحلية وإصداراتها. يتطابق الترتيب الذي تم إرجاعه مع الترتيب الذي تمت به إضافة التطبيقات إلى IAppBuildInfo
.
عائدات | |
---|---|
getBuildAttributes
publicgetBuildAttributes ()
احصل على مجموعة من أزواج الاسم والقيمة للسمات الإضافية التي تصف البنية.
عائدات | |
---|---|
ERROR(/Map) لسمات البناء. لن تكون null ، ولكن قد تكون فارغة. |
getBuildBranch
public String getBuildBranch ()
طريقة اختيارية لإرجاع فرع التحكم بالمصدر الذي تم إنتاج البنية الجاري اختبارها منها.
عائدات | |
---|---|
String | فرع البناء أو null إذا لم يتم تعيينه/غير قابل للتطبيق |
getBuildFlavor
public String getBuildFlavor ()
طريقة اختيارية لإرجاع نوع البناء الذي يتم اختباره.
أحد التطبيقات الشائعة لبناء نظام Android الأساسي هو إرجاع (منتج البناء)-(بناء نظام التشغيل)-(متغير البناء). على سبيل المثال، Linux-userdebug العام
عائدات | |
---|---|
String | نكهة البناء أو null إذا لم يتم ضبطها/غير قابلة للتطبيق |
getBuildId
public String getBuildId ()
إرجاع المعرف الفريد للبناء قيد الاختبار. لا ينبغي أبدا أن تكون فارغة. الإعدادات الافتراضية هي UNKNOWN_BUILD_ID
.
عائدات | |
---|---|
String |
getBuildTargetName
public String getBuildTargetName ()
قم بإرجاع الاسم الكامل للبنية التي يتم اختبارها.
التنفيذ الشائع هو إنشاء اسم هدف البناء من مزيج من نكهة البناء واسم الفرع. [أي (اسم الفرع)-(بناء النكهة)]
عائدات | |
---|---|
String |
getDeviceSerial
public String getDeviceSerial ()
عائدات | |
---|---|
String |
خذ الملف
public File getFile (String name)
طريقة مساعد لاسترداد ملف بالاسم المحدد.
عائدات | |
---|---|
File | ملف الصورة أو null إذا لم يتم العثور عليه |
خذ الملف
public File getFile (BuildInfoKey.BuildInfoFileKey key)
أسلوب مساعد لاسترداد ملف باستخدام BuildInfoFileKey
.
حدود | |
---|---|
key | BuildInfoKey.BuildInfoFileKey : BuildInfoFileKey المطلوب. |
عائدات | |
---|---|
File | ملف الصورة أو null إذا لم يتم العثور عليه |
getRemoteFiles
publicgetRemoteFiles ()
احصل على مسارات عناصر البناء التي تأخر تنزيلها.
عائدات | |
---|---|
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
المرتبطة بمفتاح 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
المرتبط بهذا الإصدار.
حدود | |
---|---|
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)
قم بتنظيم ملف يمثل جزءًا من الملفات البعيدة في الدليل الجذر لمعلومات البناء.
TODO(b/138416078): قم بإزالة هذه الواجهة والمتصل بها عندما يمكن بناء مخرجات الوحدات المطلوبة بواسطة الاختبار بشكل صحيح إلى دليل وحدة الاختبار نفسها.
حدود | |
---|---|
fileName | String : اسم الملف الذي سيتم تحديد موقعه في الملفات البعيدة. |
workingDir | File : كائن ERROR(/File) في الدليل لتنظيم الملف. |
عائدات | |
---|---|
File | كائن ERROR(/File) للملف الذي تم تنظيمه في WorkingDir المحلي. |
toProto
public BuildInformation.BuildInfo toProto ()
قم بإجراء تسلسل لمثيل BuildInfo في protobuf.
عائدات | |
---|---|
BuildInformation.BuildInfo |
إلى سلسلة
public String toString ()
عائدات | |
---|---|
String |
الأساليب المحمية
addAllBuildAttributes
protected void addAllBuildAttributes (BuildInfo build)
طريقة مساعدة لنسخ سمات البناء والفروع والنكهة من البنية الأخرى.
حدود | |
---|---|
build | BuildInfo |
addAllFiles
protected void addAllFiles (BuildInfo build)
طريقة مساعد لنسخ كافة الملفات من البنية الأخرى.
يقوم بإنشاء روابط صلبة جديدة للملفات بحيث يكون لكل إصدار مسار ملف فريد للملف.
حدود | |
---|---|
build | BuildInfo |
رميات | |
---|---|
| إذا تم طرح استثناء عند إنشاء الارتباط الثابت. |
ApplyBuildProperties
protected boolean applyBuildProperties (VersionedFile origFileConsidered, IBuildInfo build, IBuildInfo receiver)
السماح بتطبيق بعض IBuildInfo.BuildInfoProperties
وربما إجراء معالجة مختلفة.
حدود | |
---|---|
origFileConsidered | VersionedFile : VersionedFile الذي يتم النظر إليه حاليًا. |
build | IBuildInfo : يتم استنساخ البنية الأصلية |
receiver | IBuildInfo : البنية التي تتلقى المعلومات. |
عائدات | |
---|---|
boolean | صحيح إذا طبقنا الخصائص ويجب تخطي المزيد من المعالجة. باطل غير ذلك. |
getAttributesMultiMap
protected MultiMap<String, String> getAttributesMultiMap ()
عائدات | |
---|---|
MultiMap <String, String> |
getVersionedFileMap
protectedgetVersionedFileMap ()
عائدات | |
---|---|
getVersionedFileMapFull
protected MultiMap<String, VersionedFile> getVersionedFileMapFull ()
عائدات | |
---|---|
MultiMap <String, VersionedFile > |