معلومات البناء
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 | 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) إزالة اسم سمة معطى من التعقب. |
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 | String : اسم السمة الفريدة |
attributeValue | String : قيمة السمة |
addBuildAttributes
public void addBuildAttributes (buildAttributes)
أضف سمات البناء
حدود | |
---|---|
buildAttributes |
تنظيف
public void cleanUp ()
نظف أي ملفات بناء مؤقتة
copyAllFileFrom
public final void copyAllFileFrom (BuildInfo build)
انسخ جميع ملفات VersionedFile
من بناء معين إلى هذا الإصدار.
حدود | |
---|---|
build | BuildInfo |
يساوي
public boolean equals (Object obj)
حدود | |
---|---|
obj | Object |
عائدات | |
---|---|
boolean |
من Proto
public static IBuildInfo fromProto (BuildInformation.BuildInfo protoBuild)
العملية العكسية إلى toProto()
لاستعادة المثيل.
حدود | |
---|---|
protoBuild | BuildInformation.BuildInfo |
عائدات | |
---|---|
IBuildInfo |
getAppPackageFiles
publicgetAppPackageFiles ()
الحصول على نسخة من مجموعة ملفات apk للتطبيق المحلي وإصداراتها. يتطابق الترتيب الذي تم إرجاعه مع الترتيب الذي تمت إضافة التطبيقات به إلى IAppBuildInfo
.
عائدات | |
---|---|
getBuildAttributes
publicgetBuildAttributes ()
احصل على مجموعة من أزواج الاسم والقيمة من السمات الإضافية التي تصف البناء.
عائدات | |
---|---|
a ERROR(/Map) سمات البناء. لن تكون null ، لكنها قد تكون فارغة. |
getBuildBranch
public String getBuildBranch ()
طريقة اختيارية لإرجاع فرع التحكم بالمصدر الذي تم إنتاج البناء الذي يجري اختباره منه.
عائدات | |
---|---|
String | فرع البناء أو null إذا لم يتم ضبطه / لا ينطبق |
getBuildFlavor
public String getBuildFlavor ()
طريقة اختيارية لإرجاع نوع البناء الذي يتم اختباره.
التنفيذ الشائع لإصدارات نظام Android هو إرجاع (منتج البناء) - (إصدار نظام التشغيل) - (متغير الإنشاء). أي generic-linux-userdebug
عائدات | |
---|---|
String | نكهة البناء أو null إذا لم يتم ضبطها / لا تنطبق |
getBuildId
public String getBuildId ()
إرجاع المعرف الفريد للبناء قيد الاختبار. لا ينبغي أبدا أن تكون فارغة. افتراضات على UNKNOWN_BUILD_ID
.
عائدات | |
---|---|
String |
getBuildTargetName
public String getBuildTargetName ()
إرجاع الاسم الكامل للبناء قيد الاختبار.
التنفيذ الشائع هو بناء اسم هدف البناء من مزيج من نكهة البناء واسم الفرع. [ie (اسم الفرع) - (بناء النكهة)]
عائدات | |
---|---|
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 | 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 الذي تم تنفيذ هذا الإصدار معه. |
تعيين ملف
public void setFile (String name, File file, String version)
يخزن ملفًا باسم معين في معلومات البناء هذه.
حدود | |
---|---|
name | String : الاسم الفريد للملف |
file | File : ERROR(/File) |
version | String : إصدار الملف |
تعيين ملف
public void setFile (BuildInfoKey.BuildInfoFileKey key, File file, String version)
يخزن ملفًا يعطي BuildInfoFileKey
في معلومات البناء هذه.
حدود | |
---|---|
key | BuildInfoKey.BuildInfoFileKey : الاسم الفريد للملف المستند إلى BuildInfoFileKey . |
file | File : ERROR(/File) |
version | String : إصدار الملف |
مجموعة عقارات
public void setProperties (BuildInfoProperties... properties)
قم بتعيين BuildInfoProperties
لمثيل IBuildInfo
. تجاوز أي خصائص حالية تم تعيينها من قبل.
حدود | |
---|---|
properties | BuildInfoProperties : قائمة الخصائص المراد إضافتها. |
setTestTag
public void setTestTag (String testTag)
يعيّن الاسم الفريد للاختبارات قيد التشغيل.
حدود | |
---|---|
testTag | String |
المرحلة
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 > |