اطلاعات ساخت

public class BuildInfo
extends Object implements IBuildInfo

شیء جاوا
↳ 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)

یک ویژگی داده شده به نام Name را از ردیابی حذف کنید.

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)

فایلی را که بخشی از فایل‌های راه دور در دایرکتوری ریشه build info است، استیج کنید.

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 ()
Map<String, VersionedFile > getVersionedFileMap ()
MultiMap <String, VersionedFile > getVersionedFileMapFull ()

سازندگان عمومی

اطلاعات ساخت 

public BuildInfo ()

با استفاده از مقادیر پیش‌فرض ویژگی‌ها، یک BuildInfo ایجاد می‌کند.

اطلاعات ساخت 

public BuildInfo (String buildId, 
                String buildTargetName)

یک BuildInfo ایجاد می‌کند

پارامترها
buildId String : شناسه ساخت

buildTargetName String : نام هدف ساخت

روش‌های عمومی

فایل بسته‌ی برنامه‌ی اضافه 

public void addAppPackageFile (File appPackageFile, 
                String version)

فایل apk محلی و نسخه مرتبط با آن را اضافه می‌کند. توجه داشته باشید که apkها به ترتیبی که توسط این متد اضافه شده‌اند، از getAppPackageFiles() برگردانده می‌شوند.

پارامترها
appPackageFile File

version String

addBuildAttribute 

public void addBuildAttribute (String attributeName, 
                String attributeValue)

یک ویژگی ساخت اضافه کنید. این اجازه نمی‌دهد که یک ویژگی نام موجود را نادیده بگیرید.

پارامترها
attributeName String : نام ویژگی منحصر به فرد

attributeValue String : مقدار ویژگی

addBuildAttributes 

public void addBuildAttributes (Map<String, String> buildAttributes)

اضافه کردن ویژگی‌های ساخت

پارامترها
buildAttributes Map : نقشه ویژگی‌هایی که باید اضافه شوند

allowStagingRemoteFile 

public void allowStagingRemoteFile (boolean stageRemoteFile)

مجوزی را برای امکان مرحله‌بندی فایل‌های راه دور تنظیم می‌کند.

پارامترها
stageRemoteFile boolean

پاکسازی 

public void cleanUp ()

فایل‌های ساخت موقت را پاک کنید

پاکسازی 

public void cleanUp (List<File> doNotClean)

نسخه‌ای از cleanUp() که در آن برخی از فایل‌ها حذف نمی‌شوند.

پارامترها
doNotClean List

کلون 

public IBuildInfo clone ()

بازگشت‌ها
IBuildInfo

کپی کردن همه فایل‌ها از 

public final void copyAllFileFrom (BuildInfo build)

تمام VersionedFile از یک ساخت مشخص به این ساخت کپی کنید.

پارامترها
build BuildInfo

برابر است 

public boolean equals (Object obj)

پارامترها
obj Object

بازگشت‌ها
boolean

ازپروتو 

public static IBuildInfo fromProto (BuildInformation.BuildInfo protoBuild)

عملیات معکوس toProto() برای بازگرداندن نمونه.

پارامترها
protoBuild BuildInformation.BuildInfo

بازگشت‌ها
IBuildInfo

دریافت فایل‌های بسته‌ی برنامه 

public List<VersionedFile> getAppPackageFiles ()

یک کپی از مجموعه فایل(های) apk برنامه محلی و نسخه‌های آنها را دریافت می‌کند. ترتیب برگردانده شده با ترتیبی که apkها به IAppBuildInfo اضافه شده‌اند، مطابقت دارد.

بازگشت‌ها
List< VersionedFile >

getBuildAttributes 

public Map<String, String> getBuildAttributes ()

مجموعه‌ای از جفت‌های نام-مقدار از ویژگی‌های اضافی که ساختار را توصیف می‌کنند، دریافت کنید.

بازگشت‌ها
Map<String, String> Map از ویژگی‌های ساخت. null نخواهد بود، اما می‌تواند خالی باشد.

شاخه‌ی ساخت‌وساز 

public String getBuildBranch ()

روشی اختیاری برای بازگرداندن شاخه‌ی کنترل منبع که نسخه‌ای که قرار است آزمایش شود از آن تولید شده است.

بازگشت‌ها
String شاخه ساخت یا در صورت تنظیم نشدن/عدم کاربرد، null

دریافت‌کننده 

public String getBuildFlavor ()

روشی اختیاری برای بازگرداندن نوع ساختی که در حال آزمایش است.

یک پیاده‌سازی رایج برای ساخت‌های پلتفرم اندروید، برگرداندن (build product)-(build os)-(build variant) است. یعنی generic-linux-userdebug

بازگشت‌ها
String اگر unset/unapplicable باشد، مقدار build flavor یا null برمی‌گرداند.

دریافت شناسه ساخت 

public String getBuildId ()

شناسه منحصر به فرد ساخت تحت آزمایش را برمی‌گرداند. هرگز نباید تهی باشد. مقدار پیش‌فرض UNKNOWN_BUILD_ID است.

بازگشت‌ها
String

دریافت نام هدف Build 

public String getBuildTargetName ()

نام کامل ساختاری که در حال آزمایش است را برمی‌گرداند.

یک پیاده‌سازی رایج، ساخت نام هدف ساخت از ترکیبی از طعم ساخت و نام شاخه است. [یعنی (نام شاخه)-(طعم ساخت)]

بازگشت‌ها
String

سریال دستگاه را دریافت کنید 

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 Collection<VersionedFile> getFiles ()

تمام VersionedFile های ذخیره شده در این BuildInfo را برمی‌گرداند.

بازگشت‌ها
Collection< VersionedFile >

دریافت ویژگی‌ها 

public Set<IBuildInfo.BuildInfoProperties> getProperties ()

یک کپی از ویژگی‌هایی که در حال حاضر روی IBuildInfo تنظیم شده‌اند را برمی‌گرداند.

بازگشت‌ها
Set< IBuildInfo.BuildInfoProperties >

دریافت فایل‌های راه دور 

public Set<File> getRemoteFiles ()

مسیرهای مربوط به ساخت مصنوعاتی که دانلود آنها با تأخیر مواجه است را دریافت کنید.

بازگشت‌ها
Set<File>

تگ getTest 

public String getTestTag ()

یک نام منحصر به فرد برای تست‌های در حال اجرا برمی‌گرداند.

بازگشت‌ها
String

دریافت نسخه 

public String getVersion (BuildInfoKey.BuildInfoFileKey key)

متد کمکی برای بازیابی نسخه فایل با استفاده از BuildInfoFileKey داده شده.

پارامترها
key BuildInfoKey.BuildInfoFileKey : کلید BuildInfoFileKey درخواست شده.

بازگشت‌ها
String نسخه تصویر یا در صورت عدم یافتن، null

دریافت نسخه 

public String getVersion (String name)

متد کمکی برای بازیابی نسخه فایل با نام داده شده.

بازگشت‌ها
String نسخه تصویر یا در صورت عدم یافتن، null

دریافت فایل نسخه‌بندی‌شده 

public VersionedFile getVersionedFile (BuildInfoKey.BuildInfoFileKey key)

متد کمکی برای بازیابی یک VersionedFile با یک BuildInfoFileKey داده شده.

پارامترها
key BuildInfoKey.BuildInfoFileKey : کلید BuildInfoFileKey درخواست شده.

بازگشت‌ها
VersionedFile فایل نسخه‌بندی شده یا در صورت عدم یافتن null

دریافت فایل نسخه‌بندی‌شده 

public final VersionedFile getVersionedFile (String name)

متد کمکی برای بازیابی یک VersionedFile با نام مشخص.

بازگشت‌ها
VersionedFile فایل نسخه‌بندی شده یا در صورت عدم یافتن null

کلیدهای فایل نسخه‌بندی‌شده را دریافت کنید 

public Set<String> getVersionedFileKeys ()

مجموعه کلیدهای موجود برای جستجوی VersionedFile از طریق getFile(BuildInfoFileKey) را برمی‌گرداند.

بازگشت‌ها
Set<String>

فایل‌های دریافت‌شده 

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

متد کمکی برای بازیابی لیستی از VersionedFile های مرتبط با یک BuildInfoFileKey داده شده. در صورتی که کلید اجازه ذخیره لیست را بدهد.

پارامترها
key BuildInfoKey.BuildInfoFileKey : کلید BuildInfoFileKey درخواست شده.

بازگشت‌ها
List< VersionedFile > فایل نسخه‌بندی شده یا در صورت عدم یافتن null

کد هش 

public int hashCode ()

بازگشت‌ها
int

حذف ویژگی ساخت 

public void removeBuildAttribute (String attributeName)

یک ویژگی داده شده به نام Name را از ردیابی حذف کنید.

پارامترها
attributeName String : ویژگی برای توقف ردیابی

شاخه‌ی تنظیم‌شده‌ی ساخت 

public void setBuildBranch (String branch)

شاخه ساخت را تنظیم کنید

پارامترها
branch String : نام شاخه

مجموعه ساخت طعم 

public void setBuildFlavor (String buildFlavor)

طعم ساخت را تنظیم کنید.

شناسه ساخت را تنظیم کنید 

public void setBuildId (String buildId)

شناسه منحصر به فرد ساخت تحت آزمایش را تنظیم می‌کند. هرگز نباید تهی باشد.

پارامترها
buildId String

سریال دستگاه را تنظیم کنید 

public void setDeviceSerial (String serial)

سریال ITestDevice مرتبط با این ساخت را تنظیم کنید.

پارامترها
serial String : شماره سریال ITestDevice که این ساخت با آن اجرا شده است.

تنظیم فایل 

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

فایلی را که با BuildInfoFileKey مشخص شده است، در این اطلاعات ساخت ذخیره می‌کند.

پارامترها
key BuildInfoKey.BuildInfoFileKey : نام منحصر به فرد فایل بر اساس BuildInfoFileKey .

file File : File محلی

version String : نسخه فایل

تنظیم فایل 

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

فایلی با نام داده شده را در این اطلاعات ساخت ذخیره می‌کند.

پارامترها
name String : نام منحصر به فرد فایل

file File : File محلی

version String : نسخه فایل

مجموعه ویژگی‌ها 

public void setProperties (BuildInfoProperties... properties)

BuildInfoProperties برای نمونه IBuildInfo تنظیم کنید. هر ویژگی موجود تنظیم شده قبلی را لغو کنید.

پارامترها
properties BuildInfoProperties : فهرست ویژگی‌هایی که باید اضافه شوند.

تنظیمTestTag 

public void setTestTag (String testTag)

نام منحصر به فرد برای تست‌های در حال اجرا را تنظیم می‌کند.

پارامترها
testTag String

فایل از راه دور مرحله‌ای 

public File stageRemoteFile (String fileName, 
                File workingDir)

فایلی را که بخشی از فایل‌های راه دور در دایرکتوری ریشه build info است، استیج کنید.

TODO(b/138416078): این رابط و فراخواننده‌ی آن را هنگامی که ماژول‌های مورد نیاز یک تست می‌توانند به درستی ساخته شوند و خروجی را در دایرکتوری خود ماژول تست قرار دهند، حذف کنید.

پارامترها
fileName String : نام فایلی که قرار است در فایل‌های راه دور قرار گیرد.

workingDir File : یک شیء File از دایرکتوری برای مرحله‌بندی فایل.

بازگشت‌ها
File شیء File مربوط به فایلی که در workingDir محلی قرار دارد.

توپروتو 

public BuildInformation.BuildInfo toProto ()

یک نمونه BuildInfo را به یک protobuf سریالایز کنید.

بازگشت‌ها
BuildInformation.BuildInfo

رشته‌ی دوتایی 

public String toString ()

بازگشت‌ها
String

روش‌های محافظت‌شده

addAllBuildAttributes 

protected void addAllBuildAttributes (BuildInfo build)

متد کمکی برای کپی کردن ویژگی‌های ساخت، شاخه و طعم آن از ساخت دیگر.

پارامترها
build BuildInfo

اضافه کردن همه فایل‌ها 

protected void addAllFiles (BuildInfo build)

روش کمکی برای کپی کردن تمام فایل‌ها از ساخت دیگر.

پیوندهای سخت جدیدی به فایل‌ها ایجاد می‌کند تا هر ساخت، مسیر فایل منحصر به فردی به آن فایل داشته باشد.

پارامترها
build BuildInfo

پرتاب‌ها
IOException اگر هنگام ایجاد hardlink یک استثنا ایجاد شود.

اعمال ویژگی‌های ساخت 

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

اجازه دهید برخی از IBuildInfo.BuildInfoProperties اعمال شوند و احتمالاً مدیریت متفاوتی انجام شود.

پارامترها
origFileConsidered VersionedFile : VersionedFile که در حال حاضر مورد بررسی قرار گرفته است.

build IBuildInfo : نسخه اصلی در حال کلون شدن

receiver IBuildInfo : ساختمانی که اطلاعات را دریافت می‌کند.

بازگشت‌ها
boolean اگر ویژگی‌ها را اعمال کرده باشیم، مقدار True برمی‌گرداند و از انجام پردازش‌های بیشتر صرف نظر می‌شود. در غیر این صورت، مقدار False برمی‌گرداند.

getAttributesMultiMap 

protected MultiMap<String, String> getAttributesMultiMap ()

بازگشت‌ها
MultiMap <String, String>

دریافت نقشه فایل نسخه‌بندی‌شده 

protected Map<String, VersionedFile> getVersionedFileMap ()

بازگشت‌ها
Map<String, VersionedFile >

دریافت نسخه کامل نقشه فایل 

protected MultiMap<String, VersionedFile> getVersionedFileMapFull ()

بازگشت‌ها
MultiMap <String, VersionedFile >