2015-03-20 18 views
6

Non riesco a trovare alcuna documentazione su come configurare il mio file Gradle per creare il JavaDoc per il mio progetto. Ho già provato alcuni frammenti di SO e articoli di blog, ma nessuno di loro sembra funzionare o non forniscono un contesto.Come utilizzare Gradle per generare JavaDoc in Android Studio?

Questo è il mio file Gradle. Cosa devo fare per aggiungere un'attività per generare JavaDoc?

import org.apache.tools.ant.taskdefs.condition.Os 

apply plugin: 'com.android.library' 

android { 
    compileSdkVersion 21 
    buildToolsVersion "21.1.2" 

    defaultConfig { 
     minSdkVersion 15 
     targetSdkVersion 21 
     versionCode 1 
     versionName "1.0" 
    } 

    buildTypes { 
     release { 
      minifyEnabled false 
      proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro' 
     } 
    } 
} 

dependencies { 
    compile fileTree(dir: 'libs', include: ['*.jar']) 
    compile 'com.android.support:appcompat-v7:21.0.3' 
} 

risposta

7

Nei nostri progetti abbiamo aggiunto il testo seguente del build.gradle app:

android.applicationVariants.all { variant -> 
    task("generate${variant.name.capitalize()}Javadoc", type: Javadoc) { 
    description "Generates Javadoc for $variant.name." 
    source = variant.javaCompile.source 
    ext.androidJar = "${android.sdkDirectory}/platforms/${android.compileSdkVersion}/android.jar" 
    classpath = files(variant.javaCompile.classpath.files) + files(ext.androidJar) 
    options.links("http://docs.oracle.com/javase/7/docs/api/"); 
    options.links("http://d.android.com/reference/"); 
    } 
} 

Questo aggiungerà attività per la costruzione della forma generate<build_variant>Javadoc. Quindi diciamo che avete un free e una versione pro della vostra applicazione, questo sarebbe aggiungere attività come:

generateFreeDebugJavadoc 
generateFreeReleaseJavadoc 
generateProDebugJavadoc 
generateProReleaseJavadoc 

Spero che questo aiuti

+0

ho uno strano errore nel provare questo: 'Errore: (77, 0) Impossibile trovare la proprietà 'applicationVariants' su com.android.build.gradle.LibraryExtension_Decorated @ 19be5795. - qualche idea? – trippedout

+5

2 cose - 1. Il '' applicationVariants'' funziona solo per il plug-in dell'app, ad esempio, se si sta costruendo una libreria sarebbe '' libraryVariants''. 2. Controlla la versione del tuo Android Gradle. Potrebbe essere che non è aggiornato o è troppo recente e anche questo è cambiato. – Fred

+0

Inizialmente, ho riscontrato degli errori riguardo ai file R **. Aggiunti i seguenti "exclude" **/BuildConfig.java "e" exclude "**/R.java" "subito dopo il percorso della classe. –

1

In studio Android, scrivere un compito Gradle di tipo Javadoc:

task createJavadocs (type: Javadoc) 
    { 
     source = project.android.sourceSets.main.java.srcDirs 
     options.linkSource true 
     classpath += project.files(project.android.getBootClasspath().join(File.pathSeparator)) 
     failOnError false 
    } 

Basta eseguire questa attività per creare javadoc.

Problemi correlati