Java项目Ubuntu编译打包步骤

Ubuntu下Ja va项目编译与打包步骤

在Ubuntu环境下搞定Ja va项目的编译和打包，其实没那么复杂。关键在于把环境搭对，然后根据你的项目特点，选对工具和方法。下面这份手把手的指南，涵盖了从基础环境配置到进阶打包方案的全过程，帮你避开那些常见的坑。

一 准备环境

万事开头难，但环境配置这一步，只要按顺序来，其实很简单。核心就两件事：装好JDK，再选一个趁手的构建工具。

• 安装 JDK（建议 OpenJDK 11 或更高版本）：
  • 打开终端，一条命令就能搞定安装：sudo apt update && sudo apt install openjdk-11-jdk。这条命令会先更新软件包列表，然后安装指定版本的JDK。
  • 装完之后，别忘了验证一下。分别输入ja va -version和ja vac -version，看看输出的版本号是不是你刚装的。这一步能帮你确认环境变量是否配置正确。
• 安装构建工具（二选一或都装）：
  • Ma ven：如果你习惯用Ma ven，安装命令是sudo apt install ma ven。验证安装成功同样用版本命令：mvn -v。
  • Gradle：喜欢Gradle的灵活性？那就用sudo apt install gradle来安装。安装后执行gradle -v进行验证。
• 环境齐备后，建议准备一个有入口类的项目结构来测试。最快捷的方式是使用Ma ven原型生成一个简单项目：mvn archetype:generate -DgroupId=com.example -DartifactId=my-app -DarchetypeArtifactId=ma ven-archetype-quickstart -DinteractiveMode=false。这个命令会在当前目录生成一个标准的Ma ven项目骨架，里面自带一个可执行的示例主类。

二 使用Ma ven打包

对于Ma ven项目，打包过程已经高度标准化。你只需要在包含pom.xml文件的根目录下操作。

• 执行核心打包命令：mvn clean package。这个命令会先清理旧的构建产物，然后执行编译、测试，最终打包。
  • 打包生成的JAR文件默认位于target/目录下，名字通常是项目名-版本号.jar。
  • 不过，默认打出来的JAR可能不可直接运行。这就需要一些常用插件与配置来增强：
    • 编译器插件：用于指定Ja va源码和目标字节码的版本，确保兼容性。

      
        org.apache.ma ven.plugins
        ma ven-compiler-plugin
        3.8.1
        
          11
          11
        
      

    • 可执行 JAR：使用ma ven-jar-plugin在清单文件中指定主类，这样打出来的JAR才能用ja va -jar运行。

      
        org.apache.ma ven.plugins
        ma ven-jar-plugin
        3.2.0
        
          
            
              true
              lib/
              com.example.App
            
          
        
      

    • 依赖外置：把项目依赖的第三方库单独复制到target/lib目录，可以让主JAR包体积更小，更新更灵活。这需要配合上面manifest中设置的classpathPrefix=lib/使用。

      
        org.apache.ma ven.plugins
        ma ven-dependency-plugin
        3.2.0
        
          
            copy-dependencies
            package
            
              copy-dependencies
            
            
              ${project.build.directory}/lib
            
          
        
      

• 配置妥当后，再次运行mvn clean package，就能在target/下得到可执行的JAR。运行它只需：ja va -jar target/你的项目名.jar。

三 使用Gradle打包

Gradle的打包逻辑同样清晰，其配置写在build.gradle文件中，风格更偏向脚本化。

• 在项目根目录执行构建命令：./gradlew clean build（如果系统已全局安装Gradle，也可用gradle clean build）。
  • 打包产物位于build/libs/目录下。
  • 要让JAR可执行，需要在build.gradle中进行一些基本配置：

    plugins {
        id 'ja va'
        id 'application'
    }
    sourceCompatibility = '11'
    mainClassName = 'com.example.App'
    repositories { ma venCentral() }
    dependencies {
        testImplementation 'junit:junit:4.13.2'
    }
    jar {
        manifest {
            attributes 'Main-Class': mainClassName
        }
    }

  • 同样，你也可以实现依赖外置，将运行时依赖库复制到指定目录，便于管理。

    task copyDependencies(type: Copy) {
        from configurations.runtimeClasspath
        into 'build/libs/lib'
    }
    build.dependsOn copyDependencies

• 执行./gradlew build后，使用ja va -jar build/libs/xxx.jar即可运行程序。

四 无构建工具与进阶打包

除了Ma ven和Gradle，还有一些场景需要更直接或更高级的打包方式。

• 手动编译与打包（适合学习或小项目）
  • 这种方式能让你透彻理解JAR包的构成。首先，编译源码：ja vac -d out src/com/example/*.ja va，-d out指定了编译输出目录。
  • 接着，在src目录同级创建一个MANIFEST.MF文件，内容至少包含：

    Manifest-Version: 1.0
    Main-Class: com.example.App

  • 最后，使用jar命令打包：jar cfm my-app.jar MANIFEST.MF -C out .。参数cfm分别表示创建文件、指定清单文件、指定主类入口。
  • 运行：ja va -jar my-app.jar。
• 使用 jpackage 生成平台原生可执行安装包（JDK 14+）
  • 这是Ja va提供的一个强大工具，可以直接生成.exe、.dmg或.deb/.rpm等安装包。一个基本示例：jpackage --type app-image --input target --name myapp --main-class com.example.App --output out。它会创建一个包含应用和精简JRE的镜像。
• 使用 jlink 定制精简运行时（JDK 9+，适用于模块化项目）
  • 如果你的项目是模块化的，可以用jlink裁剪出一个只包含所需模块的JRE，显著减小分发体积。命令示例：jlink --module-path $JA VA_HOME/jmods:mods --add-modules ja va.base,ja va.logging,your.module.name --output custom-jre。
• 使用 Docker 打包发布
  • 容器化部署已成为主流。一个典型的多阶段构建Dockerfile示例如下：

    FROM openjdk:11-jdk-slim AS builder
    WORKDIR /app
    COPY . .
    RUN ./gradlew build
    
    FROM openjdk:11-jre-slim
    WORKDIR /app
    COPY --from=builder /app/build/libs/app.jar /app/app.jar
    EXPOSE 8080
    CMD ["ja va","-jar","/app/app.jar"]

    这个Dockerfile先在一个包含完整JDK的镜像中构建项目，再将生成的JAR文件复制到一个更小的只包含JRE的镜像中运行，兼顾了构建需求与运行镜像的体积。
  • 构建与运行命令：docker build -t myapp . 构建镜像；docker run -p 8080:8080 myapp 运行容器。