معلومات الإصدار

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)

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

void allowStagingRemoteFile(boolean stageRemoteFile)

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

void cleanUp()

حذف أي ملفات إصدار مؤقتة

void 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 في نموذج أوّلي.

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: اسم هدف الإصدار

الطرق العامة

إضافة ملف AppPackageFile

public void addAppPackageFile (File appPackageFile, 
                String version)

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

المعلمات
appPackageFile File

version String

إضافة سمة بناء

public void addBuildAttribute (String attributeName, 
                String attributeValue)

أضِف سمة الإصدار. لا يسمح ذلك بتجاهل سمةattributeName حالية.

المعلمات
attributeName String: اسم السمة الفريدة
attributeValue String: قيمة السمة

إضافة سمات بناء

public void addBuildAttributes ( buildAttributes)

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

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

السماح بـ"StagingRemoteFile"

public void allowStagingRemoteFile (boolean stageRemoteFile)

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

المعلمات
stageRemoteFile boolean

تنظيف

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

الحصول على ملفات AppPackageFiles

public  getAppPackageFiles ()

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

المرتجعات

getBuildAttributes

public  getBuildAttributes ()

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

المرتجعات
ERROR(/Map) لسمات الإصدار. لن يكون الحقل null، ولكنه قد يكون فارغًا.

getBuildBranch

public String getBuildBranch ()

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

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

الحصول على BuildFLAor

public String getBuildFlavor ()

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

يتمثل التنفيذ الشائع لإصدارات نظام Android الأساسي في إرجاع (إنشاء المنتج)-(إنشاء نظام التشغيل)-(إنشاء الصيغة). مثال: generic-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 إذا لم يتم العثور عليه

استرداد الملفات

public  getFiles ()

عرض جميع VersionedFile المحفوظة في BuildInfo

المرتجعات

الحصول على خصائص

public  getProperties ()

عرض نسخة من السمات المعيّنة حاليًا على IBuildInfo.

المرتجعات

استرداد الملفات عن بُعد

public  getRemoteFiles ()

يمكنك الحصول على مسارات عناصر الإنشاء التي تأخر تنزيلها.

المرتجعات

الحصول على علامة اختبار

public String getTestTag ()

أدخِل اسمًا فريدًا للاختبارات التي يتم إجراؤها.

المرتجعات
String

الحصول على الإصدار

public String getVersion (BuildInfoKey.BuildInfoFileKey key)

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

المعلمات
key BuildInfoKey.BuildInfoFileKey: المبلغ المطلوب هو BuildInfoFileKey.
المرتجعات
String نسخة الصورة أو null إذا لم يتم العثور عليه

الحصول على الإصدار

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

رمز التجزئة

public int hashCode ()

المرتجعات
int

إزالة سمة التصميم

public void removeBuildAttribute (String attributeName)

يجب إزالة سمةattributeName معيّنة من التتبع.

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

setBuildBranch

public void setBuildBranch (String branch)

تحديد فرع الإصدار

المعلمات
branch String: اسم الفرع

مجموعة BuildFlamor

public void setBuildFlavor (String buildFlavor)

اضبط صيغة التصميم.

setBuildId

public void setBuildId (String buildId)

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

المعلمات
buildId String

ضبط الجهاز التسلسلي

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) للملف مرحلي في WorkDir المحلي.

إلى Proto

public BuildInformation.BuildInfo toProto ()

تسلسل مثيل BuildInfo في نموذج أوّلي.

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

إلىسلسلة

public String toString ()

المرتجعات
String

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

addAllBuildAttributes

protected void addAllBuildAttributes (BuildInfo build)

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

المعلمات
build BuildInfo

إضافة كل الملفات

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 صحيح إذا طبقنا الخصائص ويجب تخطي المعالجة الإضافية. خطأ وإلا.

الحصول على سمات خرائط متعددة

protected MultiMap<String, String> getAttributesMultiMap ()

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

خريطة الملف getVersionedFile

protected  getVersionedFileMap ()

المرتجعات

getVersionedFileMapFull

protected MultiMap<String, VersionedFile> getVersionedFileMapFull ()

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