Khám Phá Không Gian Rộng Lớn Hơn - Sắc Màu Hà Nội
Sắc Màu Hà Nội
Sắc Màu Hà Nội

Khám Phá Không Gian Rộng Lớn Hơn

Tạo file JAR có chứa các thư viện phụ thuộc bằng IDEA và Maven

Trong quá trình phát triển ứng dụng Java, việc đóng gói (build) một ứng dụng thành một tệp JAR là bước thiết yếu để phân phối hoặc triển khai. Tuy nhiên, nếu chỉ tạo một tệp JAR đơn thuần mà không bao gồm các thư viện phụ thuộc (dependencies), ứng dụng sẽ không thể chạy độc lập. Bài viết này hướng dẫn bạn cách sử dụng IntelliJ IDEA kết hợp với Maven để tạo một file JAR hoàn chỉnh, bao gồm tất cả các thư viện cần thiết bên trong.

1. Cấu hình Maven để tích hợp dependencies vào JAR

Maven là công cụ quản lý dự án phổ biến trong môi trường Java. Để đưa các thư viện phụ thuộc vào cùng một file JAR, ta cần thêm plugin maven-assembly-plugin hoặc maven-shade-plugin. Trong ví dụ dưới đây, mình sẽ sử dụng maven-assembly-plugin.

Bạn mở file pom.xml của dự án và thêm đoạn cấu hình sau:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25

<build>
    <plugins>
        <plugin>
            <artifactId>maven-assembly-plugin</artifactId>
            <configuration>
                <descriptorRefs>
                    <descriptorRef>jar-with-dependencies</descriptorRef>
                </descriptorRefs>
                <archive>
                    <manifest>
                        <mainClass>com.example.Main</mainClass>
                    </manifest>
                </archive>
            </configuration>
            <executions>
                <execution>
                    <phase>package</phase>
                    <goals>
                        <goal>single</goal>
                    </goals>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

Lưu ý thay thế com.example.Main bằng tên lớp chính chứa phương thức main() của bạn.

2. Xây dựng (Build) dự án bằng Maven

Sau khi cập nhật xong pom.xml, bạn có thể thực hiện lệnh build từ IntelliJ IDEA như sau:

  1. Vào tab Maven ở bên phải màn hình.
  2. Tìm đến mục Lifecycle, click vào package.
  3. Quá trình biên dịch sẽ bắt đầu, Maven sẽ tự động tạo ra một file JAR mới với tên giống như your-project-name-1.0-SNAPSHOT-jar-with-dependencies.jar.

File này đã được tích hợp đầy đủ các thư viện phụ thuộc, giúp bạn có thể chạy trực tiếp trên bất kỳ máy nào có cài JDK/JRE mà không cần cài đặt thêm bất kỳ phần mềm hay thư viện nào khác.

3. Chạy ứng dụng từ file JAR

Để kiểm tra xem tệp JAR có hoạt động đúng không, bạn có thể chạy lệnh sau từ terminal:

1

java -jar your-project-name-1.0-SNAPSHOT-jar-with-dependencies.jar

Nếu mọi thứ được cấu hình chính xác, ứng dụng của bạn sẽ khởi động bình thường.

4. Một số lưu ý quan trọng

  • Đảm bảo rằng bạn đã xác định đúng lớp chính (Main class) trong phần <mainClass> của plugin.
  • Nếu bạn gặp lỗi liên quan đến bản quyền hoặc xung đột giữa các thư viện, hãy kiểm tra lại phiên bản của các dependency trong pom.xml.
  • Plugin maven-shade-plugin cũng là một lựa chọn thay thế nếu bạn muốn tùy chỉnh sâu hơn về cách gói các thư viện.

Kết luận

Việc tạo một file JAR chứa sẵn các thư viện phụ thuộc là một kỹ năng hữu ích cho các nhà phát triển Java, đặc biệt khi cần triển khai ứng dụng một cách nhanh chóng và tiện lợi. Với sự hỗ trợ mạnh mẽ từ Maven và IntelliJ IDEA, bạn có thể dễ dàng thực hiện quy trình này chỉ với vài bước đơn giản. Hãy thử áp dụng và trải nghiệm!

0%