IBuildInfo

public interface IBuildInfo
implements Serializable

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 download tertunda.

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(Map<String, String> buildAttributes)

Menambahkan atribut build

default void allowStagingRemoteFile(boolean stageRemoteFile)

Menetapkan izin untuk mengizinkan penyiapan file jarak jauh.

abstract void cleanUp()

Hapus semua file build sementara

abstract void cleanUp(List<File> doNotDelete)

Versi cleanUp() yang beberapa filenya tidak dihapus.

abstract IBuildInfo clone()

Meng-clone objek IBuildInfo.

default List<VersionedFile> getAppPackageFiles()

Mendapatkan salinan set file APK aplikasi lokal dan versinya.

abstract Map<String, String> getBuildAttributes()

Mendapatkan serangkaian pasangan nama-nilai dari atribut tambahan yang mendeskripsikan build.

abstract String getBuildBranch()

Metode opsional untuk menampilkan cabang kontrol sumber yang digunakan untuk membuat build yang sedang diuji.

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 tertentu.

default File getFile(BuildInfoKey.BuildInfoFileKey key)

Metode helper untuk mengambil file dengan BuildInfoFileKey tertentu.

abstract Collection<VersionedFile> getFiles()

Menampilkan semua VersionedFile yang disimpan dalam BuildInfo ini.

abstract Set<IBuildInfo.BuildInfoProperties> getProperties()

Menampilkan salinan properti yang saat ini ditetapkan di IBuildInfo.

default Set<File> 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 BuildInfoFileKey tertentu.

abstract String getVersion(String name)

Metode helper untuk mengambil versi file dengan nama tertentu.

default VersionedFile getVersionedFile(BuildInfoKey.BuildInfoFileKey key)

Metode helper untuk mengambil VersionedFile dengan BuildInfoFileKey tertentu.

default VersionedFile getVersionedFile(String name)

Metode helper untuk mengambil VersionedFile dengan nama tertentu.

default Set<String> getVersionedFileKeys()

Menampilkan kumpulan kunci yang tersedia untuk mengkueri VersionedFile melalui getFile(BuildInfoFileKey).

default List<VersionedFile> getVersionedFiles(BuildInfoKey.BuildInfoFileKey key)

Metode helper untuk mengambil daftar VersionedFile yang terkait dengan BuildInfoFileKey tertentu.

default void removeBuildAttribute(String attributeName)

Menghapus attributeName tertentu dari pelacakan.

abstract void setBuildBranch(String branch)

Menetapkan cabang build

abstract void setBuildFlavor(String buildFlavor)

Tetapkan varian build.

abstract void setBuildId(String buildId)

Menetapkan ID unik build yang sedang diuji.

abstract void setDeviceSerial(String serial)

Menetapkan ITestDeviceserial yang terkait dengan build ini.

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

Menyimpan file yang diberi BuildInfoFileKey dalam info build ini.

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

Menyimpan file dengan nama tertentu dalam info build ini.

abstract void setProperties(BuildInfoProperties... properties)

Tetapkan BuildInfoProperties untuk instance IBuildInfo.

abstract void setTestTag(String testTag)

Menetapkan nama unik untuk pengujian yang sedang dijalankan.

default File stageRemoteFile(String fileName, File workingDir)

Siapkan file yang merupakan bagian dari file jarak jauh di direktori root info build.

default BuildInformation.BuildInfo toProto()

Lakukan serialisasi 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 untuk download tertunda.

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() dalam urutan penambahannya oleh metode ini.

Parameter
appPackageFile File

version String

addBuildAttribute

public abstract void addBuildAttribute (String attributeName, 
                String attributeValue)

Tambahkan atribut build. Hal ini tidak memungkinkan penggantian attributeName yang ada.

Parameter
attributeName String: nama atribut unik
attributeValue String: nilai atribut

addBuildAttributes

public void addBuildAttributes (Map<String, String> buildAttributes)

Menambahkan atribut build

Parameter
buildAttributes Map: Peta atribut yang akan ditambahkan

allowStagingRemoteFile

public void allowStagingRemoteFile (boolean stageRemoteFile)

Menetapkan izin untuk mengizinkan penyiapan file jarak jauh.

Parameter
stageRemoteFile boolean

cleanUp

public abstract void cleanUp ()

Hapus semua file build sementara

cleanUp

public abstract void cleanUp (List<File> doNotDelete)

Versi cleanUp() yang beberapa filenya tidak dihapus.

Parameter
doNotDelete List

clone

public abstract IBuildInfo clone ()

Meng-clone objek IBuildInfo.

Hasil
IBuildInfo

getAppPackageFiles

public List<VersionedFile> getAppPackageFiles ()

Mendapatkan salinan set file APK aplikasi lokal dan versinya. Urutan yang ditampilkan cocok dengan urutan penambahan APK ke IAppBuildInfo.

Hasil
List<VersionedFile>

getBuildAttributes

public abstract Map<String, String> getBuildAttributes ()

Mendapatkan serangkaian pasangan nama-nilai dari atribut tambahan yang mendeskripsikan build.

Hasil
Map<String, String> Map atribut build. Tidak akan menjadi null, tetapi mungkin kosong.

getBuildBranch

public abstract String getBuildBranch ()

Metode opsional untuk menampilkan cabang kontrol sumber yang digunakan untuk membuat build yang sedang diuji.

Hasil
String cabang build atau null jika tidak disetel/tidak berlaku

getBuildFlavor

public abstract String getBuildFlavor ()

Metode opsional untuk menampilkan jenis build yang sedang diuji.

Implementasi umum untuk build platform Android adalah menampilkan (produk build)-(OS build)-(varian build). ie generic-linux-userdebug

Hasil
String varian build atau null jika tidak disetel/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. [ie (nama cabang)-(varian build)]

Hasil
String

getDeviceSerial

public abstract String getDeviceSerial ()

Hasil
String serial ITestDevice tempat build ini dijalankan. Menampilkan null jika tidak ada perangkat yang dikaitkan dengan build ini.

getFile

public abstract File getFile (String name)

Metode helper untuk mengambil file dengan nama tertentu.

Hasil
File file gambar atau null jika tidak ditemukan

getFile

public File getFile (BuildInfoKey.BuildInfoFileKey key)

Metode helper untuk mengambil file dengan BuildInfoFileKey tertentu.

Parameter
key BuildInfoKey.BuildInfoFileKey: BuildInfoFileKey yang diminta.
Hasil
File file gambar atau null jika tidak ditemukan

getFiles

public abstract Collection<VersionedFile> getFiles ()

Menampilkan semua VersionedFile yang disimpan dalam BuildInfo ini.

Hasil
Collection<VersionedFile>

getProperties

public abstract Set<IBuildInfo.BuildInfoProperties> getProperties ()

Menampilkan salinan properti yang saat ini ditetapkan di IBuildInfo.

Hasil
Set<IBuildInfo.BuildInfoProperties>

getRemoteFiles

public Set<File> getRemoteFiles ()

Mendapatkan jalur untuk artefak build yang ditunda download-nya.

Hasil
Set<File>

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 tertentu.

Parameter
key BuildInfoKey.BuildInfoFileKey: BuildInfoFileKey yang diminta.
Hasil
String versi gambar atau null jika tidak ditemukan

getVersion

public abstract String getVersion (String name)

Metode helper untuk mengambil versi file dengan nama tertentu.

Hasil
String versi gambar 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 berversi atau null jika tidak ditemukan

getVersionedFile

public VersionedFile getVersionedFile (String name)

Metode helper untuk mengambil VersionedFile dengan nama tertentu.

Hasil
VersionedFile File berversi atau null jika tidak ditemukan

getVersionedFileKeys

public Set<String> getVersionedFileKeys ()

Menampilkan kumpulan kunci yang tersedia untuk mengkueri VersionedFile melalui getFile(BuildInfoFileKey).

Hasil
Set<String>

getVersionedFiles

public List<VersionedFile> getVersionedFiles (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
List<VersionedFile> File berversi atau null jika tidak ditemukan

removeBuildAttribute

public void removeBuildAttribute (String attributeName)

Menghapus attributeName tertentu dari pelacakan.

Parameter
attributeName String: atribut yang akan berhenti dilacak

setBuildBranch

public abstract void setBuildBranch (String branch)

Menetapkan cabang build

Parameter
branch String: nama cabang

setBuildFlavor

public abstract void setBuildFlavor (String buildFlavor)

Tetapkan varian 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)

Menetapkan ITestDeviceserial yang terkait dengan build ini.

Parameter
serial String: nomor seri ITestDevice yang digunakan untuk menjalankan build ini.

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: File lokal
version String: versi file

setFile

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

Menyimpan file dengan nama tertentu dalam info build ini.

Parameter
name String: nama unik file
file File: 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)

Siapkan 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 dan menghasilkan output ke direktori modul pengujian itu sendiri.

Parameter
fileName String: Nama file yang akan ditemukan di file jarak jauh.
workingDir File: objek File dari direktori untuk mengatur file.
Hasil
File objek File dari file yang di-stage di workingDir lokal.

toProto

public BuildInformation.BuildInfo toProto ()

Lakukan serialisasi instance BuildInfo ke dalam protobuf.

Hasil
BuildInformation.BuildInfo