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 ke unduhan tertunda. |
String | REMOTE_FILE_VERSION File jarak jauh tidak berversi. |
String | UNKNOWN_BUILD_ID Nilai default saat build ID 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 ( buildAttributes) addBuildAttributes ( buildAttributes) Tambahkan atribut bangunan |
abstract void | cleanUp () Bersihkan semua file build sementara |
abstract void | cleanUp ( doNotDelete) cleanUp ( doNotDelete) Versi |
abstract IBuildInfo | clone () Menggandakan objek |
default | getAppPackageFiles () Mendapatkan salinan kumpulan file apk aplikasi lokal dan versinya. |
abstract | getBuildAttributes () Dapatkan satu set pasangan nama-nilai dari atribut tambahan yang menjelaskan build. |
abstract String | getBuildBranch () Metode opsional untuk mengembalikan cabang kontrol sumber tempat build yang sedang diuji dibuat. |
abstract String | getBuildFlavor () Metode opsional untuk menampilkan tipe build yang sedang diuji. |
abstract String | getBuildId () Mengembalikan pengidentifikasi unik build yang sedang diuji. |
abstract String | getBuildTargetName () Kembalikan nama lengkap untuk build yang sedang diuji. |
abstract String | getDeviceSerial () |
abstract File | getFile (String name) Metode pembantu untuk mengambil file dengan nama yang diberikan. |
default File | getFile ( BuildInfoKey.BuildInfoFileKey key) Metode pembantu untuk mengambil file dengan diberi |
abstract | getFiles () Mengembalikan semua |
abstract | getProperties () Mengembalikan salinan properti yang saat ini disetel di |
default | getRemoteFiles () Dapatkan jalur untuk artefak build yang unduhannya tertunda. |
abstract String | getTestTag () Kembalikan nama unik untuk pengujian yang dijalankan. |
default String | getVersion ( BuildInfoKey.BuildInfoFileKey key) Metode pembantu untuk mengambil versi file dengan memberikan |
abstract String | getVersion (String name) Metode pembantu untuk mengambil versi file dengan nama yang diberikan. |
default VersionedFile | getVersionedFile ( BuildInfoKey.BuildInfoFileKey key) Metode pembantu untuk mengambil |
default VersionedFile | getVersionedFile (String name) Metode pembantu untuk mengambil |
default | getVersionedFileKeys () Mengembalikan kumpulan kunci yang tersedia untuk kueri |
default | getVersionedFiles ( BuildInfoKey.BuildInfoFileKey key) Metode helper untuk mengambil daftar |
default void | removeBuildAttribute (String attributeName) Hapus atributName tertentu dari pelacakan. |
abstract void | setBuildBranch (String branch) Atur cabang build |
abstract void | setBuildFlavor (String buildFlavor) Tetapkan rasa build. |
abstract void | setBuildId (String buildId) Menyetel pengidentifikasi 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 di 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 dijalankan. |
default File | stageRemoteFile (String fileName, File workingDir) Panggung file yang merupakan bagian dari file jarak jauh di direktori root info build. |
default BuildInformation.BuildInfo | toProto () Serialkan instance BuildInfo ke dalam protobuf. |
Konstanta
REMOTE_FILE_PREFIX
public static final String REMOTE_FILE_PREFIX
Awalan yang digunakan dalam nama untuk menunjukkan bahwa file disetel ke unduhan tertunda.
Nilai Konstan: "remote_file:"
REMOTE_FILE_VERSION
public static final String REMOTE_FILE_VERSION
File jarak jauh tidak berversi.
Nilai konstan: ""
UNKNOWN_BUILD_ID
public static final String UNKNOWN_BUILD_ID
Nilai default saat build ID tidak diketahui.
Nilai Konstan: "-1"
Metode publik
tambahkanAppPackageFile
public void addAppPackageFile (File appPackageFile, String version)
Menambahkan file apk lokal dan versi terkaitnya. Perhatikan bahwa apk akan dikembalikan dari getAppPackageFiles()
sesuai urutan penambahannya dengan metode ini.
Parameter | |
---|---|
appPackageFile | File |
version | String |
addBuildAttribute
public abstract void addBuildAttribute (String attributeName, String attributeValue)
Tambahkan atribut build. Ini tidak memungkinkan penggantian atributName yang ada.
Parameter | |
---|---|
attributeName | String : nama atribut unik |
attributeValue | String : nilai atribut |
addBuildAttributes
public void addBuildAttributes (buildAttributes)
Tambahkan atribut bangunan
Parameter | |
---|---|
buildAttributes |
membersihkan
public abstract void cleanUp ()
Bersihkan semua file build sementara
membersihkan
public abstract void cleanUp (doNotDelete)
Versi cleanUp()
di mana beberapa file tidak dihapus.
Parameter | |
---|---|
doNotDelete |
getAppPackageFiles
publicgetAppPackageFiles ()
Mendapatkan salinan kumpulan file apk aplikasi lokal dan versinya. Urutan yang dikembalikan cocok dengan urutan penambahan apks ke IAppBuildInfo
.
Pengembalian | |
---|---|
getBuildAttributes
public abstractgetBuildAttributes ()
Dapatkan satu set pasangan nama-nilai dari atribut tambahan yang menjelaskan build.
Pengembalian | |
---|---|
sebuah ERROR(/Map) dari atribut build. Tidak akan null , tapi mungkin kosong. |
getBuildBranch
public abstract String getBuildBranch ()
Metode opsional untuk mengembalikan cabang kontrol sumber tempat build yang sedang diuji dibuat.
Pengembalian | |
---|---|
String | cabang build atau null jika tidak disetel/tidak berlaku |
getBuildFlavour
public abstract String getBuildFlavor ()
Metode opsional untuk menampilkan tipe build yang sedang diuji.
Implementasi umum untuk build platform Android adalah mengembalikan (build product)-(build os)-(build varian). yaitu generik-linux-userdebugPengembalian | |
---|---|
String | rasa build atau null jika tidak disetel/tidak berlaku |
getBuildId
public abstract String getBuildId ()
Mengembalikan pengidentifikasi unik build yang sedang diuji. Seharusnya tidak pernah nol. Bawaan ke UNKNOWN_BUILD_ID
.
Pengembalian | |
---|---|
String |
getBuildTargetName
public abstract String getBuildTargetName ()
Kembalikan nama lengkap untuk build yang sedang diuji.
Implementasi yang umum adalah membuat nama target build dari kombinasi ragam build dan nama cabang. [yaitu (nama cabang)-(membangun rasa)]Pengembalian | |
---|---|
String |
getDeviceSerial
public abstract String getDeviceSerial ()
Pengembalian | |
---|---|
String | serial ITestDevice tempat pembangunan ini dijalankan. Mengembalikan null jika tidak ada perangkat yang dikaitkan dengan build ini. |
getFile
public abstract File getFile (String name)
Metode pembantu untuk mengambil file dengan nama yang diberikan.
Pengembalian | |
---|---|
File | file gambar atau null jika tidak ditemukan |
getFile
public File getFile (BuildInfoKey.BuildInfoFileKey key)
Metode pembantu untuk mengambil file dengan diberi BuildInfoFileKey
.
Parameter | |
---|---|
key | BuildInfoKey.BuildInfoFileKey : BuildInfoFileKey yang diminta. |
Pengembalian | |
---|---|
File | file gambar atau null jika tidak ditemukan |
getFiles
public abstractgetFiles ()
Mengembalikan semua VersionedFile
yang disimpan di BuildInfo
ini.
Pengembalian | |
---|---|
getProperties
public abstractgetProperties ()
Mengembalikan salinan properti yang saat ini disetel di IBuildInfo
.
Pengembalian | |
---|---|
getRemoteFiles
publicgetRemoteFiles ()
Dapatkan jalur untuk artefak build yang unduhannya tertunda.
Pengembalian | |
---|---|
getTestTag
public abstract String getTestTag ()
Kembalikan nama unik untuk pengujian yang dijalankan.
Pengembalian | |
---|---|
String |
getVersion
public String getVersion (BuildInfoKey.BuildInfoFileKey key)
Metode pembantu untuk mengambil versi file dengan memberikan BuildInfoFileKey
.
Parameter | |
---|---|
key | BuildInfoKey.BuildInfoFileKey : BuildInfoFileKey diminta. |
Pengembalian | |
---|---|
String | versi gambar atau null jika tidak ditemukan |
getVersion
public abstract String getVersion (String name)
Metode pembantu untuk mengambil versi file dengan nama yang diberikan.
Pengembalian | |
---|---|
String | versi gambar atau null jika tidak ditemukan |
getVersionedFile
public VersionedFile getVersionedFile (BuildInfoKey.BuildInfoFileKey key)
Metode pembantu untuk mengambil VersionedFile
dengan BuildInfoFileKey
tertentu.
Parameter | |
---|---|
key | BuildInfoKey.BuildInfoFileKey : BuildInfoFileKey diminta. |
Pengembalian | |
---|---|
VersionedFile | File berversi atau null jika tidak ditemukan |
getVersionedFile
public VersionedFile getVersionedFile (String name)
Metode pembantu untuk mengambil VersionedFile
dengan nama yang diberikan.
Pengembalian | |
---|---|
VersionedFile | File berversi atau null jika tidak ditemukan |
getVersionedFileKeys
publicgetVersionedFileKeys ()
Mengembalikan kumpulan kunci yang tersedia untuk kueri VersionedFile
melalui getFile(BuildInfoFileKey)
.
Pengembalian | |
---|---|
getVersionedFiles
publicgetVersionedFiles (BuildInfoKey.BuildInfoFileKey key)
Metode helper untuk mengambil daftar VersionedFile
s yang terkait dengan BuildInfoFileKey
tertentu. Jika kunci memungkinkan untuk menyimpan daftar.
Parameter | |
---|---|
key | BuildInfoKey.BuildInfoFileKey : BuildInfoFileKey diminta. |
Pengembalian | |
---|---|
File berversi atau null jika tidak ditemukan |
hapusBuildAttribute
public void removeBuildAttribute (String attributeName)
Hapus atributName tertentu dari pelacakan.
Parameter | |
---|---|
attributeName | String : atribut untuk menghentikan pelacakan |
setBuildBranch
public abstract void setBuildBranch (String branch)
Atur cabang build
Parameter | |
---|---|
branch | String : nama cabang |
setBuildFlavour
public abstract void setBuildFlavor (String buildFlavor)
Tetapkan rasa build.
setBuildId
public abstract void setBuildId (String buildId)
Menyetel pengidentifikasi unik build yang sedang diuji. Seharusnya tidak pernah nol.
Parameter | |
---|---|
buildId | String |
setDeviceSerial
public abstract void setDeviceSerial (String serial)
Tetapkan serial ITestDevice
yang terkait dengan build ini.
Parameter | |
---|---|
serial | String : nomor seri ITestDevice tempat build ini dijalankan. |
setFile
public abstract void setFile (String name, File file, String version)
Menyimpan file dengan nama yang diberikan di 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
di 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 semua properti yang sudah ada yang disetel sebelumnya.
Parameter | |
---|---|
properties | BuildInfoProperties : Daftar properti yang akan ditambahkan. |
setTestTag
public abstract void setTestTag (String testTag)
Menetapkan nama unik untuk pengujian yang dijalankan.
Parameter | |
---|---|
testTag | String |
stageRemoteFile
public File stageRemoteFile (String fileName, File workingDir)
Panggung 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 dibangun 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 menampilkan file. |
Pengembalian | |
---|---|
File | objek ERROR(/File) dari file yang dipentaskan di workingDir lokal. |
toProto
public BuildInformation.BuildInfo toProto ()
Serialkan instance BuildInfo ke dalam protobuf.
Pengembalian | |
---|---|
BuildInformation.BuildInfo |