# plan-uniapp

**Repository Path**: fenghaiju/plan-uniapp

## Basic Information

- **Project Name**: plan-uniapp
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-30
- **Last Updated**: 2026-07-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 彩虹督学 - uni-app 客户端

基于 uni-app 框架，将 `https://plan.ai-stand.com/` 打包为 iOS、安卓、鸿蒙三端原生 App。

## 项目结构

```
plan-uniapp/
├── App.vue              # 应用入口
├── main.js              # 主入口
├── manifest.json        # 三端配置（App名称、权限、图标）
├── pages.json           # 页面路由与导航配置
├── uni.scss             # 全局样式变量
├── jsconfig.json        # 路径别名配置
├── package.json         # 依赖管理
├── static/
│   └── logo.svg         # 应用图标（需替换为png）
└── pages/
    ├── index/index.vue  # 首页：web-view加载目标网址
    ├── offline/offline.vue  # 网络异常兜底页
    └── about/about.vue  # 关于页（含隐私政策入口）
```

## 打包流程（HBuilderX 云打包）

uni-app 的 App 端打包必须通过 HBuilderX，以下是完整步骤：

### 第1步：安装 HBuilderX
下载地址：https://www.dcloud.io/hbuilderx.html
选择「App开发版」（内置 uni-app 编译器和云打包功能）。

### 第2步：导入项目
1. 打开 HBuilderX
2. 文件 → 导入 → 从本地导入
3. 选择本目录 `plan-uniapp`
4. HBuilderX 会自动识别为 uni-app 项目

### 第3步：运行调试（可选）
- 菜单 运行 → 运行到手机或模拟器 → 可连接真机调试
- 需先安装对应平台模拟器或开启真机USB调试

### 第4步：云打包生成安装包
1. 菜单 发行 → 原生App-云打包
2. 各平台配置：

#### 安卓打包
- 安卓证书：需先生成签名证书（keystore）
  - 命令：`keytool -genkey -alias caihong -keyalg RSA -keysize 2048 -validity 36500 -keystore caihong.keystore`
  - 在云打包界面上传该 keystore 并填写别名/密码
- 打包类型：安装包（apk）
- ABI：勾选 armeabi-v7a、arm64-v8a（x86可选）

#### iOS 打包
- 需要 Apple 开发者账号（$99/年）
- 在 Apple Developer 后台创建 App ID、证书、Profile
- 云打包界面填写：
  - Bundle ID（如 com.ai-stand.caihongdx）
  - 上传 .p12 证书和 .mobileprovision 描述文件
- 打包类型：
  - ipa（开发包，用于测试）
  - ipa（正式包，用于上架 App Store）

#### 鸿蒙打包
- uni-app 从 HBuilderX 3.8+ 开始支持鸿蒙（HarmonyOS）打包
- 需在 manifest.json 的 `app-harmony` 节点配置
- 云打包时选择鸿蒙即可
- 注意：鸿蒙应用上架华为应用市场需鸿蒙签名证书

### 第5步：上架各应用市场

#### App Store（iOS）
1. 使用 Application Loader 或 Transporter 将 ipa 上传到 App Store Connect
2. 在 App Store Connect 创建应用，填写信息
3. 提交审核（通常1-3天）
4. **注意事项**：
   - App Store 对纯 WebView 套壳审核严格，本应用已增加「关于页」「原生导航」「离线兜底」以增强原生特征
   - 建议在审核时说明「应用加载的是开发者自有业务网站」
   - 必须提供可访问的隐私政策 URL
   - 不能强制登录才能使用核心功能

#### 安卓应用市场（华为/小米/OPPO/vivo/应用宝等）
1. 各市场开发者后台注册账号（多数需企业资质）
2. 提交应用信息、截图、安装包
3. 各市场审核周期 1-3 天
4. **通用要求**：
   - 包名一致性：安装包包名需与市场一致
   - 签名一致：同一应用在所有市场必须使用同一签名证书
   - 64位支持：必须提供 arm64-v8a 架构

#### 华为应用市场（鸿蒙）
1. 在华为开发者联盟注册
2. HarmonyOS 应用需单独提交，格式为 .app 文件（鸿蒙原生包）
3. 或在云打包时选择鸿蒙平台，生成对应安装包后上传

## 常见问题

### 1. WebView 白屏 / 加载失败
- 检查手机网络
- 检查 https 证书是否有效
- Android 9+ 需在 manifest.json 配置 `android:usesCleartextTraffic`（本站为 https 无需处理）

### 2. web-view 无法上传图片/相机
- HBuilderX 的 web-view 已注入原生能力，但部分需额外配置
- 参考：https://uniapp.dcloud.io/component/web-view.html

### 3. 上架被拒「内容太简单」
- 纯网页套壳在 iOS 容易被拒 4.2 规则
- 建议保留并强化「关于页」「设置页」等原生页面
- 或在网站内集成部分原生能力调用（拍照、扫码、分享）

## 关键配置说明

- **目标网址**：`pages/index/index.vue` 顶部的 `TARGET_URL` 常量
- **App 名称**：`manifest.json` 的 `name` 字段
- **隐私政策**：需准备真实可访问的隐私政策URL，当前占位为 https://plan.ai-stand.com/privacy

## 证书与签名

**重要**：生成 keystore 后请妥善保管，证书丢失将无法更新应用。

```bash
# 生成安卓签名证书
keytool -genkey -alias caihong -keyalg RSA -keysize 2048 -validity 36500 -keystore caihong.keystore

# 查看证书信息
keytool -list -v -keystore caihong.keystore
```

iOS 证书需在 Apple Developer 后台创建，参考：
https://developer.apple.com/account/resources/certificates/list