Java: Làm thế nào để xây dựng các bản phân phối độc lập của các dự án dựa trên Maven?

Question

Tôi thường gặp phải sự phân phối của các ứng dụng Java hoặc thư viện mà sử dụng Maven làm công cụ xây dựng của chúng.

Một số trong số đó, đáng buồn thay, không cung cấp các lọ độc lập (hoặc có thể phân phối lại).

Có thể xây dựng các ứng dụng dựa trên Maven theo cách như vậy, kết quả xây dựng chứa tất cả các phụ thuộc và có thể được phân phối lại để làm việc ngoài hộp không?

Tôi đã cố gắng xây dựng mô-đun OCM của Jackrabbit. Vì một số lý do rất "thông minh", không có phiên bản độc lập có thể tải xuống .
Vì vậy, tôi đã xây dựng Jackrabbit với Maven (gói nguồn của Jackrabbit bao gồm OCM) và có cùng một cái bình như được tìm thấy trong apache repository. Bình không chứa các phụ thuộc cần thiết và là vô dụng cho tôi.

Answer 1

Thay đổi tệp pom.xml và sử dụng chỉ thị <Embed-Dependency>. Một ví dụ tương tự có thể được tìm thấy here để bạn có thể điều chỉnh nó cho kịch bản của mình.

<Embed-Dependency>*;scope=!test;inline=true</Embed-Dependency> 

Tôi nghĩ điều này nên thực hiện thủ thuật.

---

Đây là ví dụ tại URL ở trên dường như đã hết thời gian chờ.

<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/maven-v4_0_0.xsd"> 
    <modelVersion>4.0.0</modelVersion> 
    <groupId>br.gov.lexml</groupId> 
    <artifactId>toolkit</artifactId> 
    <packaging>bundle</packaging> 
    <version>3.0</version> 
    <parent> 
     <artifactId>lexml</artifactId> 
     <groupId>br.gov.lexml</groupId> 
     <version>1.0</version> 
    </parent> 
    <build> 
     <finalName>Lexml_Toolkit-2.0</finalName> 
     <plugins> 
      <plugin> 
       <groupId>org.apache.maven.plugins</groupId> 
       <artifactId>maven-compiler-plugin</artifactId> 
       <configuration> 
        <source>1.5</source> 
        <target>1.5</target> 
       </configuration> 
      </plugin> 
      <plugin> 
       <groupId>org.apache.felix</groupId> 
       <artifactId>maven-bundle-plugin</artifactId> 
       <extensions>true</extensions> 
       <configuration> 
        <instructions> 
         <!--_include>src/toolkit/resources/META-INF/MANIFEST.MF</_include--> 

         <Export-Package>*;-split-package:=merge-last</Export-Package> 
         <Bundle-Activator>br.gov.lexml.borda.Toolkit</Bundle-Activator> 
         <Bundle-Name>Toolkit</Bundle-Name> 
         <Private-Package /> 
         <Embed-Dependency>*;scope=!test;inline=true</Embed-Dependency> 
         <Bundle-ClassPath>.,{maven-dependencies}</Bundle-ClassPath> 
        </instructions> 
       </configuration> 
      </plugin> 
     </plugins> 
    </build> 
    <dependencies> 
     <dependency> 
      <groupId>org.apache.xmlbeans</groupId> 
      <artifactId>xmlbeans</artifactId> 
      <version>2.4.0</version> 
     </dependency> 
     <dependency> 
      <groupId>org.apache.xmlbeans</groupId> 
      <artifactId>xmlbeans-xmlpublic</artifactId> 
      <version>2.4.0</version> 
     </dependency> 
     <dependency> 
      <groupId>log4j</groupId> 
      <artifactId>log4j</artifactId> 
      <version>1.2.15</version> 
     </dependency> 
     <dependency> 
      <groupId>br.gov.lexmlbeans</groupId> 
      <artifactId>lexmlbeans</artifactId> 
      <version>3.0</version> 
     </dependency> 
    </dependencies> 
</project> 

Answer 2

Bạn có thể có một số may mắn với số . Nếu không, hãy xem assembly plugin. Đó là linh hoạt hơn, nhưng mức độ thấp hơn. Nếu bạn đang sử dụng các plugin lắp ráp, bạn có thể tìm thấy chương trên nó trong maven: the definitive guide để có ích.

Answer 3

Tôi tin rằng Maven Shade Plugin sẽ đáp ứng nhu cầu của bạn. Tôi sử dụng nó khi tôi đang xây dựng các công cụ giao diện dòng lệnh để tạo ra một JAR Uber bao gồm các lớp học của tôi và cùng với các lớp từ tất cả các phụ thuộc của tôi.

Rất dễ sử dụng và tôi nghĩ rằng điều này example là tự giải thích.

Answer 4

Như Dominic đã nói, sử dụng plugin lắp ráp sẽ thực hiện thủ thuật. Bạn thường sẽ cấu hình nó bên POM dự án của riêng bạn để thu thập và đóng gói tất cả phụ thuộc yêu cầu:

... 
    <plugin> 
    <artifactId>maven-assembly-plugin</artifactId> 
    <configuration> 
     <descriptorRefs> 
     <descriptorRef>jar-with-dependencies</descriptorRef> 
     </descriptorRefs> 
    </configuration> 
    </plugin> 
    ... 

jar-with-dependencies được xác định trước bởi các plugin lắp ráp và sẽ bao gồm tất cả phụ thuộc vào gói cuối cùng (xem tài liệu here).

Nếu bạn không muốn sử dụng Maven cho dự án của riêng mình, bạn sẽ cần phải sửa đổi POMs của thư viện và tự đóng gói lại chúng (tải xuống nguồn, thêm đoạn mã trên vào tệp pom.xml và chạy mvn package). Cẩn thận với các phụ thuộc tương tác trùng lặp hoặc không tương thích nếu bạn sử dụng nhiều thư viện. exclusions có thể trợ giúp trong trường hợp đó (xem tài liệu here).

Answer 5

Như một vài áp phích đã nói, plugin lắp ráp là một cách hay để tạo một tệp jar hoàn chỉnh, với tất cả các phụ thuộc của dự án. Tuy nhiên, bạn không thực sự phải sửa đổi tệp pom.xml. Chỉ cần chạy:

mvn assembly:single -DdescriptorId=jar-with-dependencies 

... để tạo tệp jar. Nếu bạn muốn làm bất cứ điều gì nâng cao hơn, bạn có lẽ nên sửa đổi pom.xml, và tạo ra một mô tả lắp ráp tùy chỉnh.

Answer 6

Sử dụng Shade plugin Maven

... nhưng hãy cẩn thận của gotchas (tương tự như một trong những mô tả tiếp tục xuống câu trả lời của tôi), trong đó đã có a workaround explained here.

Ngoài ra, hãy cẩn thận với cấu hình plugin Shade. Tôi đã vô tình sử dụng đôi thẻ <configuration> một lần và các máy biến áp không hề áp dụng và plugin cũng lấy sự tự do không cảnh báo tôi.

Không sử dụng Maven hội cắm

assembly:single sẽ giải nén lọ phụ thuộc của bạn như nó vốn có, và điều này không thể là những gì bạn muốn. Ví dụ. các công cụ như META-INF/spring.schemas sẽ được ghi đè bằng JAR phụ thuộc Spring cuối cùng được đánh giá và do đó, các XSD của bạn sẽ không được tìm thấy (ngoài những thứ trong JAR cuối cùng, tất nhiên). Đó là lý do tại sao các hệ thống như Alfresco đã thực hiện plugin AMP của họ bao gồm các phụ thuộc bên trong lib/ bên trong AMP mà bạn đang xây dựng. Tuy nhiên, điều sau đó làm nảy sinh các vấn đề quản lý phụ thuộc.