# 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-07-26

## 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`（命令会自动启动 Vite）

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

- App / Web 网络访问约束（IP & 协议 & CORS）：`docs/networking.md`
- iOS 真机 Live Reload 请求链路：`docs/ios-live-reload-networking.md`

### 开发期登录

- 默认对接 ant-admin 后端：
  - Web / iOS live reload：`.env.development` 使用 `VITE_API_BASE_URL=/baselineos`，由 Vite 代理 `/baselineos/api` 到 `VITE_API_PROXY_TARGET`。真机开发时代理目标应使用 Mac/后端可达的局域网地址，例如 `http://192.168.1.3:2082`。
  - 发送验证码接口：`/api/user/send-login-sms-code`（实际请求 `/baselineos/api/user/send-login-sms-code`）
  - 登录接口：`/api/auth/login`（实际请求 `/baselineos/api/auth/login`）
- 本项目不保留本地模拟登录；验证码、登录、刷新、用户信息与上传接口都必须走真实后端。

### 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`，不会被提交。