Maven 2在开发的实验/快速和粗糙的模型阶段快把我逼疯了。

我有一个pom.xml文件,它定义了我想要使用的web-app框架的依赖关系,我可以从该文件快速生成启动项目。然而,有时我想链接到一个尚未定义pom.xml文件的第三方库,因此我不会手动为第三方库创建pom.xml文件并安装它,并将依赖项添加到我的pom.xml中,我只想告诉Maven:“除了我定义的依赖项之外,还包括/lib中的任何jar。”

似乎这应该是简单的,但如果是,我错过了一些东西。

任何关于如何做到这一点的建议都非常感谢。除此之外,如果有一种简单的方法将maven指向/lib目录,并轻松地创建一个pom.xml,将所有附带的jar映射到一个依赖项,然后我可以将其命名为/ install并链接到它,这也足够了。


这并没有回答如何将它们添加到您的POM中,并且可能是一个无需动脑的问题,但只是将lib目录添加到您的类路径工作吗?我知道,当我需要一个外部jar,但又不想添加到Maven reppos时,我就会这样做。

希望这能有所帮助。


仅用于丢弃代码

设置scope == system,只需要创建groupId, artifactId和version

<dependency>
    <groupId>org.swinglabs</groupId>
    <artifactId>swingx</artifactId>
    <version>0.9.2</version>
    <scope>system</scope>
    <systemPath>${project.basedir}/lib/swingx-0.9.3.jar</systemPath>
</dependency>

注意:系统依赖关系不会复制到生成的jar/war中 (参见如何在使用maven构建的war中包含系统依赖项)


注意:当使用System作用域时(如本页所述),Maven需要绝对路径。

如果你的jar在项目的根目录下,你需要在systemPath值前加上${basedir}。


Maven安装插件使用命令行将jar安装到本地存储库中,POM是可选的,但你必须指定GroupId, ArtifactId, Version和Packaging(所有POM的东西)。


您确实应该通过存储库获得适当的框架,并预先识别您的依赖项。使用系统作用域是人们经常犯的错误,因为他们“不关心依赖管理”。问题是,这样做最终会得到一个不正常的maven构建,无法显示正常情况下的maven。你最好遵循这样的方法。


我发现了一个奇怪的解决办法:

使用Eclipse

创建简单的(非maven) Java项目 添加一个Main类 将所有罐子添加到类路径中 导出可运行JAR(这很重要,因为这里没有其他方法可以做到这一点) 选择将所需的库提取到生成的JAR中 决定牌照事宜 tadammm……将生成的jar安装到m2repo 将这个依赖项添加到其他项目中。

欢呼, Balint


尽管它并不完全适合您的问题,但我还是把它放在这里。我的要求是:

在线maven存储库中找不到的jar应该在SVN中。 如果一个开发人员添加了另一个库,其他开发人员不应该费心手动安装它们。 IDE(在我的例子中是NetBeans)应该能够找到源代码和javadocs来提供自动补全和帮助。

让我们先谈谈(3):只是将jar放在一个文件夹中,然后以某种方式将它们合并到最终的jar中,这在这里是行不通的,因为IDE无法理解这一点。这意味着必须正确安装所有的库。但是,我不想让每个人都使用“mvn安装文件”安装它。

在我的项目中,我需要元部件。开始吧:

创建一个新的maven项目(命名为“shared-libs”或类似的名称)。 下载元部件并将压缩文件解压到src/main/lib中。 文件夹doc/api包含javadocs。创建内容的压缩文件(doc/api/api.zip)。 像这样修改pom 构建项目并安装库。 将库作为依赖项添加到项目中,或者(如果在共享库项目中添加了依赖项)将共享库添加为依赖项,以一次性获得所有库。

每当你有一个新的库,只需添加一个新的执行,并告诉每个人重新构建项目(你可以用项目层次结构来改进这个过程)。


这是我们添加或安装本地jar的方法

    <dependency>
        <groupId>org.example</groupId>
        <artifactId>iamajar</artifactId>
        <version>1.0</version>
        <scope>system</scope>
        <systemPath>${project.basedir}/lib/iamajar.jar</systemPath>
    </dependency>

我给出了一些默认的groupId和artifactId,因为它们是强制性的:)


如果您想要一个快速而简单的解决方案,您可以执行以下操作(尽管我不建议将此方法用于测试项目之外的任何项目,maven会详细地抱怨这是不合适的)。

为您需要的每个jar文件添加一个依赖项,最好使用perl脚本或类似的东西,并将其复制/粘贴到pom文件中。

#! /usr/bin/perl

foreach my $n (@ARGV) {

    $n=~s@.*/@@;

    print "<dependency>
    <groupId>local.dummy</groupId>
    <artifactId>$n</artifactId>
    <version>0.0.1</version>
    <scope>system</scope>
    <systemPath>\${project.basedir}/lib/$n</systemPath>
</dependency>
";

systemPath的问题是依赖项的jar不会作为可传递依赖项沿着工件分布。试试我在这里发布的内容:最好是将项目jar文件Mavenize,还是将它们放在WEB-INF/lib中?

然后像往常一样声明依赖项。

请阅读脚注。


流行方法的问题

在互联网上找到的大多数答案都会建议您将依赖项安装到本地存储库中,或者在pom中指定“系统”作用域,并将依赖项与项目的源代码一起分发。但这两种解决方案实际上都有缺陷。

为什么你不应该应用“安装到本地回购”的方法

When you install a dependency to your local repository it remains there. Your distribution artifact will do fine as long as it has access to this repository. The problem is in most cases this repository will reside on your local machine, so there'll be no way to resolve this dependency on any other machine. Clearly making your artifact depend on a specific machine is not a way to handle things. Otherwise this dependency will have to be locally installed on every machine working with that project which is not any better.

为什么不应该应用“系统范围”方法

使用“System Scope”方法依赖的jar既不能安装到任何存储库中,也不能附加到目标包中。这就是为什么你的发行包在使用时没有办法解决这个依赖。我相信这就是为什么不提倡使用系统作用域的原因。无论如何,你不想依赖一个已弃用的特性。

静态项目内存储库解决方案

把这个放进你的诗里后:

<repository>
    <id>repo</id>
    <releases>
        <enabled>true</enabled>
        <checksumPolicy>ignore</checksumPolicy>
    </releases>
    <snapshots>
        <enabled>false</enabled>
    </snapshots>
    <url>file://${project.basedir}/repo</url>
</repository>

对于每个具有x.y.z形式的组id的工件,Maven将在其搜索工件时在您的项目目录中包含以下位置:

repo/
| - x/
|   | - y/
|   |   | - z/
|   |   |   | - ${artifactId}/
|   |   |   |   | - ${version}/
|   |   |   |   |   | - ${artifactId}-${version}.jar

要详细说明这一点,你可以阅读这篇博文。

使用Maven安装到项目repo

我建议使用Maven插件将jar作为工件安装,而不是手工创建这个结构。因此,要在repo文件夹下将工件安装到项目内存储库执行:

mvn install:install-file -DlocalRepositoryPath=repo -DcreateChecksum=true -Dpackaging=jar -Dfile=[your-jar] -DgroupId=[...] -DartifactId=[...] -Dversion=[...]

如果你选择这种方法,你将能够在pom中简化存储库声明:

<repository>
    <id>repo</id>
    <url>file://${project.basedir}/repo</url>
</repository>

辅助脚本

由于为每个lib执行安装命令有点烦人,而且肯定容易出错,所以我创建了一个实用程序脚本,它自动将lib文件夹中的所有jar安装到项目存储库中,同时从文件名自动解析所有元数据(groupId, artifactId等)。该脚本还打印出依赖项xml,供您复制粘贴到pom中。

在目标包中包含依赖项

当您创建了项目内存储库时,您就解决了项目与其源的依赖关系分布问题,但是从那时起,项目的目标工件将依赖于未发布的jar,因此当您将其安装到存储库时,它将具有无法解决的依赖关系。

为了解决这个问题,我建议在目标包中包含这些依赖项。这可以用Assembly Plugin或者更好的OneJar Plugin来实现。OneJar的官方文档很容易掌握。


这就是我所做的,它也围绕包的问题,它与签出的代码工作。

我在项目中创建了一个新文件夹,在我的情况下,我使用repo,但请随意使用src/repo

在我的POM中,我有一个不在任何公共专家存储库中的依赖项

<dependency>
    <groupId>com.dovetail</groupId>
    <artifactId>zoslog4j</artifactId>
    <version>1.0.1</version>
    <scope>runtime</scope>
</dependency>

然后,我创建了以下目录repo/com/dovetail/zoslog4j/1.0.1,并将JAR文件复制到该文件夹中。

我创建了下面的POM文件来表示下载的文件(这一步是可选的,但它删除了一个警告),并帮助下一个家伙找出我从哪里得到的文件。

<?xml version="1.0" encoding="UTF-8" ?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <groupId>com.dovetail</groupId>
    <artifactId>zoslog4j</artifactId>
    <packaging>jar</packaging>
    <version>1.0.1</version>
    <name>z/OS Log4J Appenders</name>
    <url>http://dovetail.com/downloads/misc/index.html</url>
    <description>Apache Log4j Appender for z/OS Logstreams, files, etc.</description>
</project>

我创建的两个可选文件是POM的SHA1校验和和JAR,用于删除缺失的校验和警告。

shasum -b < repo/com/dovetail/zoslog4j/1.0.1/zoslog4j-1.0.1.jar \
          > repo/com/dovetail/zoslog4j/1.0.1/zoslog4j-1.0.1.jar.sha1

shasum -b < repo/com/dovetail/zoslog4j/1.0.1/zoslog4j-1.0.1.pom \
          > repo/com/dovetail/zoslog4j/1.0.1/zoslog4j-1.0.1.pom.sha1

最后,我将以下片段添加到pom.xml中,使我能够引用本地存储库

<repositories>
    <repository>
        <id>project</id>
        <url>file:///${basedir}/repo</url>
    </repository>
</repositories>

在我们的项目中起作用的是Archimedes Trajano写的,但是我们在.m2/settings.xml中有这样的东西:

 <mirror>
  <id>nexus</id>
  <mirrorOf>*</mirrorOf>
  <url>http://url_to_our_repository</url>
 </mirror>

*应该改为central。因此,如果他的回答不适合您,您应该检查settings.xml


您可以在项目上创建本地存储库

例如,如果你在项目结构中有libs文件夹

在libs文件夹中创建目录结构:/groupId/artifactId/version/artifactId-version.jar 在pom.xml中,您应该注册存储库 <库> <标识> ProjectRepo id > < / <名称> ProjectRepo < /名称> < url >文件:/ / $ {project.basedir} / libs url > < / < /库> 并像往常一样添加依赖项 < >的依赖 < groupId > groupId < / groupId > < artifactId > artifactId < / artifactId > <版本> > < /版本 < / >的依赖

仅此而已。

有关详细信息:如何在Maven中添加外部库(已存档)


在与CloudBees的人员进行了长时间的讨论之后,他们提出了一个有趣的解决方案:

创建一个伪Maven项目,将一个预先存在的JAR附加为主要工件,运行到所属的POM安装:安装文件执行。这里有一个类似POM的例子:

 <build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-install-plugin</artifactId>
            <version>2.3.1</version>
            <executions>
                <execution>
                    <id>image-util-id</id>
                    <phase>install</phase>
                    <goals>
                        <goal>install-file</goal>
                    </goals>
                    <configuration>
                        <file>${basedir}/file-you-want-to-include.jar</file>
                        <groupId>${project.groupId}</groupId>
                        <artifactId>${project.artifactId}</artifactId>
                        <version>${project.version}</version>
                        <packaging>jar</packaging>
                    </configuration>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

但要实现这一目标,必须改变现有的项目结构。首先,您应该记住,对于每种这样的JAR,都应该创建不同的伪Maven项目(模块)。并且应该创建一个父Maven项目,包括所有子模块,即:所有JAR包装器和现有的主项目。结构可以是:

根项目(此包含父POM文件,包括所有带有模块XML元素的子模块)(POM打包) JAR 1包装器Maven子项目(POM包装) JAR 2包装器Maven子项目(POM打包) 主要现有的Maven子项目(WAR, JAR, EAR ....包装)

当通过mvn:install或mvn:packaging运行父模块时,将强制执行子模块。这可能是一个缺点,因为项目结构应该改变,但最后提供了一个非静态的解决方案


使用<scope>system</scope>是一个很糟糕的想法,其他人已经解释了原因,手动将文件安装到本地存储库将使构建不可复制,并且使用<url>file://${project. bat。basedir}/repo</url>也不是一个好主意,因为(1)它可能不是一个格式良好的文件url(例如,如果项目签出在一个包含不寻常字符的目录中),(2)如果这个项目的POM被用作其他项目的依赖项,结果是不可用的。

假设您不愿意将工件上传到公共存储库,Simeon建议使用助手模块来完成这项工作。但现在有一个更简单的方法……

建议

使用non-maven-jar-maven-plugin。完全符合您的要求,没有其他方法的任何缺点。


我找到了另一种方法来做到这一点,看看这里从Heroku的帖子

总结一下(抱歉有些复制和粘贴)

在根文件夹下创建一个repo目录:

yourproject
+- pom.xml
+- src
+- repo

运行这个命令将jar安装到本地的repo目录

mvn deploy:deploy-file -Durl=file:///path/to/yourproject/repo/ -Dfile=mylib-1.0.jar -DgroupId=com.example -DartifactId=mylib -Dpackaging=jar -Dversion=1.0

添加到你的pom.xml:

> <存储库 <!——其他存储库,如果有的话——> <库> <标识> project.local id > < / 项目<名称> < /名称> < url >文件:$ {project.basedir} /回购url > < / < /库> < /存储库> < >的依赖 com . example < / groupId < groupId > > < artifactId > mylib < / artifactId > 1.0 <版本> < /版本> < / >的依赖


我在@alex lehmann's的回答的评论中提到了一些python代码,所以我把它贴在这里。

def AddJars(jarList):
  s1 = ''
  for elem in jarList:
   s1+= """
     <dependency>
        <groupId>local.dummy</groupId>
        <artifactId>%s</artifactId>
        <version>0.0.1</version>
        <scope>system</scope>
        <systemPath>${project.basedir}/manual_jars/%s</systemPath>
     </dependency>\n"""%(elem, elem)
  return s1

我只是想要一个快速而肮脏的变通办法……我不能从Nikita Volkov运行脚本:语法错误+它需要一个严格的jar名称格式。

我制作了这个Perl脚本,它与jar文件名的任何格式一起工作,它在xml中生成依赖项,这样它就可以直接复制粘贴到pom中。

如果你想使用它,确保你理解脚本在做什么,你可能需要改变lib文件夹和groupId或artifactId的值…

#!/usr/bin/perl

use strict;
use warnings;

open(my $fh, '>', 'dependencies.xml') or die "Could not open file 'dependencies.xml' $!";
foreach my $file (glob("lib/*.jar")) {
    print "$file\n";
    my $groupId = "my.mess";
    my $artifactId = "";
    my $version = "0.1-SNAPSHOT";
    if ($file =~ /\/([^\/]*?)(-([0-9v\._]*))?\.jar$/) {
        $artifactId = $1;
        if (defined($3)) {
            $version = $3;
        }
        `mvn install:install-file -Dfile=$file -DgroupId=$groupId -DartifactId=$artifactId -Dversion=$version -Dpackaging=jar`;
        print $fh "<dependency>\n\t<groupId>$groupId</groupId>\n\t<artifactId>$artifactId</artifactId>\n\t<version>$version</version>\n</dependency>\n";
        print " => $groupId:$artifactId:$version\n";
    } else {
        print "##### BEUH...\n";
    }
}
close $fh;

对我来说最简单的就是配置你的maven-compiler-plugin来包含你的自定义jar。这个例子将加载lib目录中的任何jar文件。

        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-compiler-plugin</artifactId>
            <configuration>
                <includes>
                    <include>lib/*.jar</include>
                </includes>
            </configuration>
        </plugin>

一个快速的批量解决方案(基于Alex的回答):

libs.bat

@ECHO OFF
FOR %%I IN (*.jar) DO (
echo ^<dependency^>
echo ^<groupId^>local.dummy^</groupId^>
echo ^<artifactId^>%%I^</artifactId^>
echo ^<version^>0.0.1^</version^>
echo ^<scope^>system^</scope^>
echo ^<systemPath^>${project.basedir}/lib/%%I^</systemPath^>
echo ^</dependency^>
)

执行如下:libs.bat > libs.txt。 然后打开lib .txt并将其内容复制为依赖项。

在我的例子中,我只需要库来编译我的代码,而这个解决方案是实现这一目的的最佳方案。


要安装不在maven库中的第三方jar,使用maven-install-plugin。

步骤如下:

从源代码(网站)手动下载jar文件 创建一个文件夹,并将jar文件放在其中 运行以下命令在本地maven存储库中安装第三方jar

mvn install:install-file -dfile= -dgroupId= -dartifactId= -dversion= -dpackaging=

下面是我用于simmonsite log4j的示例

mvn安装:安装文件 -Dfile=/Users/athanka/git/MyProject/repo/log4j- rollingappender .jar -DgroupId=uk.org.simonsite -DartifactId=log4j- rollingappender -Dversion=20150607-2059 -Dpackaging=jar

在pom.xml中包括如下所示的依赖项 < >的依赖 < groupId > uk.org.simonsite < / groupId > < artifactId > log4j-rolling-appender < / artifactId > <版本> 20150607 - 2059 > < /版本 < / >的依赖 运行mvn clean install命令创建您的打包

以下是参考链接:

https://maven.apache.org/guides/mini/guide-3rd-party-jars-local.html


对于那些在这里没有找到好的答案的人,这是我们正在做的事情,以获得一个包含所有必要依赖项的罐子。这个答案(https://stackoverflow.com/a/7623805/1084306)提到了使用Maven Assembly插件,但实际上并没有给出一个示例。如果你不从头到尾看完答案(答案相当长),你可能会错过它。将以下内容添加到pom.xml中将生成target/${PROJECT_NAME}-${VERSION}-jar-with-dependencies.jar

        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-assembly-plugin</artifactId>
            <version>2.4.1</version>
            <configuration>
                <!-- get all project dependencies -->
                <descriptorRefs>
                    <descriptorRef>jar-with-dependencies</descriptorRef>
                </descriptorRefs>
                <!-- MainClass in mainfest make a executable jar -->
                <archive>
                  <manifest>
                    <mainClass>my.package.mainclass</mainClass>
                  </manifest>
                </archive>

            </configuration>
            <executions>
              <execution>
                <id>make-assembly</id>
                <!-- bind to the packaging phase -->
                <phase>package</phase> 
                <goals>
                    <goal>single</goal>
                </goals>
              </execution>
            </executions>
        </plugin>

Java中scope='system'方法的解决方案:

public static void main(String[] args) {
        String filepath = "/Users/Downloads/lib/";
        try (Stream<Path> walk = Files.walk(Paths.get(filepath))) {

        List<String> result = walk.filter(Files::isRegularFile)
                .map(x -> x.toString()).collect(Collectors.toList());

                String indentation = "    ";
                for (String s : result) {
                    System.out.println(indentation + indentation + "<dependency>");
                    System.out.println(indentation + indentation + indentation + "<groupId>"
                            + s.replace(filepath, "").replace(".jar", "")
                            + "</groupId>");
                    System.out.println(indentation + indentation + indentation + "<artifactId>"
                            + s.replace(filepath, "").replace(".jar", "")
                            + "</artifactId>");
                    System.out.println(indentation + indentation + indentation + "<version>"
                            + s.replace(filepath, "").replace(".jar", "")
                            + "</version>");
                    System.out.println(indentation + indentation + indentation + "<scope>system</scope>");
                    System.out.println(indentation + indentation + indentation + "<systemPath>" + s + "</systemPath>");
                    System.out.println(indentation + indentation + "</dependency>");
                }

    } catch (IOException e) {
        e.printStackTrace();
    }
}