2014-09-18 16 views
13

Ho scritto classi Java con comandi JavaDoc che contengono caratteri speciali come äöü. A generare il JavaDoc utilizzando un accumulo di file Gradle:Come impostare una codifica per JavaDoc in gradle?

apply plugin: 'java' 

e nella riga di comando: gradle javadoc.

La codifica dei file originali è UTF-8. Anche la codifica dei file JavaDoc è UTF-8. Ma non c'è alcun suggerimento nelle fonti HTML, che i file siano UTF-8. Ecco perché il mio browser pensa sempre che sia ISO-8859.

Come posso dire a javadoc (via gradle) di aggiungere anche <meta charset="utf-8"/> ai codici sorgente, quando si genera il JavaDoc?

risposta

14

Dovrai impostare la javadoc charset option.

javadoc { 
    options.encoding = 'UTF-8' 
} 
+10

Sono confuso come l'opzione si chiama 'encoding' invece di' charset' in Gradle –

+3

@ArneBurmeister infatti, le opzioni. encoding = 'UTF-8' ha funzionato per me. – amitav13

5

Uso il gradino 2.13+ e né la risposta di Mark né il commento di Arne funzionano per me.

Tuttavia, ho potuto risolvere il problema tramite addStringOption():

javadoc { 
    options.addStringOption("charset", "UTF-8") 
} 

See gradles Javadoc documenti e la possibilità charset da Javadoc per maggiori dettagli.

+1

Ho confermato la tua soluzione per la versione 'Gradle'' 2.14.1', funziona solo con il tuo approccio. –

5

Sto utilizzando Gradle 2.1 e ho trovato la seguente configurazione per me.

tasks.withType(Javadoc) { 
    options.encoding = 'UTF-8' 
} 
2

Per me funziona questo:

javadoc { 
    options.addStringOption('encoding', 'UTF-8') 
} 

In Gradle 3.3