xsl
9503c6e259
- 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 构建门禁命令与代码约定
27 lines
1.7 KiB
Markdown
27 lines
1.7 KiB
Markdown
# 美搭 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 包（保持零依赖，后续按需评估）
|