BuildInfo

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) إضافة سمات الإصدار
void	allowStagingRemoteFile(boolean stageRemoteFile) لضبط الإذن للسماح بنشر الملفات البعيدة.
void	cleanUp() محو أي ملفات مؤقتة للإصدار
void	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() عرض جميع VersionedFiles المخزّنة في هذا 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) إزالة سمة 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()

وظائف الإنشاء العامة

BuildInfo

public BuildInfo ()

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

BuildInfo

public BuildInfo (String buildId, 
                String buildTargetName)

إنشاء BuildInfo

المعلمات
buildId	String: رقم تعريف الإصدار
buildTargetName	String: اسم هدف الإنشاء

الطرق العامة

addAppPackageFile

public void addAppPackageFile (File appPackageFile, 
                String version)

تُضيف هذه السمة ملف apk على الجهاز والإصدار المرتبط به. يُرجى العلم أنّه سيتم عرض حِزم 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

cleanUp

public void cleanUp ()

محو أي ملفات مؤقتة للإصدار

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

fromProto

public static IBuildInfo fromProto (BuildInformation.BuildInfo protoBuild)

يمكنك إجراء العملية العكسية toProto() لاستعادة المثيل.

المعلمات
protoBuild	BuildInformation.BuildInfo

المرتجعات
IBuildInfo

getAppPackageFiles

public  getAppPackageFiles ()

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

المرتجعات

getBuildAttributes

public  getBuildAttributes ()

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

المرتجعات
	ERROR(/Map) من سمات التصميم لن يكون null، ولكن قد يكون فارغًا.

getBuildBranch

public String getBuildBranch ()

طريقة اختيارية لعرض فرع التحكّم في المصدر الذي تمّت إنشاء الإصدار الذي يتم اختباره منه.

المرتجعات
String	فرع الإصدار أو null في حال عدم ضبطه/عدم انطباقه

getBuildFlavor

public String getBuildFlavor ()

طريقة اختيارية لعرض نوع الإصدار الذي يتم اختباره

من الشائع أن يتم عرض القيمة التالية لإصدارات نظام Android: (build product)-(build os)-(build variant). ie generic-linux-userdebug

المرتجعات
String	نكهة الإصدار أو null في حال عدم ضبطها/عدم انطباقها

getBuildId

public String getBuildId ()

تعرِض هذه السمة المعرّف الفريد للإصدار قيد الاختبار. يجب ألا تكون فارغة أبدًا. الإعداد التلقائي هو UNKNOWN_BUILD_ID.

المرتجعات
String

getBuildTargetName

public String getBuildTargetName ()

عرض الاسم الكامل للإصدار الذي يتم اختباره

من الشائع إنشاء اسم هدف الإنشاء من تركيبة من نكهة الإنشاء واسم الفرع. [أي (اسم الفرع)-(نكهة الإصدار)]

المرتجعات
String

getDeviceSerial

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

عرض جميع VersionedFiles المخزّنة في هذا 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 معيّنة من التتبّع

المعلمات
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

toString

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>