Accueil
Référence
Consultez les informations de référence relatives au produit.
L'utilitaire de génération Ounce/Make
Ounce/Make est un outil automatisant l'importation d'informations de configuration dans AppScan® Source à partir d'environnements de génération utilisant un fichier makefile. Ounce/Make vous évite d'avoir à importer manuellement ces informations des fichiers makefiles. C'est la méthode recommandée pour configurer ces projets.
Fichier de propriétés Ounce/Make
Le fichier de propriétés Ounce/Make (ouncemake_properties.xml) est un fichier au format XML contenant des informations sur l'environnement de génération. Lors de son exécution, Ounce/Make localise ce fichier d'après le chemin de recherche ou l'option -p. Le fichier de propriétés doit indiquer le compilateur utilisé dans l'environnement de génération, l'éditeur de liens et les éléments make.
Ouncemakeéléments du fichier de propriétés
OuncemakeProperties, qui est l'élément racine du fichier de propriétés, contient les éléments répertoriés dans cette rubrique.
GlobalProjectOptions
L'élément GlobalProjectOptions spécifie les options au niveau du projet s'appliquant à tous les fichiers que contient le projet. L'élément GlobalProjectOptions et ses attributs ne sont pas obligatoires.

Référence
Consultez les informations de référence relatives au produit.
- L'utilitaire de génération Ounce/Make
  Ounce/Make est un outil automatisant l'importation d'informations de configuration dans AppScan® Source à partir d'environnements de génération utilisant un fichier makefile. Ounce/Make vous évite d'avoir à importer manuellement ces informations des fichiers makefiles. C'est la méthode recommandée pour configurer ces projets.
  - Configuration requise
    Pour créer correctement des fichiers de projet AppScan® Source, vous devez exécuter Ounce/Make dans un environnement adapté. La liste suivante répertorie les exigences pour une exécution correcte d'Ounce/Make. Si toutes ces exigences ne sont pas remplies, l'exécution Ounce/Make échouera.
  - Eléments pris en charge par Ounce/Make
    Ounce/Make prend en charge plusieurs plateformes d'ordinateur, compilateurs et versions de make.
  - Opération
    Ounce/Make fonctionne avec votre commande Make afin d'extraire de vos fichiers makefile les informations de configuration nécessaires et de créer les fichiers de projet AppScan® Source appropriés (ppf). Pour ce faire, Ounce/Make requiert que vous fournissiez certaines informations sur l'environnement de génération, comme la version de la commande make utilisée.
  - Options make et syntaxe de commande Ounce/Make
    Ounce/Make prend en charge de nombreuses options pouvant modifier son comportement lors de son exécution.
  - Fichier de propriétés Ounce/Make
    Le fichier de propriétés Ounce/Make (ouncemake_properties.xml) est un fichier au format XML contenant des informations sur l'environnement de génération. Lors de son exécution, Ounce/Make localise ce fichier d'après le chemin de recherche ou l'option -p. Le fichier de propriétés doit indiquer le compilateur utilisé dans l'environnement de génération, l'éditeur de liens et les éléments make.
    - Ouncemakeéléments du fichier de propriétés
      OuncemakeProperties, qui est l'élément racine du fichier de propriétés, contient les éléments répertoriés dans cette rubrique.
      - Compiler
        L'élément Compiler spécifie l'exécutable du compilateur utilisé dans votre environnement de génération. La valeur de cet élément doit correspondre au chemin d'accès absolu d'un exécutable. Cet élément est composé d'un attribut facultatif, macro, spécifiant le nom de la variable hébergeant l'exécutable du compilateur lors de la génération et d'une valeur spécifique au chemin d'accès de ce compilateur. Si vous ne spécifiez pas l'attribut macro, Ounce/Make le définit (macro) par défaut à CC. Le fichier de propriétés peut comporter des éléments Compiler multiples, mais au moins un de ceux-ci est requis.
      - Linker
        L'élément Linker spécifie l'exécutable de l'éditeur de liens utilisé dans l'environnement de génération. La valeur de cet élément doit correspondre au chemin d'accès absolu d'un exécutable. Le fichier de propriétés peut comporter des éléments Linker multiples, mais au moins un de ceux-ci est requis.
      - Make
        L'élément Make spécifie l'exécutable make utilisé dans votre environnement de génération. La valeur de cet élément doit correspondre au chemin d'accès absolu d'un exécutable. Le fichier de propriétés peut comporter des éléments Make multiples, mais au moins un de ceux-ci est requis.
      - MakeOptions
        L'élément MakeOptions spécifie les options à transmettre à l'exécutable make. Cet élément est facultatif et ne peut pas figurer plus d'une fois dans le fichier de propriétés.
      - Options
        L'élément Options spécifie les options à transmettre à Ounce/Make lors de son appel.
      - GlobalProjectOptions
        L'élément GlobalProjectOptions spécifie les options au niveau du projet s'appliquant à tous les fichiers que contient le projet. L'élément GlobalProjectOptions et ses attributs ne sont pas obligatoires.
      - FileOptions
        L'élément FileOptions permet d'inclure des chemins, des macros et d'autres options de compilateur pour des fichiers dotés d'extensions spécifiques. Vous pouvez spécifier FileOptions à de multiples reprises afin de spécifier des options distinctes pour des fichiers avec des extensions différentes. Par exemple, comme illustré ci-dessous, si vous disposez d'un projet comportant à la fois des fichiers C et C++, vous pouvez créer deux éléments FileOptions, à savoir un pour chaque type de fichier.
      - Executable
        L'élément Executable permet d'utiliser n'importe quel exécutable (autre que compiler, linker ou make) dans l'environnement de génération. La valeur de cet élément doit correspondre au chemin d'accès absolu d'un exécutable. L'élément Executable contient un attribut, macro, spécifiant le nom de la variable utilisée pour stocker le nom de l'exécutable lors de la génération. La valeur de l'attribut macro doit être unique entre tous les éléments Executable.
      - MountRoot
        L'élément MountRoot est requis si vous évaluez le code source depuis un système distant. MountRoot indique à Ounce/Make d'ajouter en préfixe le point de montage à tous les chemins d'accès absolus include rencontrés.
    - Exemples de fichiers de propriétés
  - Exemples
    Cette section décrit trois façons d'utiliser Ounce/Make.
- AppScan® Source
  L'interface CLI est une interface de la fonctionnalité de base AppScan® Source.
- L'outil de génération Ounce/Ant
  Cette section décrit comment utiliser Ounce/Ant, qui est un utilitaire de génération AppScan® Source intégrant AppScan Source et Apache Ant. L’intégration d’Ounce/Ant avec votre environnement Ant vous aide à automatiser les générations et les évaluations de code.
- API d'accès aux données AppScan® Source
  L'API d'accès aux données fournit l'accès aux résultats d'évaluation générés par AppScan® Source, y compris aux constatations et aux détails des constatations. Elle donne également accès aux métriques d'évaluation telles que la date et l'heure de l'analyse, le nombre de lignes de code, la densité V et le nombre de constatations.
- Glossaire
  Apprenez la terminologie courante du produit

`GlobalProjectOptions`

L'élément GlobalProjectOptions spécifie les options au niveau du projet s'appliquant à tous les fichiers que contient le projet. L'élément GlobalProjectOptions et ses attributs ne sont pas obligatoires.

La liste suivante décrit les attributs de l'élément GlobalProjectOptions :

include_paths : valeur de type Chaîne. Liste de chemins include (inclusion) séparés par des points-virgules à appliquer à tous les fichiers du projet.
macros : valeur de type Chaîne. Liste de macros séparées par des points-virgules à appliquer à tous les fichiers du projet.
compiler_options : valeur de type Chaîne. Liste d'options de compilateur, séparées par un espace, s'appliquant à tous les fichiers du projet. Vous ne devez pas spécifier ici les chemins include et les macros.

Exemple

Exemple de ligne du fichier de propriétés utilisant tous ces attributs :

<GlobalProjectOptions include_paths="/usr/include;/usr/local/include"
macros="DEBUG;WIN32" compiler_options="-f non-const-strings"/>

Description

include_paths="/usr/include;/usr/local/include" ajoute le chemin à la section Includes de la configuration du projet.
macros= "DEBUG;WIN32" ajoute les macros DEBUG et WIN32 à la section Macros de la configuration du projet.
compiler_options= ajoute les options de compilateur à la section Options/Command Line de la configuration du projet.