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) إضافة سمات البناء |
default void | allowStagingRemoteFile (boolean stageRemoteFile) يضبط الإذن للسماح بتنظيم الملفات عن بعد. |
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) إزالة 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 الموجود.
حدود | |
---|---|
attributeName | String : اسم السمة الفريدة |
attributeValue | String : قيمة السمة |
addBuildAttributes
public void addBuildAttributes (buildAttributes)
إضافة سمات البناء
حدود | |
---|---|
buildAttributes |
allowStagingRemoteFile
public void allowStagingRemoteFile (boolean stageRemoteFile)
يضبط الإذن للسماح بتنظيم الملفات عن بعد.
حدود | |
---|---|
stageRemoteFile | boolean |
تنظيف
public abstract void cleanUp ()
تنظيف أي ملفات بناء مؤقتة
تنظيف
public abstract void cleanUp (doNotDelete)
إصدار cleanUp()
حيث لا يتم حذف بعض الملفات.
حدود | |
---|---|
doNotDelete |
getAppPackageFiles
publicgetAppPackageFiles ()
الحصول على نسخة من مجموعة ملفات (ملفات) APK للتطبيقات المحلية وإصداراتها. يتطابق الترتيب الذي تم إرجاعه مع الترتيب الذي تمت به إضافة التطبيقات إلى IAppBuildInfo
.
عائدات | |
---|---|
getBuildAttributes
public abstractgetBuildAttributes ()
احصل على مجموعة من أزواج الاسم والقيمة للسمات الإضافية التي تصف البنية.
عائدات | |
---|---|
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 abstractgetFiles ()
تقوم بإرجاع جميع VersionedFile
المخزنة في BuildInfo
هذا.
عائدات | |
---|---|
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 معين من التتبع.
حدود | |
---|---|
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 |