Generieren von Javadoc-Fehler Android Studio
Aus irgendeinem Grund ich kann nicht generiert werden (javadoc mit Android Studio, nach wie 96 Warnungen es gibt mir diese:
95 warnings
java.lang.NullPointerException
at com.sun.tools.javadoc.TypeMaker.getType(TypeMaker.java:83)
at com.sun.tools.javadoc.TypeMaker.getType(TypeMaker.java:44)
at com.sun.tools.javadoc.ClassDocImpl.superclassType(ClassDocImpl.java:496)
at com.sun.tools.doclets.internal.toolkit.util.Util.getAllInterfaces(Util.java:453)
at com.sun.tools.doclets.internal.toolkit.util.Util.getAllInterfaces(Util.java:491)
at com.sun.tools.doclets.internal.toolkit.util.ClassTree.processType(ClassTree.java:194)
at com.sun.tools.doclets.internal.toolkit.util.ClassTree.buildTree(ClassTree.java:146)
at com.sun.tools.doclets.internal.toolkit.util.ClassTree.<init>(ClassTree.java:91)
at com.sun.tools.doclets.internal.toolkit.AbstractDoclet.startGeneration(AbstractDoclet.java:123)
at com.sun.tools.doclets.internal.toolkit.AbstractDoclet.start(AbstractDoclet.java:83)
at com.sun.tools.doclets.formats.html.HtmlDoclet.start(HtmlDoclet.java:63)
at com.sun.tools.doclets.standard.Standard.start(Standard.java:39)
at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:57)
at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)
at java.lang.reflect.Method.invoke(Method.java:601)
at com.sun.tools.javadoc.DocletInvoker.invoke(DocletInvoker.java:280)
at com.sun.tools.javadoc.DocletInvoker.start(DocletInvoker.java:160)
at com.sun.tools.javadoc.Start.parseAndExecute(Start.java:397)
at com.sun.tools.javadoc.Start.begin(Start.java:167)
at com.sun.tools.javadoc.Main.execute(Main.java:59)
at com.sun.tools.javadoc.Main.main(Main.java:49)
javadoc beendet mit exit-code 1
Gibt es eine Möglichkeit zum erstellen des javadoc in android studio? Wenn nicht, wie könnte ich eines erstellen, ich muss zu geben, es mit meinem Projekt.
Du musst angemeldet sein, um einen Kommentar abzugeben.
Einer Kombination der zwei Antworten, die hier gegeben die gut für mich gearbeitet. Obwohl die docs generieren fein, ich bekomme immer noch 900 Warnungen und 140 Fehler, ABER Sie sind alle im Zusammenhang mit der android-Pakete. Dies ist nur die angegebenen Lösungen kombiniert und erklärt etwas für Leute, die nicht so vertraut mit Android Studio oder den command-line-interfaces.
HOW TO GENERATE JAVADOC IN ANDROID STUDIO
Der "tricky" Teil "Andere BefehlszeilenArgumente". Unter der hübschen GUI, es ist ein direkter Aufruf an die
javadoc
Befehl, der ausgeführt wird in der javadoc-generator. Die command line verwendet eine Struktur wie diese:program_name [-flag] argument [-flag] argument
, die wie Sie denken können, ruft das Programm mit bestimmten optionalen Verhaltensweisen, übergeben, was diese sein sollte.Indem Sie den folgenden unter "Andere BefehlszeilenArgumente"
-encoding utf-8 -bootclasspath /path/to/sdk/platforms/android-##/android.jar
gefolgt von einem Klick auf OKdu bist wirklich aufrufen der javadoc-Programm mit diesen flags und Argumente. Diese beiden flags erlauben die javadoc-Programm zu ignorieren, unicode-Zeichen und finden Sie die android.jar obwohl es scheint, dass alles, was mit # markierten ist zu Lesen als eine Zahl und die android-javadocs mit Ihnen gefüllt werden.
Ich fordere Sie auf, Lesen Sie die Warnungen für Ihre Klassen trotz der scheinbar großen Menge an spam, als
javadoc
wird Ihnen sagen, wenn Sie vergessen haben, Dinge wie leere @return-Anweisungen.Hinzufügen der folgenden Zeile auf
"other command line arguments"
behoben der Fehler:-bootclasspath /path/to/sdk/platforms/android-##/android.jar
Ich glaube nicht, dass dieses Problem ist spezifisch für Android Studio. Ich vermute, es wird passieren, wenn Sie haben, die Unicode-Zeichen in Ihre JavaDoc Kommentare.
Versuchen Sie mit dem folgenden Befehl:
Alternativ können Sie nur die Verwendung der Unicode-escapes (z.B. \u0000) statt, einschließlich Unicode-Zeichen direkt.
In Eclipse, können Sie fügen Sie extras, um die JavaDoc-Befehl:
Projekt -> Generate Javadoc -> Weiter -> auf der letzten Seite, in Extra Javadoc options schreiben:
Wenn Sie einen static final string variable, die die escaped unicode, können Sie versuchen, verweisen auf den Wert der Zeichenfolge in der doc. Android Studio in der Lage war, zu beheben, der unicode in der Seitenleiste Dokumentation für mich. Ich weiß nicht, ob dies funktionieren wird, wenn Sie versuchen zu generieren, der doc von der Befehlszeile aus wenn.
Ich weiß, das mag spät sein, aber es ist die Mühe Wert. Sie können fügen Sie diese zu den gradle.build-Datei