SORU
8 NİSAN 2013, PAZARTESİ


Maven JavaDoc etiketleri eksik olduğunda Java 8'de çalışmıyor

Maven kullanıyorum beri eksik java doc etiketleri (örneğin, eksik bir parametre) yerel depo projelerime kurmak ve yüklemek için mümkün olmuştur.

Ancak o günden beri ben de göç için Java 8 (1.8.0-ea-b90) Maven kesinlikle katı hakkında eksik belgeler etiketler ve Haritayı bana çok JavaDoc hataları ile ilgili JavaDoc sorunlar zaman ben denemek için inşa veya yüklemek projesi nerede JavaDoc değil "mükemmel". Derleme ve benim yerel depo yükleme yapmaya çalışıyorum bazı projeleri hangi denetim yok üçüncü parti projeler. Sadece tüm bu projeler tüm javadocs sabitleme geçici çözüm benim senaryoda uygun değil gibi görünüyor.

Bu benim proje mvn clean package install öldürdüğümde görüyorum çıktı küçük bir parçasıdır:

[INFO] ------------------------------------------------------------------------
[INFO] BUILD FAILURE
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 9.026s
[INFO] Finished at: Mon Apr 08 21:06:17 CEST 2013
[INFO] Final Memory: 27M/437M
[INFO] ------------------------------------------------------------------------
[ERROR] Failed to execute goal org.apache.maven.plugins:maven-javadoc-plugin:2.9:jar (attach-javadocs) on project jpc: MavenReportException: Error while creating archive:
[ERROR] Exit code: 1 - /Users/sergioc/Documents/workspaces/heal/jpc/src/main/java/org/jpc/engine/prolog/PrologDatabase.java:10: error: @param name not found
[ERROR] * @param terms the terms to assert
[ERROR] ^
[ERROR] /Users/sergioc/Documents/workspaces/heal/jpc/src/main/java/org/jpc/engine/prolog/PrologDatabase.java:11: warning: no description for @return
[ERROR] * @return
[ERROR] ^

JavaDoc plugin benim POM: bu gibi yapılandırılır

    <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-javadoc-plugin</artifactId>
        <version>2.9</version>
        <executions>
            <execution>
                <id>attach-javadocs</id>
                <goals>
                    <goal>jar</goal>
                </goals>
            </execution>
        </executions>
    </plugin>

Daha önce de söylediğim gibi, her şey eğer Java 7 dönsem iyi çalışıyor. Belki de bu bir hata, Java 8'de Maven çalışan bir ilgisi var mı ? Nasıl çalışır (yani, proje Javadoc oluşturma ve benim yerel depo kodu yüklemek mümkün) Java 8 ile alabilir miyim ? Hem Maven ve 3.0.3) içinde 3.0.5 ile test ettik.

GÜNCELLEME:

Eğer <failOnError>false</failOnError> JavaDoc plugin benim yapılandırma (teşekkürler Martin) değiştirirsem:

    <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-javadoc-plugin</artifactId>
        <version>2.9</version>
        <executions>
            <execution>
                <id>attach-javadocs</id>
                <goals>
                    <goal>jar</goal>
                </goals>
            </execution>
        </executions>
    </plugin>

O proje benim yerel depo yüklenir. Ancak, javadoc kavanoz yine de oluşturulur:

Bu yeni yapılandırma ile konsolu olarak görüyorum çıkış parçası

[HATA] MavenReportException: arşiv oluşturulurken Hata: Exit kod: 1 - Kullanıcılar //....:18 java: uyarı: @hiç param ... Komut satırı oldu: /Library/Java/Home/@@bin/javadoc seçenekleri paketleri

Oluşturulan Javadoc bakın dosyaları '/Kullanıcı/Belgeler sergioc//çalışma/iyileşmek/minitoolbox/hedef/apidocs' dir.

at org.apache.maven.plugin.javadoc.AbstractJavadocMojo.executeJavadocCommandLine(AbstractJavadocMojo.:5043 java) at org.apache.maven.eklenti.javadoc.AbstractJavadocMojo.executeReport(AbstractJavadocMojo.:1990 java) at org.apache.maven.eklenti.javadoc.JavadocJar.(JavadocJar yürütmek.:181 java) at org.apache.maven.eklenti.DefaultBuildPluginManager.executeMojo(DefaultBuildPluginManager.:101 java) at org.apache.maven.yaşam döngüsü.iç.MojoExecutor.(MojoExecutor yürütmek.:209 java) at org.apache.maven.yaşam döngüsü.iç.MojoExecutor.(MojoExecutor yürütmek.:153 java) at org.apache.maven.yaşam döngüsü.iç.MojoExecutor.(MojoExecutor yürütmek.:145 java) at org.apache.maven.lifecycle.internal.LifecycleModuleBuilder.buildProject(LifecycleModuleBuilder.:84 java) at org.apache.maven.lifecycle.internal.LifecycleModuleBuilder.buildProject(LifecycleModuleBuilder.:59 java) at org.apache.maven.yaşam döngüsü.iç.LifecycleStarter.singleThreadedBuild(LifecycleStarter.:183 java) at org.apache.maven.yaşam döngüsü.iç.LifecycleStarter.(LifecycleStarter yürütmek.:161 java) org.apache.maven.DefaultMaven.doExecute(DefaultMaven.:320 java) org.apache.maven.DefaultMaven.(DefaultMaven yürütmek.:156 java) org.apache.maven.cli.MavenCli.(MavenCli yürütmek.:537 java) org.apache.maven.cli.MavenCli.etki alanı(MavenCli.:196 java) org.apache.maven.cli.MavenCli.ana(MavenCli.:141 java) güneş.yansıtır.NativeMethodAccessorİmpl.invoke0(Doğal Yöntem) güneş.yansıtır.NativeMethodAccessorİmpl.çağırmak(NativeMethodAccessorİmpl.:57 java) at güneş.yansıtır.DelegatingMethodAccessorİmpl.çağırmak(DelegatingMethodAccessorİmpl.:43 java) java.lang.yansıtır.Yöntem.çağırmak(Yöntemi.java:491) org.codehaus.pleksus.classworlds.başlatıcısı.Başlatıcısı.launchEnhanced(Launcher.:290 java) at org.codehaus.pleksus.classworlds.başlatıcısı.Başlatıcısı.fırlatma(Launcher.:230 java) at org.codehaus.pleksus.classworlds.başlatıcısı.Başlatıcısı.mainWithExitCode(Launcher.:409 java) at org.codehaus.pleksus.classworlds.başlatıcısı.Başlatıcısı.ana(Launcher.:352 java)

Java 7 ile çalışıyordu gibi kaynakları oluşturmak, proje yüklemek ve tek bir adımda Java doc kavanoz oluşturmak için nasıl ilgili herhangi bir çözüm ?

CEVAP
24 Mayıs 2013, Cuma


Olan DocLint is a new feature in Java 8 şeklinde özetlenebilir:

Javadoc yorum hataları erken tespit için bir yol sağlar. ve kolayca geri bağlı bir şekilde geliştirme döngüsü kaynak kodu.

Bu varsayılan olarak etkindir, ve Javadocs oluşturmadan önce çekleri bir sürü çalışır. in this thread belirtildiği gibi bu Java 8 için kapatmanız gerekir. Maven yapılandırmanıza eklemek zorunda olacak:

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-javadoc-plugin</artifactId>
    <version>2.9</version>
    <executions>
        <execution>
            <id>attach-javadocs</id>
            <goals>
                <goal>jar</goal>
            </goals>
            <configuration>
                <additionalparam>-Xdoclint:none</additionalparam>
            </configuration>
        </execution>
    </executions>
</plugin>

Edit: <configuration> tag . kapatmak için Unuttum

Bunu Paylaş:
  • Google+
  • E-Posta
Etiketler:

YORUMLAR

SPONSOR VİDEO

Rastgele Yazarlar

  • Dylan Dubay

    Dylan Dubay

    10 Temmuz 2013
  • movies95

    movies95

    27 Kasım 2006
  • warningthepeople

    warningthepe

    21 EYLÜL 2011

İLGİLİ SORU / CEVAPLAR