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)

إزالة اسم سمة معطى من التعقب.

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

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

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

getBuildBranch

public abstract String getBuildBranch ()

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

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

getBuildFlavor

public abstract String getBuildFlavor ()

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

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

عائدات
String نكهة البناء أو null إذا لم يتم ضبطها / لا تنطبق

getBuildId

public abstract String getBuildId ()

إرجاع المعرف الفريد للبناء قيد الاختبار. لا ينبغي أبدا أن تكون فارغة. افتراضات على UNKNOWN_BUILD_ID .

عائدات
String

getBuildTargetName

public abstract String getBuildTargetName ()

إرجاع الاسم الكامل للبناء قيد الاختبار.

التنفيذ الشائع هو بناء اسم هدف البناء من مزيج من نكهة البناء واسم الفرع. [ie (اسم الفرع) - (بناء النكهة)]

عائدات
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 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 الذي تم تنفيذ هذا الإصدار معه.

تعيين ملف

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) للملف تم تنظيمه في workingDir المحلي.

toProto

public BuildInformation.BuildInfo toProto ()

تحويل مثيل BuildInfo إلى ملف protobuf.

عائدات
BuildInformation.BuildInfo