IBuildInfo
public
interface
IBuildInfo
com.android.tradefed.build.IBuildInfo |
Menyimpan informasi tentang build yang sedang diuji.
Ringkasan
Konstanta | |
---|---|
String |
REMOTE_FILE_PREFIX
Awalan yang digunakan dalam nama untuk menunjukkan bahwa file disetel untuk ditunda download-nya. |
String |
REMOTE_FILE_VERSION
File jarak jauh tidak memiliki versi. |
String |
UNKNOWN_BUILD_ID
Nilai default saat ID build tidak diketahui. |
Metode publik | |
---|---|
default
void
|
addAppPackageFile(File appPackageFile, String version)
Menambahkan file apk lokal dan versi terkaitnya. |
abstract
void
|
addBuildAttribute(String attributeName, String attributeValue)
Tambahkan atribut build. |
default
void
|
addBuildAttributes(
Menambahkan atribut build |
default
void
|
allowStagingRemoteFile(boolean stageRemoteFile)
Menetapkan izin untuk mengizinkan staging file jarak jauh. |
abstract
void
|
cleanUp()
Membersihkan file build sementara |
abstract
void
|
cleanUp(
Versi |
abstract
IBuildInfo
|
clone()
Meng-clone objek |
default
|
getAppPackageFiles()
Mendapatkan salinan kumpulan file apk aplikasi lokal dan versinya. |
abstract
|
getBuildAttributes()
Mendapatkan kumpulan pasangan nama-nilai atribut tambahan yang mendeskripsikan build. |
abstract
String
|
getBuildBranch()
Metode opsional untuk menampilkan cabang kontrol sumber tempat build yang sedang diuji dihasilkan. |
abstract
String
|
getBuildFlavor()
Metode opsional untuk menampilkan jenis build yang sedang diuji. |
abstract
String
|
getBuildId()
Menampilkan ID unik build yang sedang diuji. |
abstract
String
|
getBuildTargetName()
Menampilkan nama lengkap untuk build yang sedang diuji. |
abstract
String
|
getDeviceSerial()
|
abstract
File
|
getFile(String name)
Metode helper untuk mengambil file dengan nama yang diberikan. |
default
File
|
getFile(BuildInfoKey.BuildInfoFileKey key)
Metode helper untuk mengambil file dengan |
abstract
|
getFiles()
Menampilkan semua |
abstract
|
getProperties()
Menampilkan salinan properti yang saat ini ditetapkan di |
default
|
getRemoteFiles()
Mendapatkan jalur untuk artefak build yang ditunda download-nya. |
abstract
String
|
getTestTag()
Menampilkan nama unik untuk pengujian yang sedang dijalankan. |
default
String
|
getVersion(BuildInfoKey.BuildInfoFileKey key)
Metode helper untuk mengambil versi file dengan |
abstract
String
|
getVersion(String name)
Metode helper untuk mengambil versi file dengan nama yang diberikan. |
default
VersionedFile
|
getVersionedFile(BuildInfoKey.BuildInfoFileKey key)
Metode helper untuk mengambil |
default
VersionedFile
|
getVersionedFile(String name)
Metode bantuan untuk mengambil |
default
|
getVersionedFileKeys()
Menampilkan kumpulan kunci yang tersedia untuk membuat kueri |
default
|
getVersionedFiles(BuildInfoKey.BuildInfoFileKey key)
Metode helper untuk mengambil daftar |
default
void
|
removeBuildAttribute(String attributeName)
Menghapus attributeName tertentu dari pelacakan. |
abstract
void
|
setBuildBranch(String branch)
Menetapkan cabang build |
abstract
void
|
setBuildFlavor(String buildFlavor)
Tetapkan ragam build. |
abstract
void
|
setBuildId(String buildId)
Menetapkan ID unik build yang sedang diuji. |
abstract
void
|
setDeviceSerial(String serial)
Tetapkan serial |
abstract
void
|
setFile(String name, File file, String version)
Menyimpan file dengan nama yang diberikan dalam info build ini. |
default
void
|
setFile(BuildInfoKey.BuildInfoFileKey key, File file, String version)
Menyimpan file yang diberi |
abstract
void
|
setProperties(BuildInfoProperties... properties)
Tetapkan |
abstract
void
|
setTestTag(String testTag)
Menetapkan nama unik untuk pengujian yang sedang dijalankan. |
default
File
|
stageRemoteFile(String fileName, File workingDir)
Menyiapkan file yang merupakan bagian dari file jarak jauh di direktori root info build. |
default
BuildInformation.BuildInfo
|
toProto()
Lakukan serialisasi instance BuildInfo menjadi protobuf. |
Konstanta
REMOTE_FILE_PREFIX
public static final String REMOTE_FILE_PREFIX
Awalan yang digunakan dalam nama untuk menunjukkan bahwa file disetel untuk ditunda download-nya.
Nilai Konstanta: "remote_file:"
REMOTE_FILE_VERSION
public static final String REMOTE_FILE_VERSION
File jarak jauh tidak memiliki versi.
Nilai Konstanta: ""
UNKNOWN_BUILD_ID
public static final String UNKNOWN_BUILD_ID
Nilai default saat ID build tidak diketahui.
Nilai Konstanta: "-1"
Metode publik
addAppPackageFile
public void addAppPackageFile (File appPackageFile, String version)
Menambahkan file apk lokal dan versi terkaitnya. Perhatikan bahwa apk akan ditampilkan dari
getAppPackageFiles()
sesuai urutan penambahannya oleh metode ini.
Parameter | |
---|---|
appPackageFile |
File |
version |
String |
addBuildAttribute
public abstract void addBuildAttribute (String attributeName, String attributeValue)
Tambahkan atribut build. Tindakan ini tidak mengizinkan penggantian attributeName yang ada.
Parameter | |
---|---|
attributeName |
String : nama atribut unik |
attributeValue |
String : nilai atribut |
addBuildAttributes
public void addBuildAttributes (buildAttributes)
Menambahkan atribut build
Parameter | |
---|---|
buildAttributes |
: Peta atribut yang akan ditambahkan |
allowStagingRemoteFile
public void allowStagingRemoteFile (boolean stageRemoteFile)
Menetapkan izin untuk mengizinkan staging file jarak jauh.
Parameter | |
---|---|
stageRemoteFile |
boolean |
cleanUp
public abstract void cleanUp ()
Membersihkan file build sementara
cleanUp
public abstract void cleanUp (doNotDelete)
Versi cleanUp()
yang beberapa file-nya tidak dihapus.
Parameter | |
---|---|
doNotDelete |
|
getAppPackageFiles
publicgetAppPackageFiles ()
Mendapatkan salinan kumpulan file apk aplikasi lokal dan versinya. Urutan yang ditampilkan
cocok dengan urutan penambahan apk ke IAppBuildInfo
.
Hasil | |
---|---|
|
getBuildAttributes
public abstractgetBuildAttributes ()
Mendapatkan kumpulan pasangan nama-nilai atribut tambahan yang mendeskripsikan build.
Hasil | |
---|---|
|
ERROR(/Map) atribut build. Tidak akan menjadi null , tetapi mungkin kosong. |
getBuildBranch
public abstract String getBuildBranch ()
Metode opsional untuk menampilkan cabang kontrol sumber tempat build yang sedang diuji dihasilkan.
Hasil | |
---|---|
String |
cabang build atau null jika tidak ditetapkan/tidak berlaku |
getBuildFlavor
public abstract String getBuildFlavor ()
Metode opsional untuk menampilkan jenis build yang sedang diuji.
Implementasi umum untuk build platform Android adalah menampilkan (build product)-(build os)-(build variant). ie generic-linux-userdebug
Hasil | |
---|---|
String |
ragam build atau null jika tidak ditetapkan/tidak berlaku |
getBuildId
public abstract String getBuildId ()
Menampilkan ID unik build yang sedang diuji. Tidak boleh null. Default-nya adalah UNKNOWN_BUILD_ID
.
Hasil | |
---|---|
String |
getBuildTargetName
public abstract String getBuildTargetName ()
Menampilkan nama lengkap untuk build yang sedang diuji.
Implementasi umum adalah membuat nama target build dari kombinasi ragam build dan nama cabang. [yaitu (nama cabang)-(rasa build)]
Hasil | |
---|---|
String |
getDeviceSerial
public abstract String getDeviceSerial ()
Hasil | |
---|---|
String |
serial ITestDevice tempat build ini dijalankan. Menampilkan null
jika tidak ada perangkat yang terkait dengan build ini. |
getFile
public abstract File getFile (String name)
Metode helper untuk mengambil file dengan nama yang diberikan.
Hasil | |
---|---|
File |
file gambar atau null jika tidak ditemukan |
getFile
public File getFile (BuildInfoKey.BuildInfoFileKey key)
Metode helper untuk mengambil file dengan BuildInfoFileKey
yang diberikan.
Parameter | |
---|---|
key |
BuildInfoKey.BuildInfoFileKey : BuildInfoFileKey yang diminta. |
Hasil | |
---|---|
File |
file gambar atau null jika tidak ditemukan |
getFiles
public abstractgetFiles ()
Menampilkan semua VersionedFile
yang disimpan di BuildInfo
ini.
Hasil | |
---|---|
|
getProperties
public abstractgetProperties ()
Menampilkan salinan properti yang saat ini ditetapkan di IBuildInfo
.
Hasil | |
---|---|
|
getRemoteFiles
publicgetRemoteFiles ()
Mendapatkan jalur untuk artefak build yang ditunda download-nya.
Hasil | |
---|---|
|
getTestTag
public abstract String getTestTag ()
Menampilkan nama unik untuk pengujian yang sedang dijalankan.
Hasil | |
---|---|
String |
getVersion
public String getVersion (BuildInfoKey.BuildInfoFileKey key)
Metode helper untuk mengambil versi file dengan BuildInfoFileKey
yang diberikan.
Parameter | |
---|---|
key |
BuildInfoKey.BuildInfoFileKey : BuildInfoFileKey yang diminta. |
Hasil | |
---|---|
String |
versi image atau null jika tidak ditemukan |
getVersion
public abstract String getVersion (String name)
Metode helper untuk mengambil versi file dengan nama yang diberikan.
Hasil | |
---|---|
String |
versi image atau null jika tidak ditemukan |
getVersionedFile
public VersionedFile getVersionedFile (BuildInfoKey.BuildInfoFileKey key)
Metode helper untuk mengambil VersionedFile
dengan BuildInfoFileKey
tertentu.
Parameter | |
---|---|
key |
BuildInfoKey.BuildInfoFileKey : BuildInfoFileKey yang diminta. |
Hasil | |
---|---|
VersionedFile |
File yang memiliki versi atau null jika tidak ditemukan |
getVersionedFile
public VersionedFile getVersionedFile (String name)
Metode bantuan untuk mengambil VersionedFile
dengan nama tertentu.
Hasil | |
---|---|
VersionedFile |
File yang memiliki versi atau null jika tidak ditemukan |
getVersionedFileKeys
publicgetVersionedFileKeys ()
Menampilkan kumpulan kunci yang tersedia untuk membuat kueri VersionedFile
melalui getFile(BuildInfoFileKey)
.
Hasil | |
---|---|
|
getVersionedFiles
publicgetVersionedFiles (BuildInfoKey.BuildInfoFileKey key)
Metode helper untuk mengambil daftar VersionedFile
yang terkait dengan BuildInfoFileKey
tertentu. Jika kunci memungkinkan penyimpanan daftar.
Parameter | |
---|---|
key |
BuildInfoKey.BuildInfoFileKey : BuildInfoFileKey yang diminta. |
Hasil | |
---|---|
|
File yang memiliki versi atau null jika tidak ditemukan |
removeBuildAttribute
public void removeBuildAttribute (String attributeName)
Menghapus attributeName tertentu dari pelacakan.
Parameter | |
---|---|
attributeName |
String : atribut yang akan dihentikan pelacakannya |
setBuildBranch
public abstract void setBuildBranch (String branch)
Menetapkan cabang build
Parameter | |
---|---|
branch |
String : nama cabang |
setBuildFlavor
public abstract void setBuildFlavor (String buildFlavor)
Tetapkan ragam build.
setBuildId
public abstract void setBuildId (String buildId)
Menetapkan ID unik build yang sedang diuji. Tidak boleh null.
Parameter | |
---|---|
buildId |
String |
setDeviceSerial
public abstract void setDeviceSerial (String serial)
Tetapkan serial ITestDevice
yang terkait dengan build ini.
Parameter | |
---|---|
serial |
String : nomor seri ITestDevice yang digunakan untuk menjalankan build ini. |
setFile
public abstract void setFile (String name, File file, String version)
Menyimpan file dengan nama yang diberikan dalam info build ini.
Parameter | |
---|---|
name |
String : nama unik file |
file |
File : ERROR(/File) lokal |
version |
String : versi file |
setFile
public void setFile (BuildInfoKey.BuildInfoFileKey key, File file, String version)
Menyimpan file yang diberi BuildInfoFileKey
dalam info build ini.
Parameter | |
---|---|
key |
BuildInfoKey.BuildInfoFileKey : nama unik file berdasarkan BuildInfoFileKey . |
file |
File : ERROR(/File) lokal |
version |
String : versi file |
setProperties
public abstract void setProperties (BuildInfoProperties... properties)
Tetapkan BuildInfoProperties
untuk instance IBuildInfo
. Ganti properti yang ada yang ditetapkan sebelumnya.
Parameter | |
---|---|
properties |
BuildInfoProperties : Daftar properti yang akan ditambahkan. |
setTestTag
public abstract void setTestTag (String testTag)
Menetapkan nama unik untuk pengujian yang sedang dijalankan.
Parameter | |
---|---|
testTag |
String |
stageRemoteFile
public File stageRemoteFile (String fileName, File workingDir)
Menyiapkan file yang merupakan bagian dari file jarak jauh di direktori root info build.
TODO(b/138416078): Hapus antarmuka ini dan pemanggilnya saat modul yang diperlukan oleh pengujian dapat di-build dengan benar ke direktori modul pengujian itu sendiri.
Parameter | |
---|---|
fileName |
String : Nama file yang akan ditempatkan di file jarak jauh. |
workingDir |
File : objek ERROR(/File) dari direktori untuk melakukan staging file. |
Hasil | |
---|---|
File |
objek ERROR(/File) file yang di-stage di workingDir lokal. |
toProto
public BuildInformation.BuildInfo toProto ()
Lakukan serialisasi instance BuildInfo menjadi protobuf.
Hasil | |
---|---|
BuildInformation.BuildInfo |