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

abstract void cleanUp ()

Nettoyer tous les fichiers de build temporaires

abstract void cleanUp ( doNotDelete) cleanUp ( doNotDelete)

Version de cleanUp() où certains fichiers ne sont pas supprimés.

abstract IBuildInfo clone ()

Clone l'objet IBuildInfo .

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 BuildInfoFileKey donné.

abstract getFiles ()

Renvoie tous VersionedFile stockés dans ce BuildInfo .

abstract getProperties ()

Renvoie une copie des propriétés actuellement définies sur IBuildInfo .

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 BuildInfoFileKey donné.

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 VersionedFile avec un BuildInfoFileKey donné.

default VersionedFile getVersionedFile (String name)

Méthode d'assistance pour récupérer un VersionedFile avec un nom donné.

default getVersionedFileKeys ()

Renvoie l'ensemble de clés disponibles pour interroger VersionedFile via getFile(BuildInfoFileKey) .

default getVersionedFiles ( BuildInfoKey.BuildInfoFileKey key)

Méthode d'assistance pour récupérer une liste de VersionedFile associés à un BuildInfoFileKey donné.

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 ITestDevice associé à cette version.

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 BuildInfoFileKey dans ces informations de build.

abstract void setProperties ( BuildInfoProperties... properties)

Définissez les BuildInfoProperties pour l'instance IBuildInfo .

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 : Carte des attributs à ajouter

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

cloner

public abstract IBuildInfo clone ()

Clone l'objet IBuildInfo .

Retour
IBuildInfo

getAppPackageFiles

public  getAppPackageFiles ()

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

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

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

Renvoie tous VersionedFile stockés dans ce BuildInfo .

Retour

obtenirPropriétés

public abstract  getProperties ()

Renvoie une copie des propriétés actuellement définies sur IBuildInfo .

Retour

getRemoteFiles

public  getRemoteFiles ()

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

public  getVersionedFileKeys ()

Renvoie l'ensemble de clés disponibles pour interroger VersionedFile via getFile(BuildInfoFileKey) .

Retour

getVersionedFiles

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