معلومات IBuildInfo

public interface IBuildInfo

com.android.tradefed.build.IBuildInfo

الفئات الفرعية المعروفة غير المباشرة AppBuildInfo وAppDeviceBuildInfo وBuildInfo وClusterBuildInfo وDeviceBuildInfo وDeviceFilterBuildInfo وMemberBuildInfo وIAppBuildInfo وIDeviceBuildInfo وIDeviceBuildInfo وIDeviceBuildInfo AppBuildInfo تمثّل هذه السمة IBuildInfo الذي يمثّل أحد تطبيقات Android وحِزم الاختبار الخاصة به.  AppDeviceBuildInfo تم إيقاف هذا الصف نهائيًا. ويمكنك استخدام "IDeviceBuildInfo" مباشرةً.  BuildInfo عملية تنفيذ عامة لـ IBuildInfo التي يجب ربطها من خلال ITestDevice.  ClusterBuildInfo فئة IBuildInfo لعمليات الإنشاء التي يتم إرسالها من TFC.  DeviceBuildInfo تمثّل سمة IBuildInfo إصدارًا كاملاً من جهاز Android واختباراته (اختياريًا).  DeviceمجلدBuildInfo IDeviceBuildInfo الذي يحتوي أيضًا على عناصر إصدار أخرى مضمَّنة في دليل على نظام الملفات المحلي.  مجلد BuildInfo تنفيذ ملموس لـ IFolderBuildInfo:  IAppBuildInfo تم إيقاف هذه الواجهة نهائيًا. ويمكنك استخدام "IBuildInfo" مباشرةً.  IDeviceBuildInfo تمثّل سمة IBuildInfo إصدارًا كاملاً من جهاز Android واختباراته (اختياريًا).  IمجلّدBuildInfo IBuildInfo تجريدي بسيط يحتوي على عناصر تصميمه في نظام ملفات على الجهاز الدليل.  OtaDeviceBuildInfo يتم استخدام IDeviceBuildInfo لاختبار التحديث عبر شبكة غير سلكيّة.  OtatoolsBuildInfo IBuildInfo يحتوي على عناصر otatools.

---

يتضمّن معلومات عن الإصدار قيد الاختبار.

ملخّص

الثوابت
String	REMOTE_FILE_PREFIX البادئة المستخدمة في الاسم للإشارة إلى تعيين الملف لتأخر تنزيل الملف.
String	REMOTE_FILE_VERSION لم يتم تحديد إصدار للملف البعيد.
String	UNKNOWN_BUILD_ID القيمة التلقائية عندما يكون رقم تعريف الإصدار غير معروف.

الطرق العامة
default void	addAppPackageFile(File appPackageFile, String version) يؤدي هذا الخيار إلى إضافة ملف apk المحلي والإصدار المرتبط به.
abstract void	addBuildAttribute(String attributeName, String attributeValue) أضِف سمة الإصدار.
default void	addBuildAttributes( buildAttributes) إضافة سمات الإصدار
default void	allowStagingRemoteFile(boolean stageRemoteFile) لضبط الإذن للسماح بتنظيم الملفات البعيدة.
abstract void	cleanUp() حذف أي ملفات إصدار مؤقتة
abstract void	cleanUp( doNotDelete) إصدار cleanUp() حيث لم يتم حذف بعض الملفات.
abstract IBuildInfo	clone() استنساخ الكائن IBuildInfo.
default	getAppPackageFiles() للحصول على نسخة من مجموعة ملفات APK للتطبيقات المحلية وإصداراتها.
abstract	getBuildAttributes() احصل على مجموعة من أزواج الاسم والقيمة من السمات الإضافية التي تصف التصميم.
abstract String	getBuildBranch() طريقة اختيارية لعرض فرع التحكّم في المصدر الذي كان يتم اختباره في الإصدار الذي تم اختباره إنتاجه.
abstract String	getBuildFlavor() طريقة اختيارية لعرض نوع التصميم الذي يتم اختباره.
abstract String	getBuildId() تعرض المعرّف الفريد للإصدار قيد الاختبار.
abstract String	getBuildTargetName() اعرض الاسم الكامل للتصميم الذي يتم اختباره.
abstract String	getDeviceSerial()
abstract File	getFile(String name) طريقة مساعدة لاسترداد ملف بالاسم الأول.
default File	getFile(BuildInfoKey.BuildInfoFileKey key) طريقة مساعِدة لاسترداد ملف باستخدام السمة BuildInfoFileKey المحددة
abstract	getFiles() عرض جميع VersionedFile المحفوظة في BuildInfo
abstract	getProperties() عرض نسخة من السمات المعيّنة حاليًا على IBuildInfo.
default	getRemoteFiles() يمكنك الحصول على مسارات عناصر الإنشاء التي تأخر تنزيلها.
abstract String	getTestTag() أدخِل اسمًا فريدًا للاختبارات التي يتم إجراؤها.
default String	getVersion(BuildInfoKey.BuildInfoFileKey key) طريقة مساعِدة لاسترداد نسخة من الملف باستخدام السمة BuildInfoFileKey المحددة
abstract String	getVersion(String name) طريقة مساعدة لاسترداد نسخة ملف باسم معيّن.
default VersionedFile	getVersionedFile(BuildInfoKey.BuildInfoFileKey key) طريقة مساعدة لاسترداد VersionedFile باستخدام BuildInfoFileKey محدّد.
default VersionedFile	getVersionedFile(String name) طريقة مساعدة لاسترداد VersionedFile باسم معيّن.
default	getVersionedFileKeys() تعرض مجموعة المفاتيح المتاحة لطلب بحث عن VersionedFile من خلال getFile(BuildInfoFileKey).
default	getVersionedFiles(BuildInfoKey.BuildInfoFileKey key) طريقة مساعدة لاسترداد قائمة VersionedFile المرتبطة بقيمة BuildInfoFileKey محدّدة.
default void	removeBuildAttribute(String attributeName) يجب إزالة سمةattributeName معيّنة من التتبع.
abstract void	setBuildBranch(String branch) تحديد فرع الإصدار
abstract void	setBuildFlavor(String buildFlavor) اضبط صيغة التصميم.
abstract void	setBuildId(String buildId) تضبط هذه السياسة المعرّف الفريد للإصدار الذي يتم اختباره.
abstract void	setDeviceSerial(String serial) يمكنك ضبط الرقم التسلسلي ITestDevice المرتبط بهذا الإصدار.
abstract void	setFile(String name, File file, String version) تخزين ملف باسم واحد في معلومات الإصدار هذه
default void	setFile(BuildInfoKey.BuildInfoFileKey key, File file, String version) يحفظ هذا الإعداد ملفًا محدَّدًا في BuildInfoFileKey في معلومات الإصدار هذه.
abstract void	setProperties(BuildInfoProperties... properties) اضبط السمة BuildInfoProperties لمثيل IBuildInfo.
abstract void	setTestTag(String testTag) لضبط الاسم الفريد للاختبارات التي يتمّ إجراؤها.
default File	stageRemoteFile(String fileName, File workingDir) يمكنك الجزء الرئيسي من ملف يكون جزءًا من الملفات البعيدة في الأمر الجذري لمعلومات الإصدار.
default BuildInformation.BuildInfo	toProto() تسلسل مثيل BuildInfo في نموذج أوّلي.

الثوابت

REMOTE_FILE_PREFIX

public static final String REMOTE_FILE_PREFIX

البادئة المستخدمة في الاسم للإشارة إلى تعيين الملف لتأخر تنزيل الملف.

القيمة الثابتة: "remote_file: "

الإصدار REMOTE_FILE_VERSION

public static final String REMOTE_FILE_VERSION

لم يتم تحديد إصدار للملف البعيد.

القيمة الثابتة: ""

UNKNOWN_BUILD_ID

public static final String UNKNOWN_BUILD_ID

القيمة التلقائية عندما يكون رقم تعريف الإصدار غير معروف.

القيمة الثابتة: "1-"

الطرق العامة

إضافة ملف AppPackageFile

public void addAppPackageFile (File appPackageFile, 
                String version)

يؤدي هذا الخيار إلى إضافة ملف apk المحلي والإصدار المرتبط به. يُرجى العلم أنّه سيتم عرض ملفات APK من getAppPackageFiles() حسب ترتيب إضافتها بهذه الطريقة.

المعلمات
appPackageFile	File
version	String

إضافة سمة بناء

public abstract void addBuildAttribute (String attributeName, 
                String attributeValue)

أضِف سمة الإصدار. لا يسمح ذلك بتجاهل سمةattributeName حالية.

المعلمات
attributeName	String: اسم السمة الفريدة
attributeValue	String: قيمة السمة

إضافة سمات بناء

public void addBuildAttributes ( buildAttributes)

إضافة سمات الإصدار

المعلمات
buildAttributes	: خريطة السمات التي ستتم إضافتها

السماح بـ"StagingRemoteFile"

public void allowStagingRemoteFile (boolean stageRemoteFile)

لضبط الإذن للسماح بتنظيم الملفات البعيدة.

المعلمات
stageRemoteFile	boolean

تنظيف

public abstract void cleanUp ()

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

تنظيف

public abstract void cleanUp ( doNotDelete)

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

المعلمات
doNotDelete

استنساخ

public abstract IBuildInfo clone ()

استنساخ الكائن IBuildInfo.

المرتجعات
IBuildInfo

الحصول على ملفات AppPackageFiles

public  getAppPackageFiles ()

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

المرتجعات

getBuildAttributes

public abstract  getBuildAttributes ()

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

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

getBuildBranch

public abstract String getBuildBranch ()

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

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

الحصول على BuildFLAor

public abstract String getBuildFlavor ()

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

يتمثل التنفيذ الشائع لإصدارات نظام Android الأساسي في إرجاع (إنشاء المنتج)-(إنشاء نظام التشغيل)-(إنشاء الصيغة). مثال: generic-linux-userdebug

المرتجعات
String	صيغة التصميم أو null إذا لم يتم ضبط السياسة أو لم يكن ذلك منطبقًا

معرّف getBuildId

public abstract String getBuildId ()

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

المرتجعات
String

getBuildTargetName

public abstract String getBuildTargetName ()

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

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

المرتجعات
String

الطريقة getDeviceSerial

public abstract String getDeviceSerial ()

المرتجعات
String	المسلسل ITestDevice الذي تم تنفيذ هذا الإصدار عليه. تعرض null في حال عدم ارتباط أي جهاز بهذا الإصدار.

الحصول على ملف

public abstract File getFile (String name)

طريقة مساعدة لاسترداد ملف بالاسم الأول.

المرتجعات
File	ملف الصورة أو null إذا لم يتم العثور عليه

الحصول على ملف

public File getFile (BuildInfoKey.BuildInfoFileKey key)

طريقة مساعِدة لاسترداد ملف باستخدام السمة BuildInfoFileKey المحددة

المعلمات
key	BuildInfoKey.BuildInfoFileKey: السمة BuildInfoFileKey المطلوبة

المرتجعات
File	ملف الصورة أو null إذا لم يتم العثور عليه

استرداد الملفات

public abstract  getFiles ()

عرض جميع VersionedFile المحفوظة في BuildInfo

المرتجعات

الحصول على خصائص

public abstract  getProperties ()

عرض نسخة من السمات المعيّنة حاليًا على IBuildInfo.

المرتجعات

استرداد الملفات عن بُعد

public  getRemoteFiles ()

يمكنك الحصول على مسارات عناصر الإنشاء التي تأخر تنزيلها.

المرتجعات

الحصول على علامة اختبار

public abstract String getTestTag ()

أدخِل اسمًا فريدًا للاختبارات التي يتم إجراؤها.

المرتجعات
String

الحصول على الإصدار

public String getVersion (BuildInfoKey.BuildInfoFileKey key)

طريقة مساعِدة لاسترداد نسخة من الملف باستخدام السمة BuildInfoFileKey المحددة

المعلمات
key	BuildInfoKey.BuildInfoFileKey: المبلغ المطلوب هو BuildInfoFileKey.

المرتجعات
String	نسخة الصورة أو null إذا لم يتم العثور عليه

الحصول على الإصدار

public abstract String getVersion (String name)

طريقة مساعدة لاسترداد نسخة ملف باسم معيّن.

المرتجعات
String	نسخة الصورة أو null إذا لم يتم العثور عليه

ملف getVersionedFile

public VersionedFile getVersionedFile (BuildInfoKey.BuildInfoFileKey key)

طريقة مساعدة لاسترداد VersionedFile باستخدام BuildInfoFileKey محدّد.

المعلمات
key	BuildInfoKey.BuildInfoFileKey: المبلغ المطلوب هو BuildInfoFileKey.

المرتجعات
VersionedFile	إذا لم يتم العثور على الملف الذي تم تحديد إصدار له، أو على null

ملف getVersionedFile

public VersionedFile getVersionedFile (String name)

طريقة مساعدة لاسترداد VersionedFile باسم معيّن.

المرتجعات
VersionedFile	إذا لم يتم العثور على الملف الذي تم تحديد إصدار له، أو على null

مفتاح getVersionedFileKeys

public  getVersionedFileKeys ()

تعرض مجموعة المفاتيح المتاحة لطلب بحث عن VersionedFile من خلال getFile(BuildInfoFileKey).

المرتجعات

getVersionedFiles

public  getVersionedFiles (BuildInfoKey.BuildInfoFileKey key)

طريقة مساعدة لاسترداد قائمة VersionedFile المرتبطة بقيمة BuildInfoFileKey محدّدة. ما إذا كان المفتاح يسمح بتخزين قائمة.

المعلمات
key	BuildInfoKey.BuildInfoFileKey: المبلغ المطلوب هو BuildInfoFileKey.

المرتجعات
	إذا لم يتم العثور على الملف الذي تم تحديد إصدار له، أو على null

إزالة سمة التصميم

public void removeBuildAttribute (String attributeName)

يجب إزالة سمةattributeName معيّنة من التتبع.

المعلمات
attributeName	String: السمة المطلوب إيقاف التتبّع

setBuildBranch

public abstract void setBuildBranch (String branch)

تحديد فرع الإصدار

المعلمات
branch	String: اسم الفرع

مجموعة BuildFlamor

public abstract void setBuildFlavor (String buildFlavor)

اضبط صيغة التصميم.

setBuildId

public abstract void setBuildId (String buildId)

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

المعلمات
buildId	String

ضبط الجهاز التسلسلي

public abstract void setDeviceSerial (String serial)

يمكنك ضبط الرقم التسلسلي ITestDevice المرتبط بهذا الإصدار.

المعلمات
serial	String: الرقم التسلسلي لـ ITestDevice الذي تم تنفيذ هذا الإصدار باستخدامه

ضبط الملف

public abstract 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 abstract void setProperties (BuildInfoProperties... properties)

اضبط السمة BuildInfoProperties لمثيل IBuildInfo. تجاوز أي المواقع الحالية التي تم تعيينها من قبل.

المعلمات
properties	BuildInfoProperties: قائمة السمات المطلوب إضافتها

setTestTag

public abstract 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) للملف مرحلي في WorkDir المحلي.

إلى Proto

public BuildInformation.BuildInfo toProto ()

تسلسل مثيل BuildInfo في نموذج أوّلي.

المرتجعات
BuildInformation.BuildInfo