معلومات البناء

public class BuildInfo
extends Object implements IBuildInfo

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

الفئات الفرعية المباشرة المعروفة AppBuildInfo و DeviceBuildInfo و FolderBuildInfo و OtatoolsBuildInfo AppBuildInfo IBuildInfo يمثل تطبيق Android وحزمة (حزم) الاختبار الخاصة به. DeviceBuildInfo IBuildInfo الذي يمثل بنية كاملة لجهاز Android واختباراته (اختياريًا). FolderBuildInfo التنفيذ الملموس لـ IFolderBuildInfo . OtatoolsBuildInfo IBuildInfo الذي يحتوي على عناصر otatools.

الفئات الفرعية غير المباشرة المعروفة AppDeviceBuildInfo و ClusterBuildInfo و DeviceFolderBuildInfo و OtaDeviceBuildInfo AppDeviceBuildInfo هذه الفئة مهملة. استخدم IDeviceBuildInfo مباشرة. ClusterBuildInfo فئة IBuildInfo للمباني التي يتم توصيلها بالأنابيب من TFC. DeviceFolderBuildInfo IDeviceBuildInfo يحتوي أيضًا على عناصر بناء أخرى موجودة في دليل على نظام الملفات المحلي. OtaDeviceBuildInfo IDeviceBuildInfo يُستخدم لاختبار التحديث عبر الهواء.

---

التنفيذ العام لـ IBuildInfo الذي يجب أن يرتبط بجهاز ITestDevice .

ملخص

المنشأت العامة
BuildInfo () ينشئ BuildInfo باستخدام قيم السمات الافتراضية.
BuildInfo (String buildId, String buildTargetName) ينشئ BuildInfo

الأساليب العامة
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) إصدار cleanUp() حيث لا يتم حذف بعض الملفات.
IBuildInfo	clone ()
final void	copyAllFileFrom ( BuildInfo build) انسخ جميع ملفات VersionedFile من بناء معين إلى هذا الإصدار.
boolean	equals (Object obj)
static IBuildInfo	fromProto (BuildInformation.BuildInfo protoBuild) العملية العكسية إلى toProto() لاستعادة المثيل.
	getAppPackageFiles () الحصول على نسخة من مجموعة ملفات apk للتطبيق المحلي وإصداراتها.
	getBuildAttributes () احصل على مجموعة من أزواج الاسم والقيمة من السمات الإضافية التي تصف البناء.
String	getBuildBranch () طريقة اختيارية لإرجاع فرع التحكم بالمصدر الذي تم إنتاج البناء الذي يجري اختباره منه.
String	getBuildFlavor () طريقة اختيارية لإرجاع نوع البناء الذي يتم اختباره.
String	getBuildId () إرجاع المعرف الفريد للبناء قيد الاختبار.
String	getBuildTargetName () إرجاع الاسم الكامل للبناء قيد الاختبار.
String	getDeviceSerial ()
File	getFile (String name) طريقة مساعدة لاسترداد ملف باسم معين.
File	getFile ( BuildInfoKey.BuildInfoFileKey key) أسلوب مساعد لاسترداد ملف معطى BuildInfoFileKey .
	getFiles () ترجع جميع ملفات VersionedFile المخزنة في BuildInfo هذا.
	getProperties () تُرجع نسخة من الخصائص المعينة حاليًا على IBuildInfo .
	getRemoteFiles () احصل على مسارات عناصر البناء التي تأخر تنزيلها.
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) تعيين فرع البناء
void	setBuildFlavor (String buildFlavor) اضبط نكهة البناء.
void	setBuildId (String buildId) يضبط المعرف الفريد للبناء قيد الاختبار.
void	setDeviceSerial (String serial) قم بتعيين المسلسل ITestDevice المرتبط بهذا الإصدار.
void	setFile (String name, File file, String version) يخزن ملفًا باسم معين في معلومات البناء هذه.
void	setFile ( BuildInfoKey.BuildInfoFileKey key, File file, String version) يخزن ملفًا يعطي BuildInfoFileKey في معلومات البناء هذه.
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) طريقة مساعدة لنسخ سمات البناء والفرع والنكهة من بنية أخرى.
void	addAllFiles ( BuildInfo build) طريقة المساعد لنسخ جميع الملفات من البناء الآخر.
boolean	applyBuildProperties ( VersionedFile origFileConsidered, IBuildInfo build, IBuildInfo receiver) اسمح لتطبيق بعض IBuildInfo.BuildInfoProperties وربما القيام بمعالجة مختلفة.
MultiMap <String, String>	getAttributesMultiMap ()
	getVersionedFileMap ()
MultiMap <String, VersionedFile >	getVersionedFileMapFull ()

المنشأت العامة

معلومات البناء

public BuildInfo ()

ينشئ BuildInfo باستخدام قيم السمات الافتراضية.

معلومات البناء

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

نظف أي ملفات بناء مؤقتة

تنظيف

public void cleanUp ( doNotClean)

إصدار cleanUp() حيث لا يتم حذف بعض الملفات.

حدود
doNotClean

استنساخ

public IBuildInfo clone ()

عائدات
IBuildInfo

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

public  getAppPackageFiles ()

الحصول على نسخة من مجموعة ملفات apk للتطبيق المحلي وإصداراتها. يتطابق الترتيب الذي تم إرجاعه مع الترتيب الذي تمت إضافة التطبيقات به إلى IAppBuildInfo .

عائدات

getBuildAttributes

public  getBuildAttributes ()

احصل على مجموعة من أزواج الاسم والقيمة من السمات الإضافية التي تصف البناء.

عائدات
	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 إذا لم يتم العثور عليه

getFiles

public  getFiles ()

ترجع جميع ملفات VersionedFile المخزنة في BuildInfo هذا.

عائدات

getProperties

public  getProperties ()

تُرجع نسخة من الخصائص المعينة حاليًا على IBuildInfo .

عائدات

getRemoteFiles

public  getRemoteFiles ()

احصل على مسارات عناصر البناء التي تأخر تنزيلها.

عائدات

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)

تعيين فرع البناء

حدود
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

protected  getVersionedFileMap ()

عائدات

getVersionedFileMapFull

protected MultiMap<String, VersionedFile> getVersionedFileMapFull ()

عائدات
MultiMap <String, VersionedFile >