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

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)

إزالة 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 الموجود.

حدود
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

fromProto

public static IBuildInfo fromProto (BuildInformation.BuildInfo protoBuild)

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

حدود
protoBuild BuildInformation.BuildInfo

عائدات
IBuildInfo

getAppPackageFiles

public  getAppPackageFiles ()

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

عائدات

getBuildAttributes

public  getBuildAttributes ()

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

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

getBuildBranch

public String getBuildBranch ()

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

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

getBuildFlavor

public String getBuildFlavor ()

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

أحد التطبيقات الشائعة لبناء نظام Android الأساسي هو إرجاع (منتج البناء)-(بناء نظام التشغيل)-(متغير البناء). على سبيل المثال، Linux-userdebug العام

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

getBuildId

public String getBuildId ()

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

عائدات
String

getBuildTargetName

public String getBuildTargetName ()

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

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

عائدات
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 معين من التتبع.

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

setFile

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

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

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

setTestTag

public 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

إلى سلسلة

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 >