# 微信测试版发布说明

## 当前状态

- Taro 小程序工程目录：`D:\xuzhennan_work\project\git\xlh\wx_taro`
- 微信工程配置已补齐：
  - `project.config.json`
  - `project.private.config.json`
- 小程序 AppID 已写入：`wxd47ab74f3ea79156`
- 接口请求域名已切到：`https://dlxlh.dtacloud.cn`
- 上传接口域名已切到：`https://dlxlh.dtacloud.cn`

## 本地构建命令

在 `wx_taro` 目录执行：

```bash
npm run build:weapp
```

开发联调用：

```bash
npm run dev:weapp
```

## 微信开发者工具导入步骤

1. 打开微信开发者工具。
2. 选择“导入项目”。
3. 项目目录选择：

```text
D:\xuzhennan_work\project\git\xlh\wx_taro
```

4. AppID 选择：

```text
wxd47ab74f3ea79156
```

5. 开发模式选择“小程序”。
6. 导入后，开发者工具会读取：
   - `project.config.json`
   - `dist/`

## 首次打开后的操作

1. 先执行一次构建：

```bash
npm run build:weapp
```

2. 回到微信开发者工具，点击“工具 -> 构建 npm”。
3. 如果页面未刷新，点击“编译”。

## 上传测试版前检查

### 你需要人工确认

1. 微信公众平台已配置合法域名：
   - `request`
   - `uploadFile`
   - `downloadFile`

都应包含：

```text
https://dlxlh.dtacloud.cn
```

2. 后端公网服务正常可访问：
   - 登录接口
   - 首页接口
   - 上传接口
   - 短信验证码接口

3. 服务器证书有效，微信环境下没有 HTTPS 报错。

4. 你的测试微信号已加入小程序体验成员名单。

## 建议真机回归顺序

1. 登录
2. 首页
3. 活动列表 -> 活动详情 -> 报名
4. 社会服务 -> 服务团/项目详情
5. 社交 -> 我的好友/好友申请
6. 我的 -> 学习记录/建言/调查/浏览历史
7. 加入会员 -> 上传扫描件 -> 提交
8. 图片上传 -> 头像上传 -> 活动封面上传

## 上传测试版步骤

1. 微信开发者工具右上角点击“上传”。
2. 填写版本号。
3. 填写项目备注。
4. 上传成功后，进入微信公众平台。
5. 打开“小程序后台 -> 版本管理 -> 开发版本”。
6. 选择提交为测试版或添加体验成员体验。

## 当前已确认通过的项目内状态

- `build:weapp` 编译通过
- 页面主链路已迁到 Taro
- 主代码中无 `localhost` / `127.0.0.1` / `192.168.x.x` / `8080` 残留
- 页面层仅保留问卷进度条的动态宽度样式

## 如果导入失败，优先检查

1. 是否选择了 `wx_taro` 根目录，而不是 `dist`
2. 是否已经先执行 `npm run build:weapp`
3. 是否执行了“工具 -> 构建 npm”
4. AppID 是否和后台一致
5. 开发者工具基础库是否过旧
