feat(app): FE 骨架协调提交——core 网络层/路由注册/页面桩

- DevEco 6.1 模板工程(API 6.1.1(24),bundle com.xiangsilian.app)+ INTERNET 权限
- core/:ApiClient(统一信封解包+401 自动刷新重试)/AuthStore(双令牌持久化+
  dev-token 通道+baseUrl 可配)/ContextHolder/ApiTypes —— 全部通过 ArkTS 严格编译
- 七页面注册 main_pages(桩态);Index 按登录态分流;页面间约定 router 路径跳转
  零 import(并行冲突隔离)
- app/README:CLI 构建门禁命令与代码约定
This commit is contained in:
xsl
2026-08-15 00:33:55 +08:00
parent 26357756e2
commit 9503c6e259
48 changed files with 994 additions and 0 deletions
+26
View File
@@ -0,0 +1,26 @@
# 美搭 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 用的门禁)
```bash
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 包(保持零依赖,后续按需评估)