Obtenga archivos jar de origen adjuntos a Eclipse para dependencias administradas por Maven

Estoy usando Maven (y la integración de Maven Eclipse) para administrar las dependencias de mis proyectos Java en Eclipse. La función de descarga automática para archivos JAR de los repositorios de Maven es un ahorro de tiempo real. Desafortunadamente, no incluye documentación de API y código fuente.

¿Cómo puedo configurar Maven para que también obtenga automáticamente los archivos adjuntos fuente y javadoc y los registre correctamente con Eclipse?

Estoy seguro de que el complemento m2eclipse Maven para Eclipse, al revés, puede hacerlo. Puede configurarlo para que descargue los archivos fuente y javadoc automáticamente.

Esto se logra yendo a Ventana> Preferencias> Maven y marcando las opciones "Descargar orígenes de artefactos" y "Descargar Artifact JavaDoc".

mvn eclipse:eclipse -DdownloadSources=true

o

mvn eclipse:eclipse -DdownloadJavadocs=true

o puede agregar ambas banderas, como señala Spencer K.

Además, la =trueporción no es necesaria, por lo que puede usar

mvn eclipse:eclipse -DdownloadSources -DdownloadJavadocs

Las otras respuestas sobre este trabajo, pero si desea evitar tener que recordar los argumentos de la línea de comandos, también puede agregar a la configuración downloadSources y downloadJavadocs a la sección maven-eclipse-plugin de su pom.xml:

<project>
    ...
    <build>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-eclipse-plugin</artifactId>
                <configuration>
                    <downloadSources>true</downloadSources>
                    <downloadJavadocs>true</downloadJavadocs>
                    ... other stuff ...
                </configuration>
            </plugin>
        </plugins>
    </build>
    ...
</project>

Prefiero no poner la configuración de descarga de fuente / Javadoc en el pom.xmlarchivo del proyecto , ya que creo que son preferencias del usuario, no propiedades del proyecto. En cambio, los coloco en un perfil en mi settings.xmlarchivo:

<?xml version="1.0" encoding="UTF-8"?>
<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd">

  <profiles>
    <profile>
      <id>sources-and-javadocs</id>
      <properties>
        <downloadSources>true</downloadSources>
        <downloadJavadocs>true</downloadJavadocs>
      </properties>
    </profile>
  </profiles>

  <activeProfiles>
    <activeProfile>sources-and-javadocs</activeProfile>
  </activeProfiles>
</settings>

Haga clic derecho en proyecto -> maven -> descargar fuentes

Si los archivos jar de origen están en el repositorio local y está utilizando el soporte de Eclipses maven, los orígenes se adjuntan automáticamente. Puede ejecutar mvn dependency:sourcespara descargar todos los archivos jar de origen para un proyecto determinado. Sin embargo, no estoy seguro de cómo hacer lo mismo con la documentación.

Si está usando meclipse do

ventana -> maven -> Descargar fuentes de artefactos (seleccionar verificación)

(Si aún obtiene la ventana de adjuntar fuente, haga clic en el botón adjuntar archivo y cierre la ventana de adjuntar fuente. La próxima vez que intente ver la fuente, se abrirá la fuente correcta)

Surajz

También hay una pregunta similar que responde a esto e incluye ejemplos de configuración de pom.

Intenté windows-> pref ..-> Maven Pero no estaba funcionando. Por lo tanto, creé una nueva ruta de clase con el comando mvn eclipse: eclipse -DdownloadSources = true y actualicé el espacio de trabajo una vez. voila .. Se adjuntaron fuentes.

La entrada del jar de origen está disponible en la ruta de clase. Por lo tanto, la nueva construcción resolvió el problema ...

en mi versión de Eclipse helios con m2Eclipse no hay

window --> maven --> Download Artifact Sources (select check)

Debajo de la ventana solo hay "nueva ventana", "nuevo editor", "perspectiva abierta", etc.

Si hace clic derecho en su proyecto, elija maven -> descargar fuentes

No pasa nada. no se descargan fuentes, no se actualizan archivos pom, no aparece una ventana emergente preguntando qué fuentes.

Hacer mvn xxx fuera de eclipse es peligroso (algunos comandos no funcionan con m2ecilpse). Lo hice una vez y perdí todo el proyecto, tuve que reinstalar eclipse y comenzar desde cero.

Todavía estoy buscando una manera de hacer que Ecilpse y Maven encuentren y usen la fuente de frascos externos como servlet-api.

Cambiar pom para que maven-eclipse-plugin incluya source / javadoc solo se aplica a las nuevas dependencias que se agregan a pom. Si necesitamos solicitar dependencias existentes, debemos ejecutar mvn dependency: sources. Lo comprobé.

Comprobar la fuente de descarga / javadoc en la preferencia Eclipse-Maven, a veces no es suficiente. En el caso de que maven no haya podido descargarlos por algún motivo (¿un apagón de la red?), Maven crea algunos archivos * .lastUpdated, y nunca los volverá a descargar. Mi solución empírica fue eliminar el directorio de artefactos de .m2 / repository, y reiniciar el espacio de trabajo de eclipse con la fuente de descarga / javadoc verificada y actualizar los proyectos al inicio también. Después de reiniciar el espacio de trabajo, tal vez algunos proyectos se puedan marcar por error, mientras se descarga el progreso del eclipse, luego se borrará cualquier error. Tal vez este procedimiento no sea tan "científico", pero para mí fue exitoso.

Agregué la configuración de pom al complemento maven-eclipse para descargar la fuente y los javadocs, pero imagino / espero que eso suceda para las nuevas dependencias, no para las existentes.

Para las dependencias existentes, busqué en el explorador de paquetes hasta las "Dependencias de Maven" e hice clic derecho en commons-lang-2.5.jar, seleccioné Maven | Descargue Fuentes y ... nada parecía suceder (ninguna barra de progreso o indicación de que estaba haciendo algo). Sin embargo, se descargó ya que ahora puedo saltar a la fuente en commons-lang.

pensar demasiado sugiere usar la configuración en el pom:

<project>
...
<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-eclipse-plugin</artifactId>
            <configuration>
                <downloadSources>true</downloadSources>
                <downloadJavadocs>true</downloadJavadocs>
                ... other stuff ...
            </configuration>
        </plugin>
    </plgins>
</build>
...

Primero pensé que esto aún no adjuntaría el javadoc y las fuentes (como intenté sin éxito con esa opción -DdownloadSources antes).

Pero sorpresa: ¡el archivo .classpath está adjuntando sus fuentes y javadoc cuando se usa la variante POM!

Para Indigo (y probablemente Helios), las casillas de verificación mencionadas anteriormente se encuentran aquí:

Ventana -> Preferencias -> Maven

Tuve un problema similar, y la solución que mejor funcionó para mí fue incluir la fuente en el mismo jar que el código compilado (por lo que un directorio dado en el jar incluiría ambos Foo.javay Foo.class). Eclipse asocia automáticamente la fuente con el código compilado y proporciona automáticamente JavaDoc desde la fuente. Obviamente, eso solo es útil si controlas el artefacto.

Después de configurar las propiedades a nivel de proyecto o de usuario, haga un Maven -> Actualizar proyecto (Forzar actualización). Descarga las fuentes.