[Gradle] Build-Vorgänge, die häufig in Java-Projekten ausgeführt werden

Escape-Eigenschaftendateien

Von den Ressourcen Eigenschaftendateien, die Mehrbytezeichen wie Japanisch enthalten Es ist üblich, mit dem Befehl native2ascii zu entkommen. Um Escape-Dateien in Gradle zu entkommen Abhängig davon, ob die Codierung der Eigenschaftendatei mit den Standardeinstellungen des Projekts übereinstimmt Es gibt zwei Einstellmethoden.

Vorherige Kenntniss

Im Java-Plug-In von Gradle sind die Elemente in Bezug auf Ressourcen wie folgt.

--Terms Platzieren Sie Ressourcen in den Verzeichnissen src / main / resources und srt / test / resources --Aufgabe Die Aufgaben processResources und processTestResources befinden sich in dem Verzeichnis, das durch die obigen Konventionen festgelegt wurde Die platzierten Ressourcendateien sind build / resources / main bzw. build / resources / test. In ein Verzeichnis kopieren.

Entspricht der Standardcodierung des Projekts

Gibt einen Filter an, der Aufgaben vom Typ "Kopieren" entgeht, z. B. die Aufgabe "processResources". = processResources Escape, wenn die Aufgabe eine Kopie der Ressource erstellt

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

processResources {
    filter(EscapeUnicode)
}

Wenn abweichend von der Standardcodierung des Projekts

Escape-Unicode-Filter legen die Standardcodierung fest Die Codierung kann nicht angegeben werden. Verwenden Sie in diesem Fall die native2ascii-Task von Ant und geben Sie die Codierung für jede Ausführung an.

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

Verschiedene Einstellungen der JAR-Datei

Angabe des JAR-Dateinamens

Der JAR-Dateiname lautet standardmäßig " .java". Es gibt zwei Möglichkeiten, den Dateinamen anzugeben.

jar {
    archiveName = 'sample.jar'
}

//Wenn archiveName festgelegt ist, wird dies priorisiert.
//Der durch die folgenden Einstellungen generierte JAR-Dateiname lautet "Beispiel".-bin-1.0-jdk17.Es wird "Glas".
jar {
    baseName = 'sample'
    appendix = 'bin'
    version = '1.0'
    classifier = 'jdk17'
}

Angeben des Ausgabeinhalts von Javadoc

Die Javadoc-Ausgabe befindet sich standardmäßig im Verzeichnis build / docs / javadoc Titel (- \ <Einstellung der Versionseigenschaft >) Javadoc wird generiert. Das Ausgabeziel und der Titel von Javadoc können wie folgt geändert werden.

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

Javadoc externe Referenz

Wenn Sie auf ein vorhandenes Javadoc verweisen möchten, z. B. die Java-Standard-API, Sie können einen Link zu Javadoc erstellen.

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

Referenz

Dieser Artikel wurde unter Bezugnahme auf die folgenden Bücher geschrieben.

Nachschlagewerk: Gründliche Einführung in Gradle Erstellen einer Automatisierungsplattform mit Build-Tools der nächsten Generation