BuildInfo

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(Map<String, String> buildAttributes)

إضافة سمات الإصدار

void allowStagingRemoteFile(boolean stageRemoteFile)

يضبط هذا الخيار الإذن بالسماح بتنظيم الملفات البعيدة.

void cleanUp()

حذف أي ملفات إنشاء مؤقتة

void cleanUp(List<File> doNotClean)

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

IBuildInfo clone()

final void copyAllFileFrom(BuildInfo build)

نسخ كل VersionedFile من إصدار معيّن إلى هذا الإصدار

boolean equals(Object obj)

static IBuildInfo fromProto(BuildInformation.BuildInfo protoBuild)

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

List<VersionedFile> getAppPackageFiles()

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

Map<String, String> getBuildAttributes()

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

String getBuildBranch()

طريقة اختيارية لعرض فرع نظام إدارة المصادر الذي تم إنشاء الإصدار الذي يتم اختباره منه.

String getBuildFlavor()

طريقة اختيارية لعرض نوع الإصدار الذي يتم اختباره

String getBuildId()

تعرِض هذه السمة المعرّف الفريد للإصدار قيد الاختبار.

String getBuildTargetName()

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

String getDeviceSerial()

File getFile(String name)

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

File getFile(BuildInfoKey.BuildInfoFileKey key)

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

Collection<VersionedFile> getFiles()

تعرض هذه الدالة جميع قيم VersionedFile المخزَّنة في BuildInfo.

Set<IBuildInfo.BuildInfoProperties> getProperties()

تعرض هذه الطريقة نسخة من الخصائص المضبوطة حاليًا على IBuildInfo.

Set<File> 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 باسم معيّن.

Set<String> getVersionedFileKeys()

تعرض هذه السمة مجموعة المفاتيح المتاحة للاستعلام عن VersionedFile من خلال getFile(BuildInfoFileKey).

final List<VersionedFile> 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(BuildInfoKey.BuildInfoFileKey key, File file, String version)

يخزِّن ملفًا معرَّفًا بـ BuildInfoFileKey في معلومات الإصدار هذه.

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

يخزِّن ملفًا بالاسم المحدّد في معلومات الإصدار هذه.

void setProperties(BuildInfoProperties... properties)

اضبط BuildInfoProperties لموضع التكرار IBuildInfo.

void setTestTag(String testTag)

يضبط هذا الحقل الاسم الفريد للاختبارات التي يتم إجراؤها.

File stageRemoteFile(String fileName, File workingDir)

تجهيز ملف يشكّل جزءًا من الملفات البعيدة في الدليل الجذر لمعلومات الإصدار

BuildInformation.BuildInfo toProto()

تسلسل مثيل BuildInfo إلى بروتوكول buffer.

String toString()

طُرق محمية

void addAllBuildAttributes(BuildInfo build)

طريقة مساعدة لنسخ سمات الإصدار والفرع والنوع من إصدار آخر

void addAllFiles(BuildInfo build)

طريقة مساعدة لنسخ جميع الملفات من الإصدار الآخر

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

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

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

طُرق وضع التصميم العامة

BuildInfo

public BuildInfo ()

تنشئ هذه الطريقة BuildInfo باستخدام قيم السمات التلقائية.

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 (Map<String, String> buildAttributes)

إضافة سمات الإصدار

المعلَمات
buildAttributes Map: خريطة السمات التي ستتم إضافتها

allowStagingRemoteFile

public void allowStagingRemoteFile (boolean stageRemoteFile)

يضبط هذا الخيار الإذن بالسماح بتنظيم الملفات البعيدة.

المعلَمات
stageRemoteFile boolean

cleanUp

public void cleanUp ()

حذف أي ملفات إنشاء مؤقتة

cleanUp

public void cleanUp (List<File> doNotClean)

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

المعلَمات
doNotClean List

استنساخ

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 List<VersionedFile> getAppPackageFiles ()

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

المرتجعات
List<VersionedFile>

getBuildAttributes

public Map<String, String> getBuildAttributes ()

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

المرتجعات
Map<String, String> Map من سمات الإصدار لن تكون القيمة null، ولكن قد تكون فارغة.

getBuildBranch

public String getBuildBranch ()

طريقة اختيارية لعرض فرع نظام إدارة المصادر الذي تم إنشاء الإصدار الذي يتم اختباره منه.

المرتجعات
String فرع الإصدار أو null إذا لم يتم ضبطه/لم يكن منطبقًا

getBuildFlavor

public String getBuildFlavor ()

طريقة اختيارية لعرض نوع الإصدار الذي يتم اختباره

تتمثل إحدى طرق التنفيذ الشائعة لإنشاء نظام Android الأساسي في عرض (إصدار المنتج)-(نظام التشغيل)-(تنويعة التصميم). ie generic-linux-userdebug

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

getBuildId

public String getBuildId ()

تعرِض هذه السمة المعرّف الفريد للإصدار قيد الاختبار. يجب ألا تكون القيمة فارغة. القيمة التلقائية هي UNKNOWN_BUILD_ID.

المرتجعات
String

getBuildTargetName

public String getBuildTargetName ()

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

تتمثل إحدى طرق التنفيذ الشائعة في إنشاء اسم هدف الإصدار من خلال الجمع بين نوع الإصدار واسم الفرع. [ie (اسم الفرع)-(نوع الإصدار)]

المرتجعات
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 إذا لم يتم العثور عليه

getFiles

public Collection<VersionedFile> getFiles ()

تعرض هذه الدالة جميع قيم VersionedFile المخزَّنة في BuildInfo.

المرتجعات
Collection<VersionedFile>

getProperties

public Set<IBuildInfo.BuildInfoProperties> getProperties ()

تعرض هذه الطريقة نسخة من الخصائص المضبوطة حاليًا على IBuildInfo.

المرتجعات
Set<IBuildInfo.BuildInfoProperties>

getRemoteFiles

public Set<File> getRemoteFiles ()

الحصول على مسارات عناصر الإصدار التي يتم تأخير تنزيلها

المرتجعات
Set<File>

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 Set<String> getVersionedFileKeys ()

تعرض هذه السمة مجموعة المفاتيح المتاحة للاستعلام عن VersionedFile من خلال getFile(BuildInfoFileKey).

المرتجعات
Set<String>

getVersionedFiles

public final List<VersionedFile> getVersionedFiles (BuildInfoKey.BuildInfoFileKey key)

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

المعلَمات
key BuildInfoKey.BuildInfoFileKey: BuildInfoFileKey المطلوب
المرتجعات
List<VersionedFile> الملف الذي تمّت إدارته أو 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 (BuildInfoKey.BuildInfoFileKey key, 
                File file, 
                String version)

يخزِّن ملفًا معرَّفًا بـ BuildInfoFileKey في معلومات الإصدار هذه.

المعلَمات
key ‫BuildInfoKey.BuildInfoFileKey: الاسم الفريد للملف استنادًا إلى BuildInfoFileKey.
file File: File المحلي
version ‫String: إصدار الملف

setFile

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

يخزِّن ملفًا بالاسم المحدّد في معلومات الإصدار هذه.

المعلَمات
name ‫String: الاسم الفريد للملف
file File: 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): Remove this interface and its caller when modules required by a test can be properly built output to the test module's directory itself.

المعلَمات
fileName String: اسم الملف الذي سيتم تحديد موقعه في الملفات البعيدة.
workingDir File: كائن File خاص بالدليل لتنظيم الملف.
المرتجعات
File كائن File للملف الذي تم إعداده في workingDir المحلي

toProto

public BuildInformation.BuildInfo toProto ()

تسلسل مثيل BuildInfo إلى بروتوكول buffer.

المرتجعات
BuildInformation.BuildInfo

toString

public String toString ()

المرتجعات
String

طُرق محمية

addAllBuildAttributes

protected void addAllBuildAttributes (BuildInfo build)

طريقة مساعدة لنسخ سمات الإصدار والفرع والنوع من إصدار آخر

المعلَمات
build BuildInfo

addAllFiles

protected void addAllFiles (BuildInfo build)

طريقة مساعدة لنسخ جميع الملفات من الإصدار الآخر

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

المعلَمات
build BuildInfo

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

applyBuildProperties

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

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

المعلَمات
origFileConsidered ‫VersionedFile: VersionedFile الذي يتم عرضه حاليًا
build ‫IBuildInfo: الإصدار الأصلي الذي يتم نسخه
receiver ‫IBuildInfo: الإصدار الذي يتلقّى المعلومات
المرتجعات
boolean يتم ضبط القيمة على "true" إذا طبّقنا الخصائص ويجب تخطّي المزيد من المعالجة. False otherwise.

getAttributesMultiMap

protected MultiMap<String, String> getAttributesMultiMap ()

المرتجعات
MultiMap<String, String>

getVersionedFileMap

protected Map<String, VersionedFile> getVersionedFileMap ()

المرتجعات
Map<String, VersionedFile>

getVersionedFileMapFull

protected MultiMap<String, VersionedFile> getVersionedFileMapFull ()

المرتجعات
MultiMap<String, VersionedFile>