# 美搭 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 包（保持零依赖，后续按需评估）