Configurer les outils de test pour la publication

Bien que la publication d'outils de test ne nécessite aucune configuration particulière, le mécanisme de capacité utilisé pour gérer ces outils nécessite une configuration supplémentaire.

Pour un artefact donné doté des coordonnées groupId:artifactId:version, Gradle s'attend à ce que l'artefact des outils de test déclare une capacité avec les coordonnées groupId:artifactId-test-fixtures:version. Actuellement, cette opération n'est pas effectuée automatiquement par l'assistance de l'outil de test ou le plug-in Maven Publish. Elle doit donc être effectuée manuellement.

Gradle crée la capacité à partir du nom, du groupe et de la version du projet. Ces trois éléments doivent tous être configurés pour correspondre aux attributs artifactId, groupId et version définis dans la publication.

Par défaut, le nom du projet est le dernier segment de son chemin d'accès, de sorte que le nom par défaut d'un projet dont le chemin est :path:to:mylibrary est mylibrary. Si ce n'est pas ce que vous souhaitez utiliser pour artifactId, vous devez modifier le nom de votre projet.

Deux options s'offrent à vous pour renommer votre projet :

  • Renommez le dossier du projet. Cela modifie le nom du projet ou son chemin d'accès Gradle. Toutes les dépendances de ce projet doivent donc être mises à jour. Conserver le même nom de projet et le même dossier peut impliquer davantage de tâches de réorganisation au départ. Toutefois, cela limite la confusion.
  • Renommez le projet dans Gradle sans renommer le dossier du projet. Cette action permet d'éviter des conséquences sur la gestion des versions du code source, mais divise l'emplacement et le nom du projet.

Pour renommer le projet dans Gradle, insérez le code suivant dans le fichier settings.gradle :

Groovy

include ':path:to:mylibrary'
project(':path:to:mylibrary').name = 'my-library'

Kotlin

include(":path:to:mylibrary")
project(":path:to:mylibrary").name = "my-library"

Ce code attribue le nouveau chemin d'accès du projet à :path:to:my-library.

La valeur groupId correspond par défaut au nom de la compilation, qui est généralement le nom du dossier racine. Par défaut, la valeur version n'est pas spécifiée. Pour modifier les valeurs de l'ID de groupe ou de la version, définissez les propriétés group et version, respectivement, dans votre fichier build.gradle (pour Groovy) ou build.gradle.kts (pour le script Kotlin) au niveau du projet :

Groovy

group = 'com.my-company'
version = '1.0'

Kotlin

group = "com.my-company"
version = "1.0"