IBuildInfo

public interface IBuildInfo

com.android.tradefed.build.IBuildInfo

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

ملخّص

الثابتات

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

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

الثابتات

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"

الطرق العامة

addAppPackageFile

public void addAppPackageFile (File appPackageFile, 
                String version)

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

المعلمات
appPackageFile File

version String

addBuildAttribute

public abstract 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 abstract void cleanUp ()

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

cleanUp

public abstract void cleanUp ( doNotDelete)

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

المعلمات
doNotDelete

نسخة طبق الأصل

public abstract IBuildInfo clone ()

تستنسخ عنصر IBuildInfo.

المرتجعات
IBuildInfo

getAppPackageFiles

public  getAppPackageFiles ()

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

المرتجعات

getBuildAttributes

public abstract  getBuildAttributes ()

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

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

getBuildBranch

public abstract String getBuildBranch ()

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

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

getBuildFlavor

public abstract String getBuildFlavor ()

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

من الشائع أن يتم عرض القيمة التالية لإصدارات نظام Android: (build product)-(build os)-(build variant). ie 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 إذا لم يكن هناك جهاز مرتبط بهذا الإصدار.

getFile

public abstract File getFile (String name)

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

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

getFile

public File getFile (BuildInfoKey.BuildInfoFileKey key)

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

المعلمات
key ‫BuildInfoKey.BuildInfoFileKey: BuildInfoFileKey المطلوب
المرتجعات
File ملف الصورة أو null في حال عدم العثور عليه

getFiles

public abstract  getFiles ()

عرض جميع VersionedFiles المخزّنة في هذا BuildInfo

المرتجعات

getProperties

public abstract  getProperties ()

تعرِض هذه الدالة نسخة من السمات التي تم ضبطها حاليًا في IBuildInfo.

المرتجعات

getRemoteFiles

public  getRemoteFiles ()

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

المرتجعات

getTestTag

public abstract String getTestTag ()

عرض اسم فريد للاختبارات التي يتم إجراؤها

المرتجعات
String

getVersion

public String getVersion (BuildInfoKey.BuildInfoFileKey key)

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

المعلمات
key BuildInfoKey.BuildInfoFileKey: BuildInfoFileKey المطلوبة.
المرتجعات
String نسخة الصورة أو null في حال عدم العثور عليها

getVersion

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 في حال عدم العثور عليه

removeBuildAttribute

public void removeBuildAttribute (String attributeName)

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

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

setBuildBranch

public abstract void setBuildBranch (String branch)

ضبط فرع الإنشاء

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

setBuildFlavor

public abstract void setBuildFlavor (String buildFlavor)

اضبط نكهة الإصدار.

setBuildId

public abstract void setBuildId (String buildId)

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

المعلمات
buildId String

setDeviceSerial

public abstract void setDeviceSerial (String serial)

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

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

setFile

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

اضبط BuildInfoProperties لنسخة IBuildInfo. إلغاء أي مواقع حالية تم ضبطها من قبل

المعلمات
properties BuildInfoProperties: قائمة المواقع التي تريد إضافتها

setTestTag

public abstract 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