BuildInfo
public
class
BuildInfo
extends Object
implements
IBuildInfo
java.lang.Object | |
↳ | com.android.tradefed.build.BuildInfo |
تنفيذ عام لعنصر IBuildInfo
يجب أن يكون مرتبطًا
بعنصر ITestDevice
.
ملخّص
وظائف الإنشاء العامة | |
---|---|
BuildInfo()
تُنشئ |
|
BuildInfo(String buildId, String buildTargetName)
إنشاء |
الطرق العامة | |
---|---|
void
|
addAppPackageFile(File appPackageFile, String version)
تُضيف هذه السمة ملف apk على الجهاز والإصدار المرتبط به. |
void
|
addBuildAttribute(String attributeName, String attributeValue)
أضِف سمة الإصدار. |
void
|
addBuildAttributes(
إضافة سمات الإصدار |
void
|
allowStagingRemoteFile(boolean stageRemoteFile)
لضبط الإذن للسماح بنشر الملفات البعيدة. |
void
|
cleanUp()
محو أي ملفات مؤقتة للإصدار |
void
|
cleanUp(
إصدار |
IBuildInfo
|
clone()
|
final
void
|
copyAllFileFrom(BuildInfo build)
انسخ جميع |
boolean
|
equals(Object obj)
|
static
IBuildInfo
|
fromProto(BuildInformation.BuildInfo protoBuild)
يمكنك إجراء العملية العكسية |
|
getAppPackageFiles()
الحصول على نسخة من مجموعة ملفات APK للتطبيقات المحلية وإصداراتها |
|
getBuildAttributes()
الحصول على مجموعة من أزواج الاسم والقيمة للسمات الإضافية التي تصف الإصدار |
String
|
getBuildBranch()
طريقة اختيارية لعرض فرع التحكّم في المصدر الذي تمّت إنشاء الإصدار الذي يتم اختباره منه. |
String
|
getBuildFlavor()
طريقة اختيارية لعرض نوع الإصدار الذي يتم اختباره |
String
|
getBuildId()
تعرِض هذه السمة المعرّف الفريد للإصدار قيد الاختبار. |
String
|
getBuildTargetName()
عرض الاسم الكامل للإصدار الذي يتم اختباره |
String
|
getDeviceSerial()
|
File
|
getFile(String name)
طريقة مساعدة لاسترداد ملف باسم معيّن |
File
|
getFile(BuildInfoKey.BuildInfoFileKey key)
طريقة مساعدة لاسترداد ملف باستخدام |
|
getFiles()
عرض جميع |
|
getProperties()
تعرِض هذه الدالة نسخة من السمات التي تم ضبطها حاليًا في |
|
getRemoteFiles()
الحصول على مسارات عناصر الإنشاء التي يتم تأخير تنزيلها |
String
|
getTestTag()
عرض اسم فريد للاختبارات التي يتم إجراؤها |
String
|
getVersion(BuildInfoKey.BuildInfoFileKey key)
طريقة مساعدة لاسترداد إصدار ملف باستخدام |
String
|
getVersion(String name)
طريقة مساعدة لاسترداد إصدار ملف باسم معيّن |
VersionedFile
|
getVersionedFile(BuildInfoKey.BuildInfoFileKey key)
طريقة مساعدة لاسترداد |
final
VersionedFile
|
getVersionedFile(String name)
طريقة مساعدة لاسترداد |
|
getVersionedFileKeys()
تُعيد مجموعة المفاتيح المتاحة لاستعلام |
final
|
getVersionedFiles(BuildInfoKey.BuildInfoFileKey key)
طريقة مساعدة لاسترداد قائمة |
int
|
hashCode()
|
void
|
removeBuildAttribute(String attributeName)
إزالة سمة attributeName معيّنة من التتبّع |
void
|
setBuildBranch(String branch)
ضبط فرع الإنشاء |
void
|
setBuildFlavor(String buildFlavor)
اضبط نكهة الإصدار. |
void
|
setBuildId(String buildId)
تُستخدَم لضبط المعرّف الفريد للإصدار قيد الاختبار. |
void
|
setDeviceSerial(String serial)
اضبط الرقم التسلسلي |
void
|
setFile(String name, File file, String version)
تخزِّن هذه السمة ملفًا باسم معيّن في معلومات الإصدار هذه. |
void
|
setFile(BuildInfoKey.BuildInfoFileKey key, File file, String version)
تخزِّن هذه السمة ملفًا تم منحه |
void
|
setProperties(BuildInfoProperties... properties)
اضبط |
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)
السماح بتطبيق بعض |
MultiMap<String, String>
|
getAttributesMultiMap()
|
|
getVersionedFileMap()
|
MultiMap<String, VersionedFile>
|
getVersionedFileMapFull()
|
وظائف الإنشاء العامة
BuildInfo
public BuildInfo (String buildId, String buildTargetName)
إنشاء BuildInfo
المعلمات | |
---|---|
buildId |
String : رقم تعريف الإصدار |
buildTargetName |
String : اسم هدف الإنشاء |
الطرق العامة
addAppPackageFile
public void addAppPackageFile (File appPackageFile, String version)
تُضيف هذه السمة ملف apk على الجهاز والإصدار المرتبط به. يُرجى العلم أنّه سيتم عرض حِزم 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 |
: خريطة السمات التي سيتمّ إضافتها |
allowStagingRemoteFile
public void allowStagingRemoteFile (boolean stageRemoteFile)
لضبط الإذن للسماح بنشر الملفات البعيدة.
المعلمات | |
---|---|
stageRemoteFile |
boolean |
cleanUp
public void cleanUp ()
محو أي ملفات مؤقتة للإصدار
cleanUp
public void cleanUp (doNotClean)
إصدار cleanUp()
الذي لا يتم فيه حذف بعض الملفات
المعلمات | |
---|---|
doNotClean |
|
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
publicgetAppPackageFiles ()
الحصول على نسخة من مجموعة ملفات APK للتطبيقات المحلية وإصداراتها يتطابق الترتيب المعروض
مع الترتيب الذي تمت فيه إضافة حِزم apk إلى IAppBuildInfo
.
المرتجعات | |
---|---|
|
getBuildAttributes
publicgetBuildAttributes ()
الحصول على مجموعة من أزواج الاسم والقيمة للسمات الإضافية التي تصف الإصدار
المرتجعات | |
---|---|
|
ERROR(/Map) من سمات التصميم لن يكون null ، ولكن قد يكون فارغًا. |
getBuildBranch
public String getBuildBranch ()
طريقة اختيارية لعرض فرع التحكّم في المصدر الذي تمّت إنشاء الإصدار الذي يتم اختباره منه.
المرتجعات | |
---|---|
String |
فرع الإصدار أو null في حال عدم ضبطه/عدم انطباقه |
getBuildFlavor
public String getBuildFlavor ()
طريقة اختيارية لعرض نوع الإصدار الذي يتم اختباره
من الشائع أن يتم عرض القيمة التالية لإصدارات نظام Android: (build product)-(build os)-(build variant). ie generic-linux-userdebug
المرتجعات | |
---|---|
String |
نكهة الإصدار أو null في حال عدم ضبطها/عدم انطباقها |
getBuildId
public String getBuildId ()
تعرِض هذه السمة المعرّف الفريد للإصدار قيد الاختبار. يجب ألا تكون فارغة أبدًا. الإعداد التلقائي هو UNKNOWN_BUILD_ID
.
المرتجعات | |
---|---|
String |
getBuildTargetName
public String getBuildTargetName ()
عرض الاسم الكامل للإصدار الذي يتم اختباره
من الشائع إنشاء اسم هدف الإنشاء من تركيبة من نكهة الإنشاء واسم الفرع. [أي (اسم الفرع)-(نكهة الإصدار)]
المرتجعات | |
---|---|
String |
getDeviceSerial
public String getDeviceSerial ()
المرتجعات | |
---|---|
String |
getFile
public File getFile (String name)
طريقة مساعدة لاسترداد ملف باسم معيّن
المرتجعات | |
---|---|
File |
ملف الصورة أو null في حال عدم العثور عليه |
getFile
public File getFile (BuildInfoKey.BuildInfoFileKey key)
طريقة مساعدة لاسترداد ملف باستخدام BuildInfoFileKey
معيّن.
المعلمات | |
---|---|
key |
BuildInfoKey.BuildInfoFileKey : BuildInfoFileKey المطلوب |
المرتجعات | |
---|---|
File |
ملف الصورة أو null في حال عدم العثور عليه |
getProperties
publicgetProperties ()
تعرِض هذه الدالة نسخة من السمات التي تم ضبطها حاليًا في IBuildInfo
.
المرتجعات | |
---|---|
|
getRemoteFiles
publicgetRemoteFiles ()
الحصول على مسارات عناصر الإنشاء التي يتم تأخير تنزيلها
المرتجعات | |
---|---|
|
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
publicgetVersionedFileKeys ()
تُعيد مجموعة المفاتيح المتاحة لاستعلام VersionedFile
من خلال getFile(BuildInfoFileKey)
.
المرتجعات | |
---|---|
|
getVersionedFiles
public finalgetVersionedFiles (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 |
toString
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
protectedgetVersionedFileMap ()
المرتجعات | |
---|---|
|
getVersionedFileMapFull
protected MultiMap<String, VersionedFile> getVersionedFileMapFull ()
المرتجعات | |
---|---|
MultiMap<String, VersionedFile> |