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 ()
إنشاء BuildInfo
باستخدام قيم السمات الافتراضية.
public BuildInfo (String buildId, String buildTargetName)
إنشاء BuildInfo
حدود | |
---|---|
buildId | String : معرف البناء |
buildTargetName | String : اسم هدف البناء |
public void addAppPackageFile (File appPackageFile, String version)
يضيف ملف APK المحلي والإصدار المرتبط به. لاحظ أنه سيتم إرجاع التطبيقات من getAppPackageFiles()
بالترتيب الذي تمت إضافتها به بهذه الطريقة.
حدود | |
---|---|
appPackageFile | File |
version | String |
public void addBuildAttribute (String attributeName, String attributeValue)
إضافة سمة البناء. لا يسمح هذا بتجاوز attributeName الموجود.
حدود | |
---|---|
attributeName | String : اسم السمة الفريدة |
attributeValue | String : قيمة السمة |
public void addBuildAttributes (buildAttributes)
إضافة سمات البناء
حدود | |
---|---|
buildAttributes |
public void allowStagingRemoteFile (boolean stageRemoteFile)
يضبط الإذن للسماح بتنظيم الملفات عن بعد.
حدود | |
---|---|
stageRemoteFile | boolean |
public void cleanUp ()
تنظيف أي ملفات بناء مؤقتة
public void cleanUp (doNotClean)
إصدار cleanUp()
حيث لا يتم حذف بعض الملفات.
حدود | |
---|---|
doNotClean |
public IBuildInfo clone ()
عائدات | |
---|---|
IBuildInfo |
public final void copyAllFileFrom (BuildInfo build)
انسخ كل VersionedFile
من إصدار معين إلى هذا الإصدار.
حدود | |
---|---|
build | BuildInfo |
public boolean equals (Object obj)
حدود | |
---|---|
obj | Object |
عائدات | |
---|---|
boolean |
public static IBuildInfo fromProto (BuildInformation.BuildInfo protoBuild)
العملية العكسية لـ toProto()
لاستعادة المثيل.
حدود | |
---|---|
protoBuild | BuildInformation.BuildInfo |
عائدات | |
---|---|
IBuildInfo |
publicgetAppPackageFiles ()
الحصول على نسخة من مجموعة ملفات (ملفات) APK للتطبيقات المحلية وإصداراتها. يتطابق الترتيب الذي تم إرجاعه مع الترتيب الذي تمت به إضافة التطبيقات إلى IAppBuildInfo
.
عائدات | |
---|---|
publicgetBuildAttributes ()
احصل على مجموعة من أزواج الاسم والقيمة للسمات الإضافية التي تصف البنية.
عائدات | |
---|---|
ERROR(/Map) لسمات البناء. لن تكون null ، ولكن قد تكون فارغة. |
public String getBuildBranch ()
طريقة اختيارية لإرجاع فرع التحكم بالمصدر الذي تم إنتاج البنية الجاري اختبارها منها.
عائدات | |
---|---|
String | فرع البناء أو null إذا لم يتم تعيينه/غير قابل للتطبيق |
public String getBuildFlavor ()
طريقة اختيارية لإرجاع نوع البناء الذي يتم اختباره.
أحد التطبيقات الشائعة لبناء نظام Android الأساسي هو إرجاع (منتج البناء)-(بناء نظام التشغيل)-(متغير البناء). على سبيل المثال، Linux-userdebug العام
عائدات | |
---|---|
String | نكهة البناء أو null إذا لم يتم ضبطها/غير قابلة للتطبيق |
public String getBuildId ()
إرجاع المعرف الفريد للبناء قيد الاختبار. لا ينبغي أبدا أن تكون فارغة. الإعدادات الافتراضية هي UNKNOWN_BUILD_ID
.
عائدات | |
---|---|
String |
public String getBuildTargetName ()
قم بإرجاع الاسم الكامل للبنية التي يتم اختبارها.
التنفيذ الشائع هو إنشاء اسم هدف البناء من مزيج من نكهة البناء واسم الفرع. [أي (اسم الفرع)-(بناء النكهة)]
عائدات | |
---|---|
String |
public String getDeviceSerial ()
عائدات | |
---|---|
String |
public File getFile (String name)
طريقة مساعد لاسترداد ملف بالاسم المحدد.
عائدات | |
---|---|
File | ملف الصورة أو null إذا لم يتم العثور عليه |
public File getFile (BuildInfoKey.BuildInfoFileKey key)
أسلوب مساعد لاسترداد ملف باستخدام BuildInfoFileKey
.
حدود | |
---|---|
key | BuildInfoKey.BuildInfoFileKey : BuildInfoFileKey المطلوب. |
عائدات | |
---|---|
File | ملف الصورة أو null إذا لم يتم العثور عليه |
publicgetFiles ()
تقوم بإرجاع جميع VersionedFile
المخزنة في BuildInfo
هذا.
عائدات | |
---|---|
publicgetProperties ()
إرجاع نسخة من الخصائص المعينة حاليًا على IBuildInfo
.
عائدات | |
---|---|
publicgetRemoteFiles ()
احصل على مسارات عناصر البناء التي تأخر تنزيلها.
عائدات | |
---|---|
public String getTestTag ()
قم بإرجاع اسم فريد للاختبارات التي يتم تشغيلها.
عائدات | |
---|---|
String |
public String getVersion (BuildInfoKey.BuildInfoFileKey key)
أسلوب مساعد لاسترداد إصدار ملف باستخدام BuildInfoFileKey
.
حدود | |
---|---|
key | BuildInfoKey.BuildInfoFileKey : تم طلب BuildInfoFileKey . |
عائدات | |
---|---|
String | نسخة الصورة أو null إذا لم يتم العثور عليها |
public String getVersion (String name)
طريقة مساعد لاسترداد نسخة ملف بالاسم المحدد.
عائدات | |
---|---|
String | نسخة الصورة أو null إذا لم يتم العثور عليها |
public VersionedFile getVersionedFile (BuildInfoKey.BuildInfoFileKey key)
أسلوب مساعد لاسترداد VersionedFile
باستخدام BuildInfoFileKey
المحدد.
حدود | |
---|---|
key | BuildInfoKey.BuildInfoFileKey : تم طلب BuildInfoFileKey . |
عائدات | |
---|---|
VersionedFile | الملف الذي تم إصداره أو null إذا لم يتم العثور عليه |
public final VersionedFile getVersionedFile (String name)
طريقة مساعدة لاسترداد VersionedFile
بالاسم المحدد.
عائدات | |
---|---|
VersionedFile | الملف الذي تم إصداره أو null إذا لم يتم العثور عليه |
publicgetVersionedFileKeys ()
إرجاع مجموعة المفاتيح المتاحة للاستعلام عن VersionedFile
عبر getFile(BuildInfoFileKey)
.
عائدات | |
---|---|
public finalgetVersionedFiles (BuildInfoKey.BuildInfoFileKey key)
أسلوب مساعد لاسترداد قائمة VersionedFile
المرتبطة بمفتاح BuildInfoFileKey
محدد. إذا كان المفتاح يسمح بتخزين القائمة.
حدود | |
---|---|
key | BuildInfoKey.BuildInfoFileKey : تم طلب BuildInfoFileKey . |
عائدات | |
---|---|
الملف الذي تم إصداره أو null إذا لم يتم العثور عليه |
public int hashCode ()
عائدات | |
---|---|
int |
public void removeBuildAttribute (String attributeName)
إزالة attributeName معين من التتبع.
حدود | |
---|---|
attributeName | String : السمة لإيقاف التتبع |
public void setBuildBranch (String branch)
تعيين فرع البناء
حدود | |
---|---|
branch | String : اسم الفرع |
public void setBuildFlavor (String buildFlavor)
ضبط نكهة البناء.
public void setBuildId (String buildId)
يعين المعرف الفريد للبناء قيد الاختبار. لا ينبغي أبدا أن تكون فارغة.
حدود | |
---|---|
buildId | String |
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 : قائمة الخصائص المراد إضافتها. |
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 المحلي. |
public BuildInformation.BuildInfo toProto ()
قم بإجراء تسلسل لمثيل BuildInfo في protobuf.
عائدات | |
---|---|
BuildInformation.BuildInfo |
public String toString ()
عائدات | |
---|---|
String |
protected void addAllBuildAttributes (BuildInfo build)
طريقة مساعدة لنسخ سمات البناء والفروع والنكهة من البنية الأخرى.
حدود | |
---|---|
build | BuildInfo |
protected void addAllFiles (BuildInfo build)
طريقة مساعد لنسخ كافة الملفات من البنية الأخرى.
يقوم بإنشاء روابط صلبة جديدة للملفات بحيث يكون لكل إصدار مسار ملف فريد للملف.
حدود | |
---|---|
build | BuildInfo |
رميات | |
---|---|
| إذا تم طرح استثناء عند إنشاء الارتباط الثابت. |
protected boolean applyBuildProperties (VersionedFile origFileConsidered, IBuildInfo build, IBuildInfo receiver)
السماح بتطبيق بعض IBuildInfo.BuildInfoProperties
وربما إجراء معالجة مختلفة.
حدود | |
---|---|
origFileConsidered | VersionedFile : VersionedFile الذي يتم النظر إليه حاليًا. |
build | IBuildInfo : يتم استنساخ البنية الأصلية |
receiver | IBuildInfo : البنية التي تتلقى المعلومات. |
عائدات | |
---|---|
boolean | صحيح إذا طبقنا الخصائص ويجب تخطي المزيد من المعالجة. باطل غير ذلك. |
protected MultiMap<String, String> getAttributesMultiMap ()
عائدات | |
---|---|
MultiMap <String, String> |
protectedgetVersionedFileMap ()
عائدات | |
---|---|
protected MultiMap<String, VersionedFile> getVersionedFileMapFull ()
عائدات | |
---|---|
MultiMap <String, VersionedFile > |