# mobile-template

**Repository Path**: aurora-engine/mobile-template

## Basic Information

- **Project Name**: mobile-template
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-12
- **Last Updated**: 2026-04-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 手机端模版

基于现有 `virtual-human` 项目复制出的移动端模板工程。

## Created with Capacitor Create App

This app was created using [`@capacitor/create-app`](https://github.com/ionic-team/create-capacitor-app),
and comes with a very minimal shell for building an app.

### Dev (Vite)

- Web: `pnpm start`
- iOS (live reload): `pnpm ios:live`（需先启动 `pnpm start`，再执行）

### Networking（环境切换注意事项）

- App / Web 网络访问约束（IP & 协议 & CORS）：`docs/networking.md`

### 开发期登录 Mock

- `.env.development` 和 `.env.sandbox` 已开启 `VITE_ENABLE_AUTH_MOCK=true`。
- 启用后，登录相关接口会在请求层直接返回 mock 数据，不依赖真实后端：
  - `/api/user/send-login-sms-code`
  - `/api/user/login`
  - `/api/user/refresh-token`
  - `/api/user/logout`
  - `/api/user/info`
  - `/api/user/profile`
  - `/api/user/avatar`
- Mock 登录下，验证码不校验真实短信内容，输入任意 4 位及以上数字即可登录。
- 后续接入真实后端时，只需要在目标环境关闭 `VITE_ENABLE_AUTH_MOCK`，保留现有 `auth-service` 调用即可。

### iOS 打包（产出 IPA）

> 说明：打包产物只加载本地 `dist/`，不走 live reload；用于真机验证/分发测试包。

- Sandbox 环境（`.env.sandbox`，开发调试可安装包）：
  - `pnpm ios:ipa:sandbox`
- Sandbox 环境（AdHoc/内测包，需对应证书/描述文件）：
  - `pnpm ios:ipa:sandbox:adhoc`
- Production 环境（AdHoc/内测包，需对应证书/描述文件）：
  - `pnpm ios:ipa:prod`
- Production 环境（App Store Connect 导出，用于 TestFlight/上架）：
  - `pnpm ios:ipa:prod:appstore`

产物位置：`ios/App/output/package/<mode>/<timestamp>/export/*.ipa`

可选环境变量（签名相关）：
- `IOS_TEAM_ID`：指定 `DEVELOPMENT_TEAM`
- `IOS_ALLOW_PROVISIONING_UPDATES=false`：禁用 `-allowProvisioningUpdates`
- 手动签名：`IOS_PROVISIONING_PROFILE` + `IOS_SIGNING_CERTIFICATE` 并在命令后加 `--signing-style manual`

### iOS 团队签名（本地配置）

- 仓库不再写死个人 `DEVELOPMENT_TEAM`。
- 首次在本机运行 iOS 时，复制 `ios/signing.local.xcconfig.example` 为 `ios/signing.local.xcconfig`，并填入自己的 Team ID：
  - `APP_DEVELOPMENT_TEAM = <YOUR_TEAM_ID>`
- `ios/signing.local.xcconfig` 已加入 `.gitignore`，不会被提交。