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) إصدار |
abstract IBuildInfo | clone () استنساخ كائن |
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) أسلوب مساعد لاسترداد ملف معطى |
abstract | getFiles () ترجع جميع ملفات |
abstract | getProperties () تُرجع نسخة من الخصائص المعينة حاليًا على |
default | getRemoteFiles () احصل على مسارات عناصر البناء التي تأخر تنزيلها. |
abstract String | getTestTag () قم بإرجاع اسم فريد للاختبارات قيد التشغيل. |
default String | getVersion ( BuildInfoKey.BuildInfoFileKey key) أسلوب مساعد لاسترداد نسخة ملف معطى |
abstract String | getVersion (String name) طريقة مساعدة لاسترداد إصدار ملف باسم معين. |
default VersionedFile | getVersionedFile ( BuildInfoKey.BuildInfoFileKey key) أسلوب مساعد لاسترداد |
default VersionedFile | getVersionedFile (String name) أسلوب مساعد لاسترداد |
default | getVersionedFileKeys () تُرجع مجموعة المفاتيح المتاحة للاستعلام عن |
default | getVersionedFiles ( BuildInfoKey.BuildInfoFileKey key) أسلوب مساعد لاسترداد قائمة |
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) قم بتعيين المسلسل |
abstract void | setFile (String name, File file, String version) يخزن ملفًا باسم معين في معلومات البناء هذه. |
default void | setFile ( BuildInfoKey.BuildInfoFileKey key, File file, String version) يخزن ملفًا يعطي |
abstract void | setProperties ( BuildInfoProperties... properties) قم بتعيين |
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 |
getAppPackageFiles
publicgetAppPackageFiles ()
الحصول على نسخة من مجموعة ملفات apk للتطبيق المحلي وإصداراتها. يتطابق الترتيب الذي تم إرجاعه مع الترتيب الذي تمت إضافة التطبيقات به إلى IAppBuildInfo
.
عائدات | |
---|---|
getBuildAttributes
public abstractgetBuildAttributes ()
احصل على مجموعة من أزواج الاسم والقيمة من السمات الإضافية التي تصف البناء.
عائدات | |
---|---|
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 إذا لم يتم العثور عليه |
getProperties
public abstractgetProperties ()
تُرجع نسخة من الخصائص المعينة حاليًا على IBuildInfo
.
عائدات | |
---|---|
getRemoteFiles
publicgetRemoteFiles ()
احصل على مسارات عناصر البناء التي تأخر تنزيلها.
عائدات | |
---|---|
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
publicgetVersionedFileKeys ()
تُرجع مجموعة المفاتيح المتاحة للاستعلام عن VersionedFile
عبر getFile(BuildInfoFileKey)
.
عائدات | |
---|---|
getVersionedFiles
publicgetVersionedFiles (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 |