[Gradle] Opérations de construction souvent effectuées dans les projets Java

Fichiers de propriétés d'échappement

Parmi les ressources, des fichiers de propriétés contenant des caractères multi-octets tels que le japonais Il est courant de s'échapper avec la commande native2ascii. Pour échapper aux fichiers de propriétés dans Gradle Selon que le codage du fichier de propriétés est le même que les paramètres par défaut du projet Il existe deux méthodes de réglage.

Connaissance préalable

Dans le plug-in Java de Gradle, les éléments liés aux ressources sont les suivants.

--Termes Placez les ressources dans les répertoires src / main / resources et srt / test / resources --Tâche Les tâches processResources et processTestResources sont dans le répertoire défini par les conventions ci-dessus Les fichiers de ressources placés sont respectivement build / resources / main et build / resources / test. Copier dans un répertoire.

Identique au codage par défaut du projet

Spécifie un filtre qui échappe les tâches de type Copy telles que la tâche processResources. = processResources S'échappe lorsque la tâche fait une copie de la ressource

import org.apache.tools.ant.filters.EscapeUnicode

processResources {
    filter(EscapeUnicode)
}

Si différent du codage par défaut du projet

Les filtres d'échappement Unicode définissent l'encodage par défaut, Le codage ne peut pas être spécifié. Dans ce cas, utilisez la tâche native2ascii d'Ant et spécifiez l'encodage pour chaque exécution.

task native2ascii {
  doLast {
    ant.native2ascii(src: 'src/main/resources',
        dest: processResources.destinationDir,
        encoding: '<Encodage arbitraire>')
  }
}

Divers paramètres du fichier JAR

Spécification du nom du fichier JAR

Le nom du fichier JAR est par défaut .java```. Il existe deux façons de spécifier le nom du fichier.

jar {
    archiveName = 'sample.jar'
}

//Si archiveName est défini, cela est prioritaire.
//Le nom de fichier JAR généré par les paramètres suivants est "sample"-bin-1.0-jdk17.Cela devient "jar".
jar {
    baseName = 'sample'
    appendix = 'bin'
    version = '1.0'
    classifier = 'jdk17'
}

Spécification du contenu de sortie de Javadoc

La sortie Javadoc se trouve dans le répertoire build / docs / javadoc par défaut Intitulé <nom du répertoire racine du projet> (- \ <paramètre de propriété de version >) Javadoc est généré. La destination de sortie et le titre de Javadoc peuvent être modifiés comme suit.

javadoc {
    destinationDir = "example/dist/javadoc"
    title = 'example docs V1.0'
}

Référence externe Javadoc

Si vous souhaitez faire référence à un Javadoc existant, tel que l'API standard Java, Vous pouvez générer un lien vers Javadoc.

javadoc {
    options.links << 'http://docs.oracle.com/javase/jp/7/api/'
}

référence

Cet article est rédigé en référence aux livres suivants.

Ouvrage de référence: [Présentation approfondie de Gradle] Construire une plate-forme automatisée avec des outils de construction de nouvelle génération](https://www.shoeisha.co.jp/book/detail/9784798136431)