中国 帮助

快速开始

在开发机上从空库走到「装上第一个应用」:建库、起后端、起前端、登录、验收。

快速开始
封面

> 本文整理自平台文档 docs/wujies/5.x/introduction/quickstart.mdx,用于站点内容演示。

(https://console.wujies.cn/remote-apps/cms-assets/doc-d84fdf2b9603-cover.svg)

这一页只有一条主线:把平台跑起来,装上一个应用,并确认它真的在跑。按顺序做完大约二十分钟,每一步都给验收点,做到哪一步现象不对就停在那一步排查,别继续往下堆。

不讲怎么写应用(见 [插件开发](/docs/wujies/5.x/platform/plugin))、怎么打包上架(见 [发布应用包](/docs/wujies/5.x/platform/package/publish))、怎么上生产(见 [后端部署](/docs/wujies/5.x/deploy/backend))。动手前先过一遍 [环境要求](/docs/wujies/5.x/introduction/prerequisites):JDK 17+、Node 22+、本机有 MySQL 与 Redis。

0. 先认清三个目录

后面每条命令都要知道自己在哪个目录里跑。

目录是什么构建方式
wujies-platform/后端宿主、平台 SQL、部署物料Maven
wujies-admin/宿主前端(Vue 3 + Vite),旧名 plus-uinpm
plugins/wujies-<code>-plugin/一个应用一个仓库:后端 + 自己的 frontend/ + 打包脚本Maven + npm

三者没有共同的 git 根,各自提交。wujies-admin 这个名字在后端也有一个同名启动模块(wujies-platform/wujies-admin/),判据是看有没有 pom.xml:有就是后端,有 vite.config.ts 就是前端。

1. 建库并导入 SQL

建一个空库(下面按库名 wujies 写),按这个顺序导三份脚本:

mysql -h 127.0.0.1 -u root -p -e "CREATE DATABASE wujies CHARACTER SET utf8mb4;"
mysql -h 127.0.0.1 -u root -p wujies < wujies-platform/script/sql/platform_init.sql
mysql -h 127.0.0.1 -u root -p wujies < wujies-platform/script/sql/app_market_schema.sql

顺序不能颠倒:platform_init.sql 是平台全部 sys_* 表(26 张)加种子数据(含租户 000000、默认管理员、sys_client),app_market_schema.sql 建的是应用市场自己的 app_* 表,它引用的菜单父节点在前一份里。两份都是 CREATE TABLE IF NOT EXISTS,重复执行没有副作用。

script/sql/job.sql 只在你要跑 SnailJob 分布式调度时才导,单机开发可以先不导,但要把 application-dev.yml 里的 snail-job.enabled 改成 false,否则启动时连不上调度中心会刷一屏重试日志。

script/sql/update/ 下那几份是给存量库补结构的增量脚本,全新库不要执行,导了也只是重复建同样的行。

验收:

mysql -h 127.0.0.1 -u root -p wujies -e "select count(*) from sys_menu; show tables like 'app_%';"

菜单有几百行、app_info / app_version / app_install 都在,才算成功。

2. 起后端

本机开发用 dev 这个 profile:它的库、Redis、消息队列默认全部指 127.0.0.1(application-dev.yml),不用配任何环境变量。

打包并启动(工作目录必须是 wujies-platform/,落位路径按进程工作目录解析):

cd wujies-platform
mvn -pl wujies-admin -am -B package -DskipTests
java "-Dspring.profiles.active=dev" "-Dloader.path=plugins-dist" -jar wujies-admin/target/wujies-admin.jar

在 IDEA 里直跑启动类也行,记得把 Run Configuration 的 Working directory 设成 wujies-platform/,VM options 加 -Dspring.profiles.active=dev。IDEA 直跑读的是 target/classes,改了插件代码要 reload 才生效;判断某次改动到底加载没有,比一下 JVM 启动时间与那个 .class 文件的修改时间。

prod profile 留给真部署:它的连接串是 ${WUJIES_DB_HOST} 这类没有默认值的占位,缺哪个就直接 Could not resolve placeholder 起不来,这是刻意的(见 [部署与配置](/docs/wujies/5.x/deploy/configuration))。别拿 prod 当本机默认。

-Dloader.path 指的是插件 jar 的落位目录,加载器只认这个目录根下的 jar,不递归子目录。开发期还没打过包就先不给这个参数,插件走「插件开发」那套热加载。

验收点,启动日志里找到这两行:

[deploy] plugin-dir  = <绝对路径>
[deploy] frontend-dir = <绝对路径>

路径指向你以为的那个目录才算对;目录不存在它还会多打一条 WARN。接着浏览器打开 http://127.0.0.1:8086/app/runtime/enabled-apps,返回一个 JSON 数组(空数组也正常),说明后端通了。

3. 起前端

cd wujies-admin
npm install
npm run dev

监听在 http://localhost:80,接口前缀 /dev-api 代理到 127.0.0.1:8086(vite.config.ts)。/site 也代理过去,并且 changeOrigin 必须是 false:改写 Host 会让后台直出的前台页把登录地址算成另一个 origin,登录态按 origin 隔离,于是前台永远显示未登录。

登录后进工作台,页面能取到字典与菜单,就说明前后端联通了。

4. 登录

种子数据里的超管账号是 admin / admin123,租户号 000000。这套默认口令只给开发用,任何对外实例第一件事就是改掉它,并去「参数设置 → 登录配置」把 captcha.enabled 打开(种子值是 false,即登录不要验证码,方便 curl 验接口)。

被验证码挡住时看的是后端那条 captcha.enabled,不是前端;改完不用重启,参数缓存会失效。

5. 装上第一个应用

最快的路径不需要中心、不需要市场:把仓库打成包,用开发台直接装本机。

1. 在 plugins/wujies-hello-plugin/ 根执行 powershell -NoProfile -ExecutionPolicy Bypass -File package.ps1 -Dev,产物落在 plugins/../.plugin-dist/hello/dev。开发包不签名,正好避开本机没有公钥的问题。 2. 管理端进「开发工具 → 插件开发」,那一行点「本地安装」,填 zip 的磁盘绝对路径(接口是 POST /app/dev/install,请求体 {"code":"hello","zipPath":"...","watch":false})。这条通道靠 app-market.plugin-runtime.dev-mode: true 开着才允许;正式分发才走上架中心。 3. 装完去「我的应用 → 应用任务」看那条任务,四步依次是从市场拉包、执行迁移、校验后端产物、同步菜单与授权。任一阶段红了就点开看日志,别猜。

验收:

curl -s http://127.0.0.1:8086/app/runtime/enabled-apps

数组里出现 "hello"。这时侧栏还没有那个菜单是正常的,菜单树在登录时生成一次,走「重建菜单」或者重新登录。

判断插件后端真加载了:调它一个接口。应用没在跑时返回的 HTTP 是 404,但 body 里业务码是 4610,话术会区分「已停用 / 未安装 / 已启用但产物未加载」,最后一句说明落位目录里没有那个 jar。

6. 开发自己的应用

想改代码而不是一遍遍打包,用「开发工具 → 插件开发」那一屏:

  • 「启动后端」编译并把 target/classes 挂进插件运行时,同时开启监听;
  • 「启动前端」常驻 vite build --watch,保存源码即重建,刷新页面生效(没有 HMR);
  • 全流程与约束见 [插件开发](/docs/wujies/5.x/platform/plugin) 与 [本地开发](/docs/wujies/5.x/platform/plugin/backend/local-dev)。

宿主前端有四个检查脚本

本文导览

(https://console.wujies.cn/remote-apps/cms-assets/doc-d84fdf2b9603-guide.svg)

章节导览
THE END

喜欢就支持以下吧

评论区需要浏览器启用 JavaScript 才能加载。

回到内容