将 Quarkus 应用程序编译到原生可执行文件

流程

1. 打开 Getting Started 项目 pom.xml 文件，并验证它是否包含 原生 配置集：

   <profiles>
       <profile>
           <id>native</id>
           <properties>
               <quarkus.package.type>native</quarkus.package.type>
           </properties>
       </profile>
   </profiles>

   注意

   使用 Quarkus 原生 配置集可让您运行原生的可执行文件和原生镜像测试。

2. 使用以下方法之一构建原生可执行文件：

   1. 使用 Docker 构建原生可执行文件：

      ./mvnw package -Pnative -Dquarkus.native.container-build=true

   2. 使用 Podman 构建原生可执行文件：

      ./mvnw package -Pnative -Dquarkus.native.container-build=true -Dquarkus.native.container-runtime=podman

      这些命令 在目标 目录中创建 getting-started-*-runner 二进制文件。

      重要

      将 Quarkus 应用程序编译到原生可执行文件的过程中会占用大量内存。您可以通过设置 quarkus.native-image-xmx 配置属性来限制原生编译过程中使用的内存量。设置低内存限制可能会增加构建时间。如需了解更多详细信息，请参阅 原生可执行文件配置属性。

3. 运行原生可执行文件：

   ./target/getting-started-*-runner

   当您构建原生的可执行程序时，启用了 prod 配置集，并使用 prod 配置集运行 Quarkus 原生测试。您可以使用 quarkus.test.native-image-profile 属性更改它。

流程

1. 打开 pom.xml 文件，再验证 原生 配置集是否包含以下元素：

   <plugin>
       <groupId>org.apache.maven.plugins</groupId>
       <artifactId>maven-failsafe-plugin</artifactId>
       <version>${surefire-plugin.version}</version>
       <executions>
           <execution>
               <goals>
                   <goal>integration-test</goal>
                   <goal>verify</goal>
               </goals>
               <configuration>
                   <systemPropertyVariables>
                       <native.image.path>${project.build.directory}/${project.build.finalName}-runner</native.image.path>
                       <java.util.logging.manager>org.jboss.logmanager.LogManager</java.util.logging.manager>
                       <maven.home>${maven.home}</maven.home>
                   </systemPropertyVariables>
               </configuration>
           </execution>
       </executions>
   </plugin>

   failsafe-maven-plugin 运行集成测试，并指示生成的原生可执行文件的位置。

2. 打开 src/test/java/acme/quickstart/NativeGreetingResourceIT.java 文件，并验证它是否包含以下内容：

   package org.acme.quickstart;
   
   
   import io.quarkus.test.junit.NativeImageTest;
   
   @NativeImageTest 

   1

   
   public class NativeGreetingResourceIT extends GreetingResourceTest { 

   2

   
   
       // Run the same tests
   
   }

   1

   使用另一个从原生文件启动应用的测试运行程序，然后再进行测试。可执行文件通过使用在 Failsafe Maven 插件 中配置的 native.image.path 系统属性来检索。

   2

   这个示例扩展了 GreetingResourceTest，但您也可以创建新的测试。

3. 运行测试：

   ./mvnw verify -Pnative

   以下示例显示了这个命令的输出：

   ./mvnw verify -Pnative
   ...
   [getting-started-1.0-SNAPSHOT-runner:18820]     universe:     587.26 ms
   [getting-started-1.0-SNAPSHOT-runner:18820]      (parse):   2,247.59 ms
   [getting-started-1.0-SNAPSHOT-runner:18820]     (inline):   1,985.70 ms
   [getting-started-1.0-SNAPSHOT-runner:18820]    (compile):  14,922.77 ms
   [getting-started-1.0-SNAPSHOT-runner:18820]      compile:  20,361.28 ms
   [getting-started-1.0-SNAPSHOT-runner:18820]        image:   2,228.30 ms
   [getting-started-1.0-SNAPSHOT-runner:18820]        write:     364.35 ms
   [getting-started-1.0-SNAPSHOT-runner:18820]      [total]:  52,777.76 ms
   [INFO]
   [INFO] --- maven-failsafe-plugin:2.22.1:integration-test (default) @ getting-started ---
   [INFO]
   [INFO] -------------------------------------------------------
   [INFO]  T E S T S
   [INFO] -------------------------------------------------------
   [INFO] Running org.acme.quickstart.NativeGreetingResourceIT
   Executing [/data/home/gsmet/git/quarkus-quickstarts/getting-started/target/getting-started-1.0-SNAPSHOT-runner, -Dquarkus.http.port=8081, -Dtest.url=http://localhost:8081, -Dquarkus.log.file.path=build/quarkus.log]
   2019-04-15 11:33:20,348 INFO  [io.quarkus] (main) Quarkus 999-SNAPSHOT started in 0.002s. Listening on: http://[::]:8081
   2019-04-15 11:33:20,348 INFO  [io.quarkus] (main) Installed features: [cdi, resteasy]
   [INFO] Tests run: 2, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 1.387 s - in org.acme.quickstart.NativeGreetingResourceIT
   ...

   注意

   Quarkus 等待 60 秒，让原生镜像在自动进行原生测试前启动。您可以使用 quarkus.test.native-image-wait-time 系统属性更改这个持续时间。

   您可以使用以下命令扩展等待时间，其中 < duration&gt; 是等待时间（以秒为单位）：

   ./mvnw verify -Pnative -Dquarkus.test.native-image-wait-time=<duration>