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

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

abstract void cleanUp ()

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

abstract void cleanUp ( doNotDelete) 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 في 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 المحلي والإصدار المرتبط به. لاحظ أنه سيتم إرجاع التطبيقات من 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 : خريطة السمات المراد إضافتها

تنظيف

public abstract void cleanUp ()

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

تنظيف

public abstract void cleanUp ( doNotDelete)

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

حدود
doNotDelete

استنساخ

public abstract IBuildInfo clone ()

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

عائدات
IBuildInfo

getAppPackageFiles

public  getAppPackageFiles ()

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

عائدات

getBuildAttributes

public abstract  getBuildAttributes ()

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

عائدات
ERROR(/Map) لسمات البناء. لن تكون null ، ولكن قد تكون فارغة.

getBuildBranch

public abstract String getBuildBranch ()

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

عائدات
String فرع البناء أو null إذا لم يتم تعيينه/غير قابل للتطبيق

getBuildFlavor

public abstract String getBuildFlavor ()

طريقة اختيارية لإرجاع نوع البناء الذي يتم اختباره.

أحد التطبيقات الشائعة لبناء نظام Android الأساسي هو إرجاع (منتج البناء)-(بناء نظام التشغيل)-(متغير البناء). على سبيل المثال، 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 إذا لم يتم العثور عليه

getFiles

public abstract  getFiles ()

تقوم بإرجاع جميع VersionedFile المخزنة في 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