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 Ensuite, choisissez 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 éclipseVous pouvez ensuite importer le projet en utilisant 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
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éeGit 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
- 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