Obter arquivos jar de origem anexados às dependências gerenciadas pelo Eclipse for Maven

Estou usando o Maven (e a Integração do Maven Eclipse) para gerenciar as dependências dos meus projetos Java no Eclipse. O recurso de download automático de arquivos JAR dos repositórios Maven economiza em tempo real. Infelizmente, ele não inclui a documentação da API e o código-fonte.

Como configurar o Maven para obter automaticamente também os anexos de origem e javadoc e registrá-los corretamente no Eclipse?

Estou certo de que o plugin m2eclipse Maven para Eclipse - ao contrário - pode fazer isso. Você pode configurá-lo para baixar os arquivos de origem e o javadoc automaticamente para você.

Isso é alcançado em Janela> Preferências> Maven e verificando as opções "Fazer download de fontes de artefato" e "Fazer download de artefato JavaDoc".

mvn eclipse:eclipse -DdownloadSources=true

ou

mvn eclipse:eclipse -DdownloadJavadocs=true

ou você pode adicionar os dois sinalizadores, como Spencer K aponta.

Além disso, a =trueparte não é necessária, para que você possa usar

mvn eclipse:eclipse -DdownloadSources -DdownloadJavadocs

As outras respostas neste trabalho, mas se você quiser evitar ter que se lembrar dos argumentos da linha de comando, também poderá adicionar a configuração downloadSources e downloadJavadocs à seção maven-eclipse-plugin do seu 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>

Prefiro não colocar as configurações de download de origem / Javadoc no pom.xmlarquivo do projeto, pois sinto que essas são preferências do usuário, não propriedades do projeto. Em vez disso, eu os coloco em um perfil no meu settings.xmlarquivo:

<?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>

Clique com o botão direito do mouse em projeto -> maven -> fontes de download

Se os jars de origem estiverem no repositório local e você estiver usando o Eclipses, eles serão automaticamente anexados. Você pode executar o mvn dependency:sourcesdownload de todos os frascos de origem para um determinado projeto. Não tenho certeza de como fazer o mesmo com a documentação.

Se você estiver usando meclipse, faça

janela -> maven -> Fazer Download das Fontes de Artefato (marque a seleção)

(Se você ainda receber a janela de fonte de anexação, clique no botão anexar arquivo e feche a janela de fonte de anexação. Na próxima vez em que tentar ver a fonte, ela abrirá a fonte correta)

Surajz

Há também uma pergunta semelhante que responde a isso e inclui exemplos de configurações de pom.

Eu tentei windows-> pref ..-> Maven Mas não estava funcionando. Portanto, criei um novo caminho de classe com o comando mvn eclipse: eclipse -DdownloadSources = true e atualizei o espaço de trabalho uma vez. voila .. Fontes foram anexadas.

A entrada do jar de origem está disponível no caminho da classe. Portanto, o novo build resolveu o problema ...

na minha versão do Helios Eclipse com m2Eclipse não há

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

Sob a janela é apenas "nova janela", "novo editor" "perspectiva aberta" etc.

Se você clicar com o botão direito do mouse no seu projeto, escolha maven -> download sources

Nada acontece. nenhuma fonte é baixada, nenhum arquivo pom é atualizado, nenhuma janela é exibida perguntando quais fontes.

Fazer mvn xxx fora do eclipse é perigoso - alguns comandos não funcionam com m2ecilpse - fiz isso uma vez e perdi o projeto inteiro, tive que reinstalar o eclipse e começar do zero.

Ainda estou procurando uma maneira de obter ecilpse e maven para encontrar e usar a fonte de frascos externos como servlet-api.

Mudar o pom do maven-eclipse-plugin para incluir source / javadoc apenas solicita que novas dependências sejam adicionadas ao pom. Se precisarmos solicitar dependências existentes, devemos executar mvn dependency: sources. Eu verifiquei isso.

Verificar a fonte de download / javadoc na preferência Eclipse-Maven, às vezes não é suficiente. No caso de o maven falhar ao fazer o download por algum motivo (um blecaute na rede?), O maven cria alguns arquivos * .lastUpdated e nunca mais será baixado novamente. Minha solução empírica foi excluir o diretório de artefatos de .m2 / repository e reiniciar o espaço de trabalho do eclipse com a fonte de download / javadoc marcada e atualizar os projetos na inicialização também. Após o espaço de trabalho ter sido reiniciado, talvez alguns projetos possam ser marcados com erro, enquanto o progresso do eclipse estiver sendo baixado, qualquer erro será limpo. Talvez este procedimento não seja tão "científico", mas para mim foi bem-sucedido.

Eu adicionei a configuração pom ao plugin maven-eclipse para baixar o código-fonte e os javadocs, mas acho que espero que isso aconteça para novas dependências, e não para as existentes.

Para dependências existentes, naveguei no explorador de pacotes até "Dependências do Maven" e cliquei com o botão direito do mouse em commons-lang-2.5.jar, selecionado Maven | Baixe Fontes e ... nada pareceu acontecer (nenhuma barra de progresso ou indicação de que estava fazendo alguma coisa). No entanto, ele foi baixado, pois agora eu posso ir para a fonte em commons-lang.

pense demais usando a configuração no 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>
...

Primeiro, pensei que isso ainda não anexaria o javadoc e o sources (como tentei sem êxito com a opção -DdownloadSources antes).

Mas surpresa: o arquivo .classpath está recebendo suas fontes e javadoc anexados ao usar a variante POM!

Para Indigo (e provavelmente Helios), as caixas de seleção mencionadas acima estão localizadas aqui:

Janela -> Preferências -> Maven

Eu tive um problema semelhante, e a solução que funcionou melhor para mim foi incluir a fonte no mesmo jar que o código compilado (para que um determinado diretório no jar incluísse ambos Foo.javae Foo.class). O Eclipse associa automaticamente a fonte ao código compilado e fornece automaticamente o JavaDoc a partir da fonte. Obviamente, isso só é útil se você controlar o artefato.

Após definir as propriedades no nível do projeto ou nas propriedades do usuário, faça um Maven -> Atualizar projeto (Forçar atualização). Ele baixa as fontes