- 修复 RK3288 真机 reLaunch 白屏: 新页面 WebView 视口 0×0 导致 CSS vw/vh 归零, renderjs 检测并强制原生重排自愈(公共逻辑 src/render-common/viewport-fix.js) - 移除打包页无效的 lockLandscape(锁屏由 manifest 全局配置承担, setStyle 曾触发 native NPE) - 新增 dev:adb 真机调试热更新脚本: 设备选择/文件监听自动构建重装/真机 console 实时打印 - console 转发 logcat: main.js 接管 uni.__log__ 与 console(UniConsole), 视图层 renderjs 转发(UniViewConsole) - Android 离线包: appid 切换为散单 __UNI__900BDC1 复用其 appKey; prepare.cjs 对齐 compilerVersion 消除版本不一致弹窗 - 新增开机自启 BootReceiver(BOOT_COMPLETED + QUICKBOOT_POWERON) - 启动时将系统音量调至最大(App.vue) - 文档: README 记录白屏踩坑与 dev:adb 用法
config 目录统一说明
本目录存放项目配置文件。含敏感信息的配置一律不提交 git,配套的 *.example.* 模板提交,新克隆后按模板复制填写即可。
本目录
| 文件 | 说明 | git |
|---|---|---|
android.json |
Android 离线打包本地配置(包名、签名密码、AppKey 等) | ❌ 不提交(敏感) |
android.example.json |
上述配置的模板,首次使用复制为 android.json |
✅ 提交 |
deploy.json |
发布配置(服务器 IP/账号/SSH 密钥路径/上传目录,分 android/windows 两段) | ❌ 不提交 |
deploy.example.json |
发布配置模板,首次使用复制为 deploy.json |
✅ 提交 |
android.json 字段说明:appId(uni-app appid)、appKey(dev.dcloud.net.cn 申请)、appName(应用名)、packageName(Android 包名)、abis(CPU 架构)、icon/splash(图标启动图路径,相对项目根)、wwwSource(可选:指定 App 资源目录,留空则自动用 dist/build/app 或 unpackage/resources)、signing(keystore 路径/密码)。
⚠️ appKey 必须与 appId 严格匹配,留空或填其他应用的 key 时,APK 启动会白屏提示“未配置appkey或配置错误”(5+ Runtime 启动校验)。本应用与散单项目共用包名/签名/appid(
__UNI__900BDC1),因此直接复用散单已申请的离线打包 Key,无需再申请。若日后更换 appid/证书/包名,需到 https://dev.dcloud.net.cn → 应用详情 → Android → 离线打包 Key 管理重新申请(需填包名与证书 SHA-256 指纹)。
deploy.json 字段说明:android 段(APK 发布,android:pack 打包后自动 scp 上传)与 windows 段(exe 发布,build:exe 打包后自动 scp 上传),每段含 host(服务器 IP)、port(SSH 端口)、user(SSH 用户)、keyPath(SSH 私钥路径)、remoteDir(服务器上传目录:APK 与散单项目同为 worker_station,exe 为 worker_station_windows)、downloadUrlPrefix(下载 URL 前缀)、latestJsonName(latest.json 文件名)。跳过上传:-NoUpload(APK)/ --no-upload(exe)。
根目录其他配置
| 文件 | 说明 | git |
|---|---|---|
.env / .env.electron |
Vite 构建目标(web/electron),无敏感信息 | ✅ 提交 |
.env.example |
环境变量模板(接口地址等),复制为 .env.local 填写 |
✅ 提交 |
.env.local |
本地开发环境变量(含内网测试接口地址,勿提交;仅 dev 生效,生产构建固定走 https://qimen.wms.gztbyc.com,见 env.js) |
❌ 不提交(匹配 *.local) |
env.js |
前端环境模块(读 Vite 环境变量,不写死敏感地址) | ✅ 提交 |
electron-builder.config.cjs |
exe 打包配置(无敏感) | ✅ 提交 |
其他敏感/忽略位置
| 位置 | 说明 |
|---|---|
android-offline/keystore/ |
签名密钥文件,整个目录不提交 |
android-offline/HBuilder-Integrate-AS/ |
已提交 git(保证发布基座一致)。工程内不写死任何密码:包名/版本/签名/应用名/appid/appKey 均由 simpleDemo/build.gradle 在构建时动态读取 config/android.json 与 package.json;仅排除 local.properties、.gradle/、build/ 等本地产物 |
release/、dist/ |
打包产物,不提交 |
info/basicinfo.txt |
曾含接口返回的账号/IP 数据,已删除;注意 git 历史中仍存在,如有需要可清理历史 |
新机器初始化清单
cp config/android.example.json config/android.json并填写(签名密钥放入android-offline/keystore/)cp config/deploy.example.json config/deploy.json并填写(仅发布 APK 时需要)cp .env.example .env.local并填写接口地址npm install- 打包:
npm run build:exe(Windows,发布到 worker_station_windows)、npm run android:pack(Android,发布到 worker_station)