Maven-Abhängigkeit mit javadocs
3 Fragen:
Unten sind zwei maven Abhängigkeiten für JUnit. Ich habe wurden scheuern der interwebs für Stunden und kann nicht scheinen, um zu bestimmen, ob die zweite ist Javadoc + code oder nur Javadoc. Brauche ich eine oder beide? Weiter, was ist der möglichst effiziente Weise zu zählen Javadocs in einem Projekt für die Entwicklung noch nicht in der Produktion bauen? (Ich würde lieber nicht manuell herunterladen javadocs für jede Abhängigkeit-auf jedem Rechner.)
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.11</version>
</dependency>
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.11</version>
<classifier>javadoc</classifier>
</dependency>
EDIT: Fragen:
- Was ist der Unterschied zwischen diesen Abhängigkeiten?
- Brauche ich beide
Sie werden in der Lage zu nutzen, die Abhängigkeit & haben Javadoc auf der hand? - Was ist die beste Praxis für inklusive Javadocs für diese Entwicklung?
- Dies sollte helfen (Wenn ich einen bekommen, der deine Frage richtig): stackoverflow.com/questions/5780758/...
- Ich sah, dass man vor. Ich habe die empfohlenen add noch haben Sie ein wenig verloren an diesem Schritt: "Dann stellen Sie sicher, dass die activeProfiles umfasst das neue Profil an."
- Es sollte ausreichend sein, kopieren Sie den code aus der Antwort auf Ihre
~/.m2/settings.xml
- Datei. Sie haben können, um das Profil-element zu Ihnen profile (wenn es bereits einige definiert)
Du musst angemeldet sein, um einen Kommentar abzugeben.
Generell deine IDE mit der Auflösung von javadoc für Sie in ein maven-Projekt. Dieser ist-vorausgesetzt, Ihre IDE versteht maven - z.B. netbeans, intellij oder eclipse w/m2e.
Das zweite Artefakt ist nur die javadocs. Das erste Artefakt ist der code. Es gibt fast nie einen guten Grund warum die javadoc-Artefakt als eine Abhängigkeit.
org.junit.Assert.assertNotNull
), Sie sollten beginnen zu sehen, die javadocs füllen, wenn Sie nicht bereits starten.In der Regel Javadocs sind nicht in Erster Linie als Abhängigkeit. Denn diese sind weder erforderlich, beim kompilieren noch Laufzeit. Es ist nur zu helfen, die Entwickler während der Entwicklung oder debugging.
Vorausgesetzt, die mithilfe der java-IDE Eclipse kann man mit den java-docs, wie verwiesen. Im folgenden werden die Ansätze, die wir zuordnen können die javadocs/Quellen mit den jeweiligen Gläsern.
1. Wenn es nicht-maven-Projekt :
Laden Sie die javadocs jar-oder Zip-Datei, was auch immer verfügbar, und legte es in ein Verzeichnis.
Rechtsklick auf die Anwendung-Projekt in der IDE Eclipse, klicken Sie auf Eigenschaften, und wählen Sie Java Build Path wählen Sie dann die Registerkarte Bibliotheken unter Java Build Path. Erweitern Sie nun das Glas, das Sie möchten, eine Verknüpfung mit java-docs/Quelle. Wählen Sie in der Javadoc-link und klicken Sie auf die Schaltfläche Bearbeiten, erscheint ein neues Fenster, wo müssen wir die javadocs jar Pfad. Klicken Sie auf OK, und wir verknüpften die javadoc/source mit dem jeweiligen Gläser.
2. Wenn es ein maven Projekt
Wenn wir mit den Maven-Projekt gehen Sie dann zu jar-Dateien im Maven-dependency über das Projekt im Projekt-Explorer-Ansicht, wie unten gezeigt. Jetzt Rechtsklick auf die jar-Datei, die Sie hinzufügen möchten, in der Javadoc/source, wählen, Maven, dann klicken Sie auf Javadoc oder Quelle, die Sie wollen, um die Verknüpfung mit dem Projekt. Jetzt IDE wird automatisch laden Sie die erforderlichen javadoc/source und verknüpfen Sie mit der entsprechenden jar in das Projekt.
Sie können dies überprüfen, indem Sie mit der rechten Maustaste auf das Projekt in der IDE und klicken Sie auf Java Build Path und wählen Sie die Registerkarte "Bibliotheken" unter dem Java Build Path und dann erweitern Sie die gewünschte jar, hier, wenn Sie auf die Schaltfläche Bearbeiten klicken, sehen Sie die verknüpften Pfad der Javadoc/Source mit dem jeweiligen Glas wie gezeigt unten im Bild.
3. Wenn es Maven Projekt und wir setzen Sie die default-Verhalten:
Eclipse aquatically download javadoc/source zusammen mit den wichtigsten erforderlichen jar an den Start.
Vom default-Einstellung Weisung an Maven zum download Javadoc/sources für alle Gläser verknüpft das Projekt.
Klicken Sie auf Windows – Einstellungen – wählen Sie Maven und klicken Sie auf die checkbox Download Artifact Javadoc-wie unten gezeigt
Klicken Sie nun auf übernehmen und speichern Sie es, und jetzt, wenn Sie neue Maven-Projekt , standardmäßig die Javadocs wird heruntergeladen bekommen und mit alle abhängigen jar-Dateien in das Projekt.
Sie können überprüfen, indem Sie mit der rechten Maustaste auf das Projekt und Eigenschaften und unter Java Build path sehen kann, die javadocs sind im Zusammenhang mit allen die Gläser wie unten gezeigt.
Wenn Ihr Projekt Maven-Projekt, dann ist Es immer am besten zu verwenden, 2. Ansatz, weil mit diesem Ansatz die IDE und Maven kümmert sich um den Download der richtigen version von Javadoc/source und verknüpft es mit der relativen jar als auch.
Ansatz 3. ist etwas teuer, weil die javadoc/sources heruntergeladen werden füralle die abhängigen jars, kann sein, Sie sind nicht daran interessiert, für javadocs/Quellen für alle, die abhängigen jars.
Stieß ich auf dieses problem als ich ein maven-Projekt in eclipse und weder javadoc noch die Quelle meiner Abhängigkeiten, wo an meinem Projekt, und ich fragte mich, welche Abhängigkeit hinzufügen.
Was mir geholfen war das hinzufügen
meine pom.xml. So, Sie haben nur die erste Abhängigkeit, und maven/eclipse kümmern sich um das herunterladen der zweiten (das ist, wie schon in der anderen Antwort, nur die javadoc).