Docker 安装
本节文档将介绍希望使用 Docker 开发的用户所需的步骤。您将在开发机器上对代码进行更改，生成的应用将运行在 Docker 中。
1. 下载 Docker
Docker 的安装过程在 Windows、Mac 和 Linux 用户之间略有不同。请参见下面与您的操作系统相对应的部分。
Windows
建议下载最新版本的 Windows 子系统 Linux。更多信息请访问 此链接
1. 下载 Docker Desktop:
- 访问 Windows Docker Desktop 下载页面：Docker Desktop for Windows
- 单击“获取 Docker Desktop for Windows”按钮下载安装程序。
2. 安装 Docker Desktop:
- 运行您下载的安装程序。
- 按照安装向导的指示进行操作，并确保在提示时启用 Hyper-V，因为 Windows 版 Docker 使用 Hyper-V 进行虚拟化。
- 安装完成后，Docker Desktop 将自动启动。
3. 验证安装:
- 打开终端并运行命令
docker --version以验证 Docker 是否已正确安装和运行。
Mac
1. 下载 Docker Desktop:
- 访问 Mac Docker Desktop 下载页面：Docker Desktop for Mac
2. 安装 Docker Desktop:
- 运行您下载的安装程序。
- 安装完成后，Docker Desktop 将自动启动。
3. 验证安装:
- 打开终端并运行命令
docker --version以验证 Docker 是否已正确安装和运行。
2. 配置
下载 Docker Desktop 后，搜索当前名为 webforj/sandbox 的最新 webforJ 镜像。
单击标签列表以查看可用选项
对于最新的构建，选择“rc”
拉取镜像以启动您的容器
下载完成后，单击运行按钮，将打开配置设置
打开“可选设置”菜单
选择一个希望在 Docker 中运行您的应用的主机端口
单击“运行”以启动容器
请务必记下您提供的自定义主机端口号，因为稍后将需要该信息。
3. 运行您的应用
容器创建后，可以在容器内运行 webforJ 应用，而不是在本地。首先，需要正确配置项目的 POM 文件。完成此操作后，在浏览器中访问特定 URL 将显示应用。
配置您的 POM 文件
在 Docker 容器中运行 webforJ 项目将需要使用 webforJ 安装插件，可以通过您的 POM 文件进行配置：
在 POM 的 <plugins> 部分创建一个新的 <plugin> 条目。以下代码显示了一个可以使用并根据项目需要进行调整的初始条目：
如果您的 POM 文件中没有 <plugins> 部分，请创建一个。
<plugin>
<groupId>com.webforj</groupId>
<artifactId>webforj-install-maven-plugin</artifactId>
<version>${webforj.version}</version>
<executions>
<execution>
<goals>
<goal>install</goal>
</goals>
</execution>
</executions>
<configuration>
<deployurl>http://localhost:8888/webforj-install</deployurl>
<classname>samples.HelloWorldApp</classname>
<publishname>hello-world</publishname>
<debug>true</debug>
</configuration>
</plugin>
创建类似于上述条目后，自定义以下信息：
-
将
<deployurl>条目更改为使用您在上一步中为容器配置的 主机端口 的端口号。 -
确保
<classname>条目与您要运行的应用名称匹配。 -
如果您安装 BBj 使用的
<username>和<password>凭据不同，请进行更改。
使用启动项目
要创建和搭建新的bbj-hello-world项目，请按照以下步骤操作：
- 导航到正确的目录: 打开终端并移动到您想要创建新项目的文件夹。
- 运行archetype:generate命令: 使用下面的Maven命令，并根据您的项目需要自定义groupId、artifactId和version。
- Bash/Zsh
- PowerShell
- Command Prompt
mvn -B archetype:generate \
-DarchetypeGroupId=com.webforj \
-DarchetypeArtifactId=webforj-archetype-bbj-hello-world \
-DarchetypeVersion=LATEST \
-DgroupId=org.example \
-DartifactId=my-app \
-Dversion=1.0-SNAPSHOT \
-DappName=MyApp
mvn -B archetype:generate `
-DarchetypeGroupId="com.webforj" `
-DarchetypeArtifactId="webforj-archetype-bbj-hello-world" `
-DarchetypeVersion="LATEST" `
-DgroupId="org.example" `
-DartifactId="my-app" `
-Dversion="1.0-SNAPSHOT" " `
-DappName="MyApp"
mvn -B archetype:generate ^
-DarchetypeGroupId="com.webforj" ^
-DarchetypeArtifactId="webforj-archetype-bbj-hello-world" ^
-DarchetypeVersion="LATEST" ^
-DgroupId="org.example" ^
-DartifactId="my-app" ^
-Dversion="1.0-SNAPSHOT" " ^
-DappName="MyApp"
| 参数 | 说明 |
|---|---|
archetypeGroupId | 原型的组ID是com.webforj用于webforJ原型。 |
archetypeArtifactId | 指定要使用的原型名称。 |
archetypeVersion | 指定要使用的原型版本。这确保生成的项目与特定的原型版本兼容。使用LATEST选择最新的可用版本。 |
groupId | 代表生成项目的命名空间。通常像Java包一样构造，例如org.example，用于唯一标识您的组织或项目域。 |
artifactId | 指定生成项目的名称。这将是结果工件和项目文件夹的名称。 |
version | 定义生成项目的版本。常见约定是MAJOR.MINOR-SNAPSHOT，如1.0-SNAPSHOT，其中SNAPSHOT表示项目仍在开发中。 |
appName | 可以在生成项目的POM文件中使用的可选参数。根据使用的webforJ原型，它可以用作应用程序的默认标题。 |
运行命令后，Maven将生成运行项目所需的项目文件。
启动应用
完成后，在您的项目目录中运行 mvn install。这将运行 webforJ 安装插件，并允许您访问您的应用。要查看应用，您需要访问以下 URL：
http://localhost:YourHostPort/webapp/YourPublishName
将 YourHostPort 替换为您在 Docker 中配置的主机端口，将 YourPublishName 替换为 POM 的 <publishname> 标签中的文本。如果操作正确，您应该会看到您的应用渲染。