IBuildInfo
public interface IBuildInfo
com.android.tradefed.build.IBuildInfo |
Contient des informations sur la version testée.
Résumé
Constantes | |
---|---|
String | REMOTE_FILE_PREFIX Préfixe utilisé dans le nom pour indiquer que le fichier est configuré pour un téléchargement différé. |
String | REMOTE_FILE_VERSION Le fichier distant n’est pas versionné. |
String | UNKNOWN_BUILD_ID Valeur par défaut lorsque l'ID de build est inconnu. |
Méthodes publiques | |
---|---|
default void | addAppPackageFile (File appPackageFile, String version) Ajoute le fichier apk local et sa version associée. |
abstract void | addBuildAttribute (String attributeName, String attributeValue) Ajoutez un attribut de build. |
default void | addBuildAttributes ( buildAttributes) addBuildAttributes ( buildAttributes) Ajouter des attributs de build |
default void | allowStagingRemoteFile (boolean stageRemoteFile) Définit l’autorisation pour autoriser la préparation de fichiers distants. |
abstract void | cleanUp () Nettoyer tous les fichiers de build temporaires |
abstract void | cleanUp ( doNotDelete) cleanUp ( doNotDelete) Version de |
abstract IBuildInfo | clone () Clone l'objet |
default | getAppPackageFiles () Obtient une copie de l’ensemble des fichiers apk de l’application locale et de leurs versions. |
abstract | getBuildAttributes () Obtenez un ensemble de paires nom-valeur d'attributs supplémentaires décrivant la build. |
abstract String | getBuildBranch () Méthode facultative pour renvoyer la branche de contrôle de code source à partir de laquelle la build en cours de test a été produite. |
abstract String | getBuildFlavor () Méthode facultative pour renvoyer le type de build testé. |
abstract String | getBuildId () Renvoie l'identifiant unique de la build en cours de test. |
abstract String | getBuildTargetName () Renvoie le nom complet de la build en cours de test. |
abstract String | getDeviceSerial () |
abstract File | getFile (String name) Méthode d'assistance pour récupérer un fichier portant un nom donné. |
default File | getFile ( BuildInfoKey.BuildInfoFileKey key) Méthode d'assistance pour récupérer un fichier avec un |
abstract | getFiles () Renvoie tous |
abstract | getProperties () Renvoie une copie des propriétés actuellement définies sur |
default | getRemoteFiles () Obtenez les chemins d’accès aux artefacts de build dont le téléchargement est retardé. |
abstract String | getTestTag () Renvoie un nom unique pour les tests en cours d'exécution. |
default String | getVersion ( BuildInfoKey.BuildInfoFileKey key) Méthode d'assistance pour récupérer une version de fichier avec un |
abstract String | getVersion (String name) Méthode d'assistance pour récupérer une version de fichier avec un nom donné. |
default VersionedFile | getVersionedFile ( BuildInfoKey.BuildInfoFileKey key) Méthode d'assistance pour récupérer un |
default VersionedFile | getVersionedFile (String name) Méthode d'assistance pour récupérer un |
default | getVersionedFileKeys () Renvoie l'ensemble de clés disponibles pour interroger |
default | getVersionedFiles ( BuildInfoKey.BuildInfoFileKey key) Méthode d'assistance pour récupérer une liste de |
default void | removeBuildAttribute (String attributeName) Supprimez un nom d'attribut donné du suivi. |
abstract void | setBuildBranch (String branch) Définir la branche de construction |
abstract void | setBuildFlavor (String buildFlavor) Définissez la saveur de construction. |
abstract void | setBuildId (String buildId) Définit l'identifiant unique de la build en cours de test. |
abstract void | setDeviceSerial (String serial) Définissez le numéro de série |
abstract void | setFile (String name, File file, String version) Stocke un fichier avec un nom donné dans ces informations de build. |
default void | setFile ( BuildInfoKey.BuildInfoFileKey key, File file, String version) Stocke un fichier doté d'une |
abstract void | setProperties ( BuildInfoProperties... properties) Définissez les |
abstract void | setTestTag (String testTag) Définit le nom unique des tests en cours d'exécution. |
default File | stageRemoteFile (String fileName, File workingDir) Placez un fichier faisant partie des fichiers distants dans le répertoire racine des informations de build. |
default BuildInformation.BuildInfo | toProto () Sérialisez une instance BuildInfo dans un protobuf. |
Constantes
REMOTE_FILE_PREFIX
public static final String REMOTE_FILE_PREFIX
Préfixe utilisé dans le nom pour indiquer que le fichier est configuré pour un téléchargement différé.
Valeur constante : « fichier_distant : »
REMOTE_FILE_VERSION
public static final String REMOTE_FILE_VERSION
Le fichier distant n’est pas versionné.
Valeur constante : ""
UNKNOWN_BUILD_ID
public static final String UNKNOWN_BUILD_ID
Valeur par défaut lorsque l'ID de build est inconnu.
Valeur constante : "-1"
Méthodes publiques
addAppPackageFile
public void addAppPackageFile (File appPackageFile, String version)
Ajoute le fichier apk local et sa version associée. Notez que les apks seront renvoyés par getAppPackageFiles()
dans l'ordre dans lequel ils ont été ajoutés par cette méthode.
Paramètres | |
---|---|
appPackageFile | File |
version | String |
addBuildAttribute
public abstract void addBuildAttribute (String attributeName, String attributeValue)
Ajoutez un attribut de build. Cela ne permet pas de remplacer un nom d'attribut existant.
Paramètres | |
---|---|
attributeName | String : le nom unique de l'attribut |
attributeValue | String : la valeur de l'attribut |
addBuildAttributes
public void addBuildAttributes (buildAttributes)
Ajouter des attributs de build
Paramètres | |
---|---|
buildAttributes |
AllowStagingRemoteFile
public void allowStagingRemoteFile (boolean stageRemoteFile)
Définit l’autorisation pour autoriser la préparation de fichiers distants.
Paramètres | |
---|---|
stageRemoteFile | boolean |
nettoyer
public abstract void cleanUp ()
Nettoyer tous les fichiers de build temporaires
nettoyer
public abstract void cleanUp (doNotDelete)
Version de cleanUp()
où certains fichiers ne sont pas supprimés.
Paramètres | |
---|---|
doNotDelete |
getAppPackageFiles
publicgetAppPackageFiles ()
Obtient une copie de l’ensemble des fichiers apk de l’application locale et de leurs versions. L'ordre renvoyé correspond à l'ordre dans lequel les apks ont été ajoutés au IAppBuildInfo
.
Retour | |
---|---|
getBuildAttributes
public abstractgetBuildAttributes ()
Obtenez un ensemble de paires nom-valeur d'attributs supplémentaires décrivant la build.
Retour | |
---|---|
une ERROR(/Map) des attributs de build. Ne sera pas null , mais peut être vide. |
obtenirBuildBranch
public abstract String getBuildBranch ()
Méthode facultative pour renvoyer la branche de contrôle de code source à partir de laquelle la build en cours de test a été produite.
Retour | |
---|---|
String | la branche de construction ou null si elle n'est pas définie/non applicable |
getBuildFlavor
public abstract String getBuildFlavor ()
Méthode facultative pour renvoyer le type de build testé.
Une implémentation courante pour les versions de plate-forme Android consiste à renvoyer (build product)-(build os)-(build variant). c'est-à-dire générique-linux-userdebugRetour | |
---|---|
String | la saveur de construction ou null si non définie/non applicable |
getBuildId
public abstract String getBuildId ()
Renvoie l'identifiant unique de la build en cours de test. Ne devrait jamais être nul. La valeur par défaut est UNKNOWN_BUILD_ID
.
Retour | |
---|---|
String |
getBuildTargetName
public abstract String getBuildTargetName ()
Renvoie le nom complet de la build en cours de test.
Une implémentation courante consiste à construire le nom de la cible de build à partir d’une combinaison de la version de build et du nom de branche. [c'est-à-dire (nom de la branche) - (version de construction)]Retour | |
---|---|
String |
getDeviceSerial
public abstract String getDeviceSerial ()
Retour | |
---|---|
String | le numéro de série ITestDevice sur lequel cette build a été exécutée. Renvoie null si aucun périphérique n'est associé à cette build. |
obtenir un fichier
public abstract File getFile (String name)
Méthode d'assistance pour récupérer un fichier portant un nom donné.
Retour | |
---|---|
File | le fichier image ou null s'il n'est pas trouvé |
obtenir un fichier
public File getFile (BuildInfoKey.BuildInfoFileKey key)
Méthode d'assistance pour récupérer un fichier avec un BuildInfoFileKey
donné.
Paramètres | |
---|---|
key | BuildInfoKey.BuildInfoFileKey : la BuildInfoFileKey demandée. |
Retour | |
---|---|
File | le fichier image ou null s'il n'est pas trouvé |
obtenir des fichiers
public abstractgetFiles ()
Renvoie tous VersionedFile
stockés dans ce BuildInfo
.
Retour | |
---|---|
obtenirPropriétés
public abstractgetProperties ()
Renvoie une copie des propriétés actuellement définies sur IBuildInfo
.
Retour | |
---|---|
getRemoteFiles
publicgetRemoteFiles ()
Obtenez les chemins d’accès aux artefacts de build dont le téléchargement est retardé.
Retour | |
---|---|
obtenirTestTag
public abstract String getTestTag ()
Renvoie un nom unique pour les tests en cours d'exécution.
Retour | |
---|---|
String |
obtenir la version
public String getVersion (BuildInfoKey.BuildInfoFileKey key)
Méthode d'assistance pour récupérer une version de fichier avec un BuildInfoFileKey
donné.
Paramètres | |
---|---|
key | BuildInfoKey.BuildInfoFileKey : la BuildInfoFileKey demandée. |
Retour | |
---|---|
String | la version de l'image ou null si elle n'est pas trouvée |
obtenir la version
public abstract String getVersion (String name)
Méthode d'assistance pour récupérer une version de fichier avec un nom donné.
Retour | |
---|---|
String | la version de l'image ou null si elle n'est pas trouvée |
getVersionedFile
public VersionedFile getVersionedFile (BuildInfoKey.BuildInfoFileKey key)
Méthode d'assistance pour récupérer un VersionedFile
avec un BuildInfoFileKey
donné.
Paramètres | |
---|---|
key | BuildInfoKey.BuildInfoFileKey : la BuildInfoFileKey demandée. |
Retour | |
---|---|
VersionedFile | Le fichier versionné ou null s'il n'est pas trouvé |
getVersionedFile
public VersionedFile getVersionedFile (String name)
Méthode d'assistance pour récupérer un VersionedFile
avec un nom donné.
Retour | |
---|---|
VersionedFile | Le fichier versionné ou null s'il n'est pas trouvé |
getVersionedFileKeys
publicgetVersionedFileKeys ()
Renvoie l'ensemble de clés disponibles pour interroger VersionedFile
via getFile(BuildInfoFileKey)
.
Retour | |
---|---|
getVersionedFiles
publicgetVersionedFiles (BuildInfoKey.BuildInfoFileKey key)
Méthode d'assistance pour récupérer une liste de VersionedFile
associés à un BuildInfoFileKey
donné. Si la clé permet de stocker une liste.
Paramètres | |
---|---|
key | BuildInfoKey.BuildInfoFileKey : la BuildInfoFileKey demandée. |
Retour | |
---|---|
Le fichier versionné ou null s'il n'est pas trouvé |
supprimerBuildAttribute
public void removeBuildAttribute (String attributeName)
Supprimez un nom d'attribut donné du suivi.
Paramètres | |
---|---|
attributeName | String : l'attribut pour arrêter le suivi |
setBuildBranch
public abstract void setBuildBranch (String branch)
Définir la branche de construction
Paramètres | |
---|---|
branch | String : le nom de la branche |
setBuildFlavor
public abstract void setBuildFlavor (String buildFlavor)
Définissez la saveur de construction.
setBuildId
public abstract void setBuildId (String buildId)
Définit l'identifiant unique de la build en cours de test. Ne devrait jamais être nul.
Paramètres | |
---|---|
buildId | String |
setDeviceSerial
public abstract void setDeviceSerial (String serial)
Définissez le numéro de série ITestDevice
associé à cette version.
Paramètres | |
---|---|
serial | String : le numéro de série du ITestDevice avec lequel cette build a été exécutée. |
setFichier
public abstract void setFile (String name, File file, String version)
Stocke un fichier avec un nom donné dans ces informations de build.
Paramètres | |
---|---|
name | String : le nom unique du fichier |
file | File : l' ERROR(/File) |
version | String : la version du fichier |
setFichier
public void setFile (BuildInfoKey.BuildInfoFileKey key, File file, String version)
Stocke un fichier doté d'une BuildInfoFileKey
dans ces informations de build.
Paramètres | |
---|---|
key | BuildInfoKey.BuildInfoFileKey : le nom unique du fichier basé sur BuildInfoFileKey . |
file | File : l' ERROR(/File) |
version | String : la version du fichier |
définirPropriétés
public abstract void setProperties (BuildInfoProperties... properties)
Définissez les BuildInfoProperties
pour l'instance IBuildInfo
. Remplacez toutes les propriétés existantes définies auparavant.
Paramètres | |
---|---|
properties | BuildInfoProperties : La liste des propriétés à ajouter. |
définirTestTag
public abstract void setTestTag (String testTag)
Définit le nom unique des tests en cours d'exécution.
Paramètres | |
---|---|
testTag | String |
stageRemoteFile
public File stageRemoteFile (String fileName, File workingDir)
Placez un fichier faisant partie des fichiers distants dans le répertoire racine des informations de build.
TODO(b/138416078) : supprimez cette interface et son appelant lorsque les modules requis par un test peuvent être correctement générés dans le répertoire du module de test lui-même.
Paramètres | |
---|---|
fileName | String : Nom du fichier à localiser dans les fichiers distants. |
workingDir | File : un objet ERROR(/File) du répertoire pour stocker le fichier. |
Retour | |
---|---|
File | l'objet ERROR(/File) du fichier stocké dans le répertoire de travail local. |
versProto
public BuildInformation.BuildInfo toProto ()
Sérialisez une instance BuildInfo dans un protobuf.
Retour | |
---|---|
BuildInformation.BuildInfo |