معلومات البناء

public class BuildInfo
extends Object implements IBuildInfo

java.lang.Object
com.android.tradefed.build.BuildInfo


التنفيذ العام لـ IBuildInfo الذي يجب أن يرتبط بجهاز ITestDevice .

ملخص

المنشأت العامة

BuildInfo ()

ينشئ BuildInfo باستخدام قيم السمات الافتراضية.

BuildInfo (String buildId, String buildTargetName)

ينشئ BuildInfo

الأساليب العامة

void addAppPackageFile (File appPackageFile, String version)

يضيف ملف apk المحلي والإصدار المرتبط به.

void addBuildAttribute (String attributeName, String attributeValue)

أضف سمة البناء.

void addBuildAttributes ( buildAttributes) addBuildAttributes ( buildAttributes)

أضف سمات البناء

void cleanUp ()

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

void cleanUp ( doNotClean) cleanUp ( doNotClean)

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

IBuildInfo clone ()

final void copyAllFileFrom ( BuildInfo build)

انسخ جميع ملفات VersionedFile من بناء معين إلى هذا الإصدار.

boolean equals (Object obj)

static IBuildInfo fromProto (BuildInformation.BuildInfo protoBuild)

العملية العكسية إلى toProto() لاستعادة المثيل.

getAppPackageFiles ()

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

getBuildAttributes ()

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

String getBuildBranch ()

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

String getBuildFlavor ()

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

String getBuildId ()

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

String getBuildTargetName ()

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

String getDeviceSerial ()

File getFile (String name)

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

File getFile ( BuildInfoKey.BuildInfoFileKey key)

أسلوب مساعد لاسترداد ملف معطى BuildInfoFileKey .

getFiles ()

ترجع جميع ملفات VersionedFile المخزنة في BuildInfo هذا.

getProperties ()

تُرجع نسخة من الخصائص المعينة حاليًا على IBuildInfo .

getRemoteFiles ()

احصل على مسارات عناصر البناء التي تأخر تنزيلها.

String getTestTag ()

قم بإرجاع اسم فريد للاختبارات قيد التشغيل.

String getVersion ( BuildInfoKey.BuildInfoFileKey key)

أسلوب مساعد لاسترداد نسخة ملف معطى BuildInfoFileKey .

String getVersion (String name)

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

VersionedFile getVersionedFile ( BuildInfoKey.BuildInfoFileKey key)

أسلوب مساعد لاسترداد VersionedFile باستخدام BuildInfoFileKey محدد.

final VersionedFile getVersionedFile (String name)

أسلوب مساعد لاسترداد VersionedFile باسم معين.

getVersionedFileKeys ()

تُرجع مجموعة المفاتيح المتاحة للاستعلام عن VersionedFile عبر getFile(BuildInfoFileKey) .

final getVersionedFiles ( BuildInfoKey.BuildInfoFileKey key)

أسلوب مساعد لاسترداد قائمة VersionedFile المقترنة بمفتاح BuildInfoFileKey محدد.

int hashCode ()

void removeBuildAttribute (String attributeName)

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

void setBuildBranch (String branch)

تعيين فرع البناء

void setBuildFlavor (String buildFlavor)

اضبط نكهة البناء.

void setBuildId (String buildId)

يضبط المعرف الفريد للبناء قيد الاختبار.

void setDeviceSerial (String serial)

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

void setFile (String name, File file, String version)

يخزن ملفًا باسم معين في معلومات البناء هذه.

void setFile ( BuildInfoKey.BuildInfoFileKey key, File file, String version)

يخزن ملفًا يعطي BuildInfoFileKey في معلومات البناء هذه.

void setProperties ( BuildInfoProperties... properties)

قم بتعيين BuildInfoProperties لمثيل IBuildInfo .

void setTestTag (String testTag)

يعيّن الاسم الفريد للاختبارات قيد التشغيل.

File stageRemoteFile (String fileName, File workingDir)

قم بإعداد ملف يمثل جزءًا من الملفات البعيدة في مسار الجذر الخاص بمعلومات الإنشاء.

BuildInformation.BuildInfo toProto ()

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

String toString ()

الطرق المحمية

void addAllBuildAttributes ( BuildInfo build)

طريقة مساعدة لنسخ سمات البناء والفرع والنكهة من بنية أخرى.

void addAllFiles ( BuildInfo build)

طريقة المساعد لنسخ جميع الملفات من البناء الآخر.

boolean applyBuildProperties ( VersionedFile origFileConsidered, IBuildInfo build, IBuildInfo receiver)

اسمح لتطبيق بعض IBuildInfo.BuildInfoProperties وربما القيام بمعالجة مختلفة.

MultiMap <String, String> getAttributesMultiMap ()
getVersionedFileMap ()
MultiMap <String, VersionedFile > getVersionedFileMapFull ()

المنشأت العامة

معلومات البناء

public BuildInfo ()

ينشئ BuildInfo باستخدام قيم السمات الافتراضية.

معلومات البناء

public BuildInfo (String buildId, 
                String buildTargetName)

ينشئ BuildInfo

حدود
buildId String : معرف البناء

buildTargetName String : اسم هدف البناء

الأساليب العامة

addAppPackageFile

public void addAppPackageFile (File appPackageFile, 
                String version)

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

حدود
appPackageFile File

version String

addBuildAttribute

public void addBuildAttribute (String attributeName, 
                String attributeValue)

أضف سمة البناء. لا يسمح هذا بتجاوز اسم سمة موجود.

حدود
attributeName String : اسم السمة الفريدة

attributeValue String : قيمة السمة

addBuildAttributes

public void addBuildAttributes ( buildAttributes)

أضف سمات البناء

حدود
buildAttributes : خريطة السمات المراد إضافتها

تنظيف

public void cleanUp ()

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

تنظيف

public void cleanUp ( doNotClean)

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

حدود
doNotClean

استنساخ

public IBuildInfo clone ()

عائدات
IBuildInfo

copyAllFileFrom

public final void copyAllFileFrom (BuildInfo build)

انسخ جميع ملفات VersionedFile من بناء معين إلى هذا الإصدار.

حدود
build BuildInfo

يساوي

public boolean equals (Object obj)

حدود
obj Object

عائدات
boolean

من Proto

public static IBuildInfo fromProto (BuildInformation.BuildInfo protoBuild)

العملية العكسية إلى toProto() لاستعادة المثيل.

حدود
protoBuild BuildInformation.BuildInfo

عائدات
IBuildInfo

getAppPackageFiles

public  getAppPackageFiles ()

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

عائدات

getBuildAttributes

public  getBuildAttributes ()

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

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

getBuildBranch

public String getBuildBranch ()

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

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

getBuildFlavor

public String getBuildFlavor ()

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

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

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

getBuildId

public String getBuildId ()

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

عائدات
String

getBuildTargetName

public String getBuildTargetName ()

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

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

عائدات
String

getDeviceSerial

public String getDeviceSerial ()

عائدات
String

خذ الملف

public File getFile (String name)

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

عائدات
File ملف الصورة أو null إذا لم يتم العثور عليه

خذ الملف

public File getFile (BuildInfoKey.BuildInfoFileKey key)

أسلوب مساعد لاسترداد ملف معطى BuildInfoFileKey .

حدود
key BuildInfoKey.BuildInfoFileKey : BuildInfoFileKey المطلوب.

عائدات
File ملف الصورة أو null إذا لم يتم العثور عليه

getFiles

public  getFiles ()

ترجع جميع ملفات VersionedFile المخزنة في BuildInfo هذا.

عائدات

getProperties

public  getProperties ()

تُرجع نسخة من الخصائص المعينة حاليًا على IBuildInfo .

عائدات

getRemoteFiles

public  getRemoteFiles ()

احصل على مسارات عناصر البناء التي تأخر تنزيلها.

عائدات

getTestTag

public String getTestTag ()

قم بإرجاع اسم فريد للاختبارات قيد التشغيل.

عائدات
String

getVersion

public String getVersion (BuildInfoKey.BuildInfoFileKey key)

أسلوب مساعد لاسترداد نسخة ملف معطى BuildInfoFileKey .

حدود
key BuildInfoKey.BuildInfoFileKey : طلب BuildInfoFileKey .

عائدات
String نسخة الصورة أو null إذا لم يتم العثور عليها

getVersion

public String getVersion (String name)

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

عائدات
String نسخة الصورة أو null إذا لم يتم العثور عليها

getVersionedFile

public VersionedFile getVersionedFile (BuildInfoKey.BuildInfoFileKey key)

أسلوب مساعد لاسترداد VersionedFile باستخدام BuildInfoFileKey محدد.

حدود
key BuildInfoKey.BuildInfoFileKey : طلب BuildInfoFileKey .

عائدات
VersionedFile الملف الذي تم إصداره أو null إذا لم يتم العثور عليه

getVersionedFile

public final VersionedFile getVersionedFile (String name)

أسلوب مساعد لاسترداد VersionedFile باسم معين.

عائدات
VersionedFile الملف الذي تم إصداره أو null إذا لم يتم العثور عليه

getVersionedFileKeys

public  getVersionedFileKeys ()

تُرجع مجموعة المفاتيح المتاحة للاستعلام عن VersionedFile عبر getFile(BuildInfoFileKey) .

عائدات

getVersionedFiles

public final  getVersionedFiles (BuildInfoKey.BuildInfoFileKey key)

أسلوب مساعد لاسترداد قائمة VersionedFile المقترنة بمفتاح BuildInfoFileKey محدد. إذا كان المفتاح يسمح بتخزين قائمة.

حدود
key BuildInfoKey.BuildInfoFileKey : طلب BuildInfoFileKey .

عائدات
الملف الذي تم إصداره أو null إذا لم يتم العثور عليه

hashCode

public int hashCode ()

عائدات
int

removeBuildAttribute

public void removeBuildAttribute (String attributeName)

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

حدود
attributeName String : سمة لإيقاف التعقب

setBuildBranch

public void setBuildBranch (String branch)

تعيين فرع البناء

حدود
branch String : اسم الفرع

setBuildFlavor

public void setBuildFlavor (String buildFlavor)

اضبط نكهة البناء.

setBuildId

public void setBuildId (String buildId)

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

حدود
buildId String

setDeviceSerial

public void setDeviceSerial (String serial)

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

حدود
serial String : الرقم التسلسلي لجهاز ITestDevice الذي تم تنفيذ هذا الإصدار معه.

تعيين ملف

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

قم بتعيين BuildInfoProperties لمثيل IBuildInfo . تجاوز أي خصائص حالية تم تعيينها من قبل.

حدود
properties BuildInfoProperties : قائمة الخصائص المراد إضافتها.

setTestTag

public 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

إلى سلسلة

public String toString ()

عائدات
String

الطرق المحمية

addAllBuildAttributes

protected void addAllBuildAttributes (BuildInfo build)

طريقة مساعدة لنسخ سمات البناء والفرع والنكهة من بنية أخرى.

حدود
build BuildInfo

addAllFiles

protected void addAllFiles (BuildInfo build)

طريقة المساعد لنسخ جميع الملفات من البناء الآخر.

ينشئ روابط صلبة جديدة للملفات بحيث يكون لكل بناء مسار ملف فريد للملف.

حدود
build BuildInfo

رميات
إذا تم طرح استثناء عند إنشاء الرابط الثابت.

ApplyBuildProperties

protected boolean applyBuildProperties (VersionedFile origFileConsidered, 
                IBuildInfo build, 
                IBuildInfo receiver)

اسمح لتطبيق بعض IBuildInfo.BuildInfoProperties وربما القيام بمعالجة مختلفة.

حدود
origFileConsidered VersionedFile : الملف الذي يتم عرضه حاليًا على VersionedFile .

build IBuildInfo : يتم استنساخ البناء الأصلي

receiver IBuildInfo : المبنى الذي يتلقى المعلومات.

عائدات
boolean صحيح إذا طبقنا الخصائص فيجب تخطي المزيد من المعالجة. خطأ خلاف ذلك.

getAttributesMultiMap

protected MultiMap<String, String> getAttributesMultiMap ()

عائدات
MultiMap <String, String>

getVersionedFileMap

protected  getVersionedFileMap ()

عائدات

getVersionedFileMapFull

protected MultiMap<String, VersionedFile> getVersionedFileMapFull ()

عائدات
MultiMap <String, VersionedFile >