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 ( buildAttributes) addBuildAttributes ( buildAttributes) ویژگی های ساخت را اضافه کنید |
void | allowStagingRemoteFile (boolean stageRemoteFile) اجازه را برای اجازه دادن به مرحلهبندی فایلهای راه دور تنظیم میکند. |
void | cleanUp () تمامی فایل های ساخت موقت را پاک کنید |
void | cleanUp ( doNotClean) cleanUp ( doNotClean) نسخه |
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) یک ویژگی Name داده شده را از ردیابی حذف کنید. |
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) فایلی را که بخشی از فایل های راه دور است در root dir اطلاعات ساخت مرحله بندی کنید. |
BuildInformation.BuildInfo | toProto () یک نمونه BuildInfo را در یک پروتوباف سریال کنید. |
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 : نام هدف ساخت |
روش های عمومی
افزودنAppPackageFile
public void addAppPackageFile (File appPackageFile, String version)
فایل apk محلی و نسخه مرتبط با آن را اضافه می کند. توجه داشته باشید که apk ها به ترتیبی که با این روش اضافه شده اند، از getAppPackageFiles()
بازگردانده می شوند.
پارامترها | |
---|---|
appPackageFile | File |
version | String |
addBuildAttribute
public void addBuildAttribute (String attributeName, String attributeValue)
یک ویژگی ساخت اضافه کنید. این اجازه نمیدهد که یک ویژگیName موجود لغو شود.
پارامترها | |
---|---|
attributeName | String : نام ویژگی منحصر به فرد |
attributeValue | String : مقدار مشخصه |
addBuildAttributes
public void addBuildAttributes (buildAttributes)
ویژگی های ساخت را اضافه کنید
پارامترها | |
---|---|
buildAttributes |
allowStagingRemoteFile
public void allowStagingRemoteFile (boolean stageRemoteFile)
اجازه را برای اجازه دادن به مرحلهبندی فایلهای راه دور تنظیم میکند.
پارامترها | |
---|---|
stageRemoteFile | boolean |
پاکسازی
public void 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 |
از پروتو
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 ()
روش اختیاری برای برگرداندن نوع ساخت مورد آزمایش.
یک پیاده سازی متداول برای بیلدهای پلتفرم اندروید، بازگشت (ساخت محصول) - (ساخت سیستم عامل) - (نوع ساخت) است. یعنی generic-linux-userdbug
برمی گرداند | |
---|---|
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 |
getFiles
publicgetFiles ()
همه VersionedFile
های ذخیره شده در این BuildInfo
را برمی گرداند.
برمی گرداند | |
---|---|
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 |
هش کد
public int hashCode ()
برمی گرداند | |
---|---|
int |
removeBuildAttribute
public void removeBuildAttribute (String attributeName)
یک ویژگی Name داده شده را از ردیابی حذف کنید.
پارامترها | |
---|---|
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)
فایلی را که بخشی از فایل های راه دور است در root dir اطلاعات ساخت مرحله بندی کنید.
TODO(b/138416078): هنگامی که ماژولهای مورد نیاز یک تست را میتوان به درستی خروجی به دایرکتوری ماژول تست کرد، این رابط و تماسگیرنده آن را حذف کنید.
پارامترها | |
---|---|
fileName | String : نام فایلی که در فایل های راه دور قرار می گیرد. |
workingDir | File : یک شیء ERROR(/File) از دایرکتوری برای مرحله بندی فایل. |
برمی گرداند | |
---|---|
File | شیء ERROR(/File) فایل در WorkDir محلی مرحله بندی شده است. |
به پروتو
public BuildInformation.BuildInfo toProto ()
یک نمونه BuildInfo را در یک پروتوباف سریال کنید.
برمی گرداند | |
---|---|
BuildInformation.BuildInfo |
toString
public String toString ()
برمی گرداند | |
---|---|
String |
روش های محافظت شده
addAllBuildAttributes
protected void addAllBuildAttributes (BuildInfo build)
روش کمکی برای کپی کردن ویژگی های ساخت، شاخه و طعم از ساخت های دیگر.
پارامترها | |
---|---|
build | BuildInfo |
addAllFiles
protected void addAllFiles (BuildInfo build)
روش کمکی برای کپی کردن همه فایل ها از ساخت دیگر.
هاردلینک های جدید به فایل ها ایجاد می کند تا هر بیلد یک مسیر فایل منحصر به فرد به فایل داشته باشد.
پارامترها | |
---|---|
build | BuildInfo |
پرتاب می کند | |
---|---|
| اگر در هنگام ایجاد هاردلینک استثنا وجود داشته باشد. |
applicationBuildProperties
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 > |