no message

2026-06-12 22:23:47 +08:00
parent 8dacaea803
commit 7381097582
4 changed files with 338 additions and 62 deletions
@@ -137,17 +137,23 @@ cd D:\www\sport-era
 powershell -ExecutionPolicy Bypass -File .\scripts\deploy-server.ps1 -Sudo -RemoteDir /www/wwwroot/test-server.sbnews.net
 ```

-全量模式默认只打包以下目录：
+全量模式默认以仓库根目录为源，只打包以下三个子目录：

 ```text
-server/app
-server/config
-server/extend
-server/public/dongqiudi-crawler
-server/route
+server/
+uniapp/
+admin/
 ```

-默认会排除运行态或较大目录，例如 `.env`、`vendor`、`runtime`、`public/uploads`、`public/admin`、`public/mobile`、爬虫 `data/logs/venv`。如确实需要包含，可追加参数：
+也就是说，远端 `RemoteDir` 下最终会形成：
+
+```text
+<RemoteDir>/server
+<RemoteDir>/uniapp
+<RemoteDir>/admin
+```
+
+默认会排除运行态或较大目录，例如 `server/.env`、`server/vendor`、`server/runtime`、`server/public/uploads`、`server/public/admin`、`server/public/mobile`、爬虫 `data/logs/venv`，以及 `uniapp/node_modules`、`uniapp/dist`、`admin/node_modules`、`admin/dist`。如确实需要包含，可追加参数：

 ```bash
 --include-env
@@ -197,11 +203,11 @@ cd D:\www\sport-era
 powershell -ExecutionPolicy Bypass -File .\scripts\deploy-server.ps1 -AutoIncremental -RemoteDir /www/wwwroot/test-server.sbnews.net -DryRun
 ```

-脚本会在打包和上传前先检查 `server` 工作区；如果 `server` 内存在未提交、删除或未跟踪文件，会先自动提交这些变更，再继续计算增量范围。可以通过 `-AutoCommitMessage "提交说明"` 自定义这次自动提交的说明。若存在合并冲突，需要先手动解决。
+脚本会在打包和上传前先检查默认打包范围（`server` + `uniapp` + `admin`）；如果这些目录内存在未提交、删除或未跟踪文件，会先自动提交这些变更，再继续计算增量范围。可以通过 `-AutoCommitMessage "提交说明"` 自定义这次自动提交的说明。若存在合并冲突，需要先手动解决。

 注意：自动增量只包含指定提交范围内已经提交到 Git 的差异，不会包含工作区未提交文件。需要指定任意起止提交时，继续使用 `-From <old_commit> -To <new_commit>`。

-如果当前根目录 Git 只把 `server` 记录为 gitlink/submodule，且本机没有 `server/.git` 子仓库元数据，脚本无法拿到 `server` 内部的文件级差异；此时会自动降级为打包当前工作区默认的 5 个 server 目录，保证可以继续发布。
+如果当前根目录 Git 只把 `server`、`uniapp` 或 `admin` 记录为 gitlink/submodule，脚本无法拿到对应目录内部的文件级差异；此时会把该目录从当前工作区按源码目录补进增量包，保证可以继续发布。

 ### 只演练不上传

@@ -225,14 +231,34 @@ cd D:\www\sport-era
 powershell -ExecutionPolicy Bypass -File .\scripts\deploy-server.ps1 -Sudo -RemoteDir /www/wwwroot/test-server.sbnews.net -PostInstall "php think optimize:clear"
 ```

+### 发布 uniapp 源码到服务器并在服务器构建
+
+默认发布命令会把 `server/`、`uniapp/` 和 `admin/` 一起同步到远端根目录；如果需要在服务器端构建 `uniapp`，建议在远端根目录执行构建，再把 H5 产物写回同一套代码下的 `server/public/mobile`：
+
+```powershell
+cd D:\www\sport-era
+powershell -ExecutionPolicy Bypass -File .\scripts\deploy-server.ps1 `
+  -Sudo `
+  -RemoteDir /www/wwwroot/test-server.sbnews.net `
+  -UniappReleasePath ../server/public/mobile `
+  -PostInstall "cd uniapp && npm install && npm run build:h5"
+```
+
+说明：
+
+- `-RemoteDir` 指向服务器上的项目根目录，解压后里面会同时有 `server/`、`uniapp/` 和 `admin/`。
+- `-UniappReleasePath` 会通过环境变量 `UNIAPP_RELEASE_PATH` 传给 `uniapp/scripts/release.mjs`；这里传 `../server/public/mobile`，是因为构建命令会先 `cd uniapp`，再把 H5 产物回写到兄弟目录 `server/public/mobile`。
+- 服务器需要预先安装 `node >= 18.19.0` 和 `npm`，否则 `npm install` / `npm run build:h5` 无法执行。
+
 ### 常见问题

 1. `ssh: Could not resolve hostname sbnews`：检查 Windows 的 `C:\Users\Administrator\.ssh\config` 是否存在 `Host sbnews`，或直接用 `-HostName <服务器IP>`。
 2. PowerShell 禁止执行脚本：使用示例中的 `-ExecutionPolicy Bypass -File`，或以管理员身份调整当前用户执行策略。
 3. `tar: Cannot utime` 或 `Cannot change mode`：远端目录权限不足，请加 `-Sudo`。脚本会使用 `sudo tar` 覆盖解压，并默认跳过还原 owner/permission，减少权限冲突。
 4. 增量发布提示 commit 无效：确认 commit id 属于当前根目录 Git 可识别的历史。
-5. `server is tracked as a root gitlink`：脚本检测到根 Git 只记录了 `server` 指针，无法做文件级增量，会自动改为打包当前工作区默认 5 个 server 目录。
+5. `root gitlink include paths will be copied from working tree`：脚本检测到默认发布范围里仍有 gitlink/submodule 目录，会把这些目录从当前工作区源码补进增量包。
 6. 仍需使用 Bash 兼容版时，可继续运行 `bash ./scripts/deploy-server.sh ...`。
+7. 服务器运行 `uniapp` 报 `node: command not found` 或 `npm: command not found`：先在服务器安装 Node.js 18.19+ 与 npm，再执行 `-SourceDir uniapp` 的发布命令。

 <a href="https://www.likeshop.cn">![likeshop全开源商城](https://server.likeshop.cn/uploads/gitad/fastbuildAI.png)</a><br>
 <a href="https://www.likeshop.cn">![likeshop全开源商城](https://server.likeshop.cn/uploads/gitad/likeshop.png)</a><br>