IBuildInfo

public interface IBuildInfo

com.android.tradefed.build.IBuildInfo

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

خلاصه

ثابت ها

String REMOTE_FILE_PREFIX

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

String REMOTE_FILE_VERSION

فایل راه دور نسخه نشده است.

String UNKNOWN_BUILD_ID

مقدار پیش‌فرض زمانی که شناسه ساخت ناشناخته است.

روش های عمومی

default void addAppPackageFile (File appPackageFile, String version)

فایل apk محلی و نسخه مرتبط با آن را اضافه می کند.

abstract void addBuildAttribute (String attributeName, String attributeValue)

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

default void addBuildAttributes ( buildAttributes) addBuildAttributes ( buildAttributes)

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

default void allowStagingRemoteFile (boolean stageRemoteFile)

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

abstract void cleanUp ()

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

abstract void cleanUp ( doNotDelete) cleanUp ( doNotDelete)

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

abstract IBuildInfo clone ()

شی IBuildInfo را کلون می کند.

default getAppPackageFiles ()

یک کپی از مجموعه فایل(های) apk برنامه محلی و نسخه های آنها دریافت می کند.

abstract getBuildAttributes ()

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

abstract String getBuildBranch ()

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

abstract String getBuildFlavor ()

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

abstract String getBuildId ()

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

abstract String getBuildTargetName ()

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

abstract String getDeviceSerial ()
abstract File getFile (String name)

روش کمکی برای بازیابی یک فایل با نام مشخص.

default File getFile ( BuildInfoKey.BuildInfoFileKey key)

روش کمکی برای بازیابی یک فایل با یک BuildInfoFileKey داده شده.

abstract getFiles ()

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

abstract getProperties ()

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

default getRemoteFiles ()

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

abstract String getTestTag ()

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

default String getVersion ( BuildInfoKey.BuildInfoFileKey key)

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

abstract String getVersion (String name)

روش کمکی برای بازیابی نسخه فایل با نام مشخص.

default VersionedFile getVersionedFile ( BuildInfoKey.BuildInfoFileKey key)

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

default VersionedFile getVersionedFile (String name)

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

default getVersionedFileKeys ()

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

default getVersionedFiles ( BuildInfoKey.BuildInfoFileKey key)

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

default void removeBuildAttribute (String attributeName)

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

abstract void setBuildBranch (String branch)

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

abstract void setBuildFlavor (String buildFlavor)

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

abstract void setBuildId (String buildId)

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

abstract void setDeviceSerial (String serial)

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

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

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

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

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

abstract void setProperties ( BuildInfoProperties... properties)

BuildInfoProperties برای نمونه IBuildInfo تنظیم کنید.

abstract void setTestTag (String testTag)

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

default File stageRemoteFile (String fileName, File workingDir)

فایلی را که بخشی از فایل های راه دور است در root dir اطلاعات ساخت مرحله بندی کنید.

default BuildInformation.BuildInfo toProto ()

یک نمونه BuildInfo را در یک پروتوباف سریال کنید.

ثابت ها

REMOTE_FILE_PREFIX 

public static final String REMOTE_FILE_PREFIX

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

مقدار ثابت: "remote_file:"

REMOTE_FILE_VERSION 

public static final String REMOTE_FILE_VERSION

فایل راه دور نسخه نشده است.

مقدار ثابت: ""

UNKNOWN_BUILD_ID 

public static final String UNKNOWN_BUILD_ID

مقدار پیش‌فرض زمانی که شناسه ساخت ناشناخته است.

مقدار ثابت: "-1"

روش های عمومی

افزودنAppPackageFile 

public void addAppPackageFile (File appPackageFile, 
                String version)

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

پارامترها
appPackageFile File

version String

addBuildAttribute 

public abstract 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 abstract void cleanUp ()

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

پاکسازی 

public abstract void cleanUp ( doNotDelete)

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

پارامترها
doNotDelete

کلون 

public abstract IBuildInfo clone ()

شی IBuildInfo را کلون می کند.

برمی گرداند
IBuildInfo

getAppPackageFiles 

public  getAppPackageFiles ()

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

برمی گرداند

getBuildAttributes 

public abstract  getBuildAttributes ()

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

برمی گرداند
یک ERROR(/Map) از ویژگی های ساخت. null نخواهد بود، اما ممکن است خالی باشد.

getBuildBranch 

public abstract String getBuildBranch ()

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

برمی گرداند
String شاخه ساخت یا در صورت تنظیم نشدن/غیر قابل اجرا، null

getBuildFlavor 

public abstract String getBuildFlavor ()

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

یک پیاده سازی متداول برای بیلدهای پلتفرم اندروید، بازگشت (ساخت محصول) - (ساخت سیستم عامل) - (نوع ساخت) است. یعنی generic-linux-userdbug

برمی گرداند
String طعم ساخت یا در صورت تنظیم نشدن/غیر قابل اجرا، null

getBuildId 

public abstract String getBuildId ()

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

برمی گرداند
String

getBuildTargetName 

public abstract String getBuildTargetName ()

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

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

برمی گرداند
String

getDeviceSerial 

public abstract String getDeviceSerial ()

برمی گرداند
String سریال ITestDevice که این بیلد روی آن اجرا شد. اگر هیچ دستگاهی با این بیلد مرتبط نباشد، null برمی‌گرداند.

getFile 

public abstract File getFile (String name)

روش کمکی برای بازیابی یک فایل با نام مشخص.

برمی گرداند
File فایل تصویر یا در صورت یافت نشدن null

getFile 

public File getFile (BuildInfoKey.BuildInfoFileKey key)

روش کمکی برای بازیابی یک فایل با یک BuildInfoFileKey داده شده.

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

برمی گرداند
File فایل تصویر یا در صورت یافت نشدن null

getFiles 

public abstract  getFiles ()

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

برمی گرداند

getProperties 

public abstract  getProperties ()

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

برمی گرداند

getRemoteFiles 

public  getRemoteFiles ()

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

برمی گرداند

getTestTag 

public abstract String getTestTag ()

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

برمی گرداند
String

getVersion 

public String getVersion (BuildInfoKey.BuildInfoFileKey key)

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

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

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

getVersion 

public abstract String getVersion (String name)

روش کمکی برای بازیابی نسخه فایل با نام مشخص.

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

getVersionedFile 

public VersionedFile getVersionedFile (BuildInfoKey.BuildInfoFileKey key)

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

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

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

getVersionedFile 

public VersionedFile getVersionedFile (String name)

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

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

getVersionedFileKeys 

public  getVersionedFileKeys ()

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

برمی گرداند

getVersionedFiles 

public  getVersionedFiles (BuildInfoKey.BuildInfoFileKey key)

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

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

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

removeBuildAttribute 

public void removeBuildAttribute (String attributeName)

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

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

setBuildBranch 

public abstract void setBuildBranch (String branch)

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

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

setBuildFlavor 

public abstract void setBuildFlavor (String buildFlavor)

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

setBuildId 

public abstract void setBuildId (String buildId)

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

پارامترها
buildId String

setDeviceSerial 

public abstract void setDeviceSerial (String serial)

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

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

setFile 

public abstract 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 abstract void setProperties (BuildInfoProperties... properties)

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

پارامترها
properties BuildInfoProperties : لیستی از خواص برای افزودن.

setTestTag 

public abstract 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