Construire JMeter

Avant de pouvoir compiler JMeter, vous aurez besoin de quelques éléments :
  • un JDK (Java Development Kit) compatible Java 8
  • Facultatif : installation progressive
  • les sources JMeter comme indiqué dans la section suivante

Acquérir la source

Les versions sources officielles d'Apache JMeter peuvent être téléchargées à partir de la page de téléchargement .

Compilation et empaquetage de JMeter avec Gradle

JMeter peut être entièrement construit à l'aide de Gradle. La commande de base est :

./gradlew build

Voir la liste des tâches disponibles via ./gradlew tâches (ou ./gradlew tâches --all ) pour les autres tâches qui peuvent être utilisées. Des informations plus détaillées sur les tâches disponibles peuvent être trouvées dans gradle.md .

Projet d'ouverture via IntelliJ IDEA

Vous avez besoin d'IntelliJ 2018.3.1 ou d'une version plus récente.

  • Ouvrez le fichier build.gradle.kts avec IntelliJ IDEA et choisissez "Ouvrir en tant que projet"
  • Assurez-vous que "Créer un module séparé par ensemble source" est sélectionné
  • Assurez-vous que "Utiliser le wrapper de gradation par défaut" est sélectionné
  • Dans la boîte de dialogue "Le fichier existe déjà", choisissez "Oui" pour écraser
  • Dans la boîte de dialogue "Ouvrir un projet", choisissez "Supprimer le projet existant et importer"

Compilation et empaquetage de JMeter avec Eclipse

Option 1 : Importation du projet Eclipse via l'assistant "import Gradle project" d'Eclipse

Les versions récentes d'Eclipse peuvent importer automatiquement des projets Gradle, utilisez donc Fichier  →  Importer... Ensuite, choisissez Projet Gradle existant et procédez à l'importation.

Option 2 : Configuration du projet Eclipse avec la tâche Gradle

Une fois que vous avez téléchargé les sources, vous pouvez configurer le projet Eclipse en exécutant :
./gradlew éclipse
Vous pouvez ensuite importer le projet en utilisant Fichier  →  Importer  →  Projets existants dans Workspace et sélectionner le dossier contenant les sources JMeter.

Contribuer à JMeter

Nous aimons contribuer

Nous vous sommes très reconnaissants si vous prenez un peu de temps pour contribuer au projet. Si vous avez du temps à consacrer au projet, vous pouvez sélectionner une amélioration ou un bogue existant sur la page Problèmes .
Vous pouvez également contribuer à la traduction, voir Localisation JMeter (Guide du traducteur) .

Soumettre un patch

Si vous souhaitez contribuer à JMeter pour une correction de bug ou une amélioration, voici la marche à suivre :

Vérifiez votre patch

Avant de soumettre votre patch, assurez-vous de faire ce qui suit :
Vérifiez que le patch compile et respecte la politique d'espace de tabulation en exécutant :

./gradlew check

Vérifiez que le correctif n'interrompt pas les tests JUnit en exécutant :

./gradlew test

Créer un PR avec GIT

  • Ouvrez un problème bugzilla, voir la page Problèmes
  • Fourche Apache JMeter miroir
  • Clonez votre dépôt forké localement :
    git clone https://github.com/yourid/jmeter/
  • Créez une branche en utilisant par exemple l'identifiant bugzilla :
    ID de bogue de la branche git
  • Découvrez la nouvelle succursale :
    ID de bogue de paiement git
  • validez votre correctif ici :
    git commit -m 'Fix to BUGID' liste de fichiers
  • Veuillez éviter de créer des commits de fusion dans le PR. Nous acceptons les petits changements et les commits de fusion sont plus difficiles à réviser
  • Ajoutez le référentiel JMeter en amont :
    git remote ajouter en amont http://www.github.com/apache/jmeter
  • poussez-le :
    ID de bogue d'origine git push
  • Créez un PR et liez-le dans le numéro bugzilla
  • Ou créez un diff et ajoutez-le en pièce jointe au problème bugzilla
    git diff > BUGID.patch
Différents systèmes d'exploitation ont des valeurs par défaut différentes pour les marqueurs de fin de ligne. La configuration typique est CRLF pour Windows et LF pour macOS et GNU/Linux.
Il est recommandé de suivre cette configuration par les paramètres appropriés de core.autocrlf . Pour les fenêtres
git config --global core.autocrlf true
, et pour l'ensemble macOS et GNU/Linux
git config --global core.autocrlf entrée
Git reconnaîtra automatiquement les fichiers texte dans le référentiel grâce à .gitattributes , et Git convertira les fins de ligne des fichiers texte au format natif de la plate-forme appropriée (selon core.autocrlf )
Certains fichiers (par exemple *.sh ou *.bat ) ont politique de fin de ligne prédéfinie quelle que soit la configuration du poste développeur.

Créer un PR à l'aide de Patch

  • Ouvrez un problème bugzilla, voir la page Problèmes
  • Extraire la source Apache JMeter
  • Codez votre correctif
  • Créez votre patch en faisant un clic droit sur le projet Eclipse et sélectionnez Team  →  Create Patch…
  • Attachez votre patch au problème bugzilla

Constructions automatisées

Constructions automatisées (nuit)

Dans le cadre du processus de développement, le projet JMeter a accès à diverses versions de serveur d'intégration continue (CI). La sortie de construction peut être utile pour tester les modifications récentes apportées à la base de code.

Veuillez noter que les versions n'ont subi aucune QA et ne doivent être utilisées que pour les tests de développement. Pour plus d'informations, consultez la page Versions nocturnes pour les développeurs .

Construire des modules complémentaires

Construire des modules complémentaires

Il n'est pas nécessaire de créer JMeter si vous souhaitez simplement créer un module complémentaire. Téléchargez simplement l'archive binaire et ajoutez les jars au chemin de classe ou utilisez des artefacts Maven pour créer vos modules complémentaires. Vous pouvez également télécharger la source afin qu'elle puisse être utilisée par l'IDE.

Voir les fichiers extras/addons* dans l'arborescence des sources pour quelques suggestions

Go to top