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( buildAttributes)

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( doNotDelete)

Versi cleanUp() yang beberapa file-nya tidak dihapus.

abstract IBuildInfo clone()

Meng-clone objek IBuildInfo.

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 BuildInfoFileKey yang diberikan.

abstract getFiles()

Menampilkan semua VersionedFile yang disimpan di BuildInfo ini.

abstract getProperties()

Menampilkan salinan properti yang saat ini ditetapkan di IBuildInfo.

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 BuildInfoFileKey yang diberikan.

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 VersionedFile dengan BuildInfoFileKey tertentu.

default VersionedFile getVersionedFile(String name)

Metode bantuan untuk mengambil VersionedFile dengan nama tertentu.

default getVersionedFileKeys()

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

default 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 ragam build.

abstract void setBuildId(String buildId)

Menetapkan ID unik build yang sedang diuji.

abstract void setDeviceSerial(String serial)

Tetapkan serial ITestDevice yang terkait dengan build ini.

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 BuildInfoFileKey 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)

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

clone

public abstract IBuildInfo clone ()

Meng-clone objek IBuildInfo.

Hasil
IBuildInfo

getAppPackageFiles

public  getAppPackageFiles ()

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

Hasil

getBuildAttributes

public abstract  getBuildAttributes ()

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 abstract  getFiles ()

Menampilkan semua VersionedFile yang disimpan di BuildInfo ini.

Hasil

getProperties

public abstract  getProperties ()

Menampilkan salinan properti yang saat ini ditetapkan di IBuildInfo.

Hasil

getRemoteFiles

public  getRemoteFiles ()

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

public  getVersionedFileKeys ()

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

Hasil

getVersionedFiles

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