IBuildInfo

public interface IBuildInfo

com.android.tradefed.build.IBuildInfo


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

خلاصه

کلاس های تو در تو

enum IBuildInfo.BuildInfoProperties

برخی از ویژگی‌هایی که یک 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)

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

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(BuildInfoKey.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 : نقشه ویژگی هایی که باید اضافه شوند

پاک کردن

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(BuildInfoKey.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