真机首验即中:loginByDevToken 走了带鉴权的 post(),而 ApiClient 对 未登录一律 40100 短路——登录接口被自己的守卫拦死,UI 表现为 「请先登录」且无解。改走既有 postWithoutAuth。编译门禁无法发现 此类运行时逻辑环,真机验证首个战果。
美搭 HarmonyOS App(ArkTS)
- 模板:DevEco Studio 6.1 空 Ability 工程;API
6.1.1(24),runtimeOS: HarmonyOS,bundleName: com.xiangsilian.app - 后端:
meida_backend(WSL)。本地开发默认http://127.0.0.1:8000(模拟器可用;真机连开发机要在登录页改成局域网 IP) - 登录通道(V1 骨架):dev-token(后端
DEV_AUTH_ENABLED=true本地可用);华为账号/短信为后续任务
命令行构建(Agent/CI 用的门禁)
cd G:/meida/app
export DEVECO_SDK_HOME="C:/Program Files/Huawei/DevEco Studio/sdk"
"C:/Program Files/Huawei/DevEco Studio/tools/node/node.exe" \
"C:/Program Files/Huawei/DevEco Studio/tools/hvigor/bin/hvigorw.js" \
--mode module -p module=entry@default assembleHap --analyze=false --daemon=false
BUILD SUCCESSFUL 即门禁通过(未签名 HAP 正常——签名等 AGC 证书)。运行/调试用 DevEco Studio 打开本工程点 Run(模拟器或真机,真机需先配签名)。
代码约定
ets/core/:网络与会话地基(ApiClient/AuthStore/ContextHolder/ApiTypes)——共享层,改动需全量构建验证ets/pages/:页面。页面间跳转一律router.pushUrl({url: 'pages/Xxx'})路径方式,禁止 import 其它页面(并行开发的冲突隔离约定)- 组件级复用放
ets/components/(各自任务目录内自建子目录) - 文案:骨架期中文硬编码即可(i18n 后置);错误提示只 catch
ApiError,用其message/hint(后端文案已保证无价格字样) - 状态管理:页面内
@State;跨页少量状态走AppStorage - 不引第三方 ohpm 包(保持零依赖,后续按需评估)