226 lines
5.7 KiB
Markdown
226 lines
5.7 KiB
Markdown
# 小程序环境配置统一使用域名访问 Implementation Plan
|
|
|
|
> **For agentic workers:** REQUIRED: Use superpowers:subagent-driven-development (if subagents available) or superpowers:executing-plans to implement this plan. Steps use checkbox (`- [ ]`) syntax for tracking.
|
|
|
|
**Goal:** 修改小程序所有环境配置文件，统一使用域名 `lifescript.happylifeos.com` 通过 HTTPS/WSS 协议访问服务器后端 API。
|
|
|
|
**Architecture:** 修改 `.env.development`、`.env.test`、`.env.production` 三个环境配置文件，将 API 和 WebSocket 地址从 localhost/IP 地址改为域名访问，使用 HTTPS 和 WSS 加密协议。
|
|
|
|
**Tech Stack:** UniApp, Vite, 环境变量配置
|
|
|
|
---
|
|
|
|
## Chunk 1: 环境配置文件修改
|
|
|
|
### Task 1: 修改开发环境配置 (.env.development)
|
|
|
|
**Files:**
|
|
- Modify: `mini-program/.env.development`
|
|
|
|
- [ ] **Step 1: 修改 .env.development 文件内容**
|
|
|
|
将以下内容：
|
|
```bash
|
|
VITE_APP_ENV=dev
|
|
VITE_API_BASE_URL=http://localhost:19089/api
|
|
VITE_WS_URL=ws://localhost:19089
|
|
VITE_DEBUG=true
|
|
```
|
|
|
|
修改为：
|
|
```bash
|
|
# 开发环境配置（本地开发调试）
|
|
VITE_APP_ENV=dev
|
|
VITE_API_BASE_URL=https://lifescript.happylifeos.com/api
|
|
VITE_WS_URL=wss://lifescript.happylifeos.com/ws
|
|
VITE_DEBUG=true
|
|
```
|
|
|
|
- [ ] **Step 2: 验证文件格式正确**
|
|
|
|
确认文件内容没有多余的空格或格式问题
|
|
|
|
- [ ] **Step 3: 提交更改**
|
|
|
|
```bash
|
|
git add mini-program/.env.development
|
|
git commit -m "fix: 开发环境配置改为域名访问 (HTTPS/WSS)"
|
|
```
|
|
|
|
---
|
|
|
|
### Task 2: 修改测试环境配置 (.env.test)
|
|
|
|
**Files:**
|
|
- Modify: `mini-program/.env.test`
|
|
|
|
- [ ] **Step 1: 修改 .env.test 文件内容**
|
|
|
|
将以下内容：
|
|
```bash
|
|
# 体验环境配置（小程序体验版）
|
|
VITE_APP_ENV=test
|
|
VITE_API_BASE_URL=http://101.200.208.45:19089/api
|
|
VITE_WS_URL=ws://101.200.208.45:19089
|
|
VITE_DEBUG=true
|
|
```
|
|
|
|
修改为：
|
|
```bash
|
|
# 测试环境配置（小程序体验版）
|
|
VITE_APP_ENV=test
|
|
VITE_API_BASE_URL=https://lifescript.happylifeos.com/api
|
|
VITE_WS_URL=wss://lifescript.happylifeos.com/ws
|
|
VITE_DEBUG=true
|
|
```
|
|
|
|
- [ ] **Step 2: 验证文件格式正确**
|
|
|
|
确认文件内容没有多余的空格或格式问题
|
|
|
|
- [ ] **Step 3: 提交更改**
|
|
|
|
```bash
|
|
git add mini-program/.env.test
|
|
git commit -m "fix: 测试环境配置改为域名访问 (HTTPS/WSS)"
|
|
```
|
|
|
|
---
|
|
|
|
### Task 3: 修改生产环境配置 (.env.production)
|
|
|
|
**Files:**
|
|
- Modify: `mini-program/.env.production`
|
|
|
|
- [ ] **Step 1: 修改 .env.production 文件内容**
|
|
|
|
将以下内容（注意：当前文件第一行是 `VITE_APP_ENV=prod` 但文件名是 production，需确认内容）：
|
|
|
|
```bash
|
|
VITE_APP_ENV=prod
|
|
VITE_API_BASE_URL=http://101.200.208.45:19089/api
|
|
VITE_WS_URL=ws://101.200.208.45:19089
|
|
VITE_DEBUG=false
|
|
```
|
|
|
|
修改为：
|
|
```bash
|
|
# 生产环境配置（小程序正式版）
|
|
VITE_APP_ENV=prod
|
|
VITE_API_BASE_URL=https://lifescript.happylifeos.com/api
|
|
VITE_WS_URL=wss://lifescript.happylifeos.com/ws
|
|
VITE_DEBUG=false
|
|
```
|
|
|
|
- [ ] **Step 2: 验证文件格式正确**
|
|
|
|
确认文件内容没有多余的空格或格式问题
|
|
|
|
- [ ] **Step 3: 提交更改**
|
|
|
|
```bash
|
|
git add mini-program/.env.production
|
|
git commit -m "fix: 生产环境配置改为域名访问 (HTTPS/WSS)"
|
|
```
|
|
|
|
---
|
|
|
|
## Chunk 2: 代码验证和文档更新
|
|
|
|
### Task 4: 验证环境配置代码兼容性
|
|
|
|
**Files:**
|
|
- Read: `mini-program/src/config/env.js`
|
|
- Read: `mini-program/src/utils/env.ts`
|
|
|
|
- [ ] **Step 1: 检查 src/config/env.js 文件**
|
|
|
|
确认文件中的配置逻辑能够正确处理 HTTPS 和 WSS 协议地址
|
|
|
|
预期：该文件只是读取环境变量，不需要修改
|
|
|
|
- [ ] **Step 2: 检查 src/utils/env.ts 文件**
|
|
|
|
确认请求封装代码能够正确处理 HTTPS 和 WSS 协议地址
|
|
|
|
预期：该文件使用 API_BASE_URL 拼接请求地址，不需要修改
|
|
|
|
- [ ] **Step 3: 提交验证结果**
|
|
|
|
如果代码不需要修改，跳过提交
|
|
|
|
---
|
|
|
|
### Task 5: 更新 README.md 文档
|
|
|
|
**Files:**
|
|
- Modify: `mini-program/README.md`
|
|
|
|
- [ ] **Step 1: 更新环境配置说明**
|
|
|
|
将环境配置表格更新为：
|
|
|
|
```markdown
|
|
| 文件 | 说明 | API 地址 | WebSocket 地址 |
|
|
|------|------|----------|----------------|
|
|
| `.env.development` | 开发环境配置 | https://lifescript.happylifeos.com/api | wss://lifescript.happylifeos.com/ws |
|
|
| `.env.test` | 测试环境配置 | https://lifescript.happylifeos.com/api | wss://lifescript.happylifeos.com/ws |
|
|
| `.env.production` | 生产环境配置 | https://lifescript.happylifeos.com/api | wss://lifescript.happylifeos.com/ws |
|
|
```
|
|
|
|
- [ ] **Step 2: 更新各环境配置示例**
|
|
|
|
将三个环境的配置示例都更新为使用域名的格式
|
|
|
|
- [ ] **Step 3: 提交更改**
|
|
|
|
```bash
|
|
git add mini-program/README.md
|
|
git commit -m "docs: 更新环境配置文档说明"
|
|
```
|
|
|
|
---
|
|
|
|
### Task 6: 验证小程序编译
|
|
|
|
**Files:**
|
|
- Build Output: `mini-program/unpackage/dist/test/mp-weixin`
|
|
|
|
- [ ] **Step 1: 执行测试环境编译**
|
|
|
|
```bash
|
|
cd mini-program
|
|
npm run build:mp-weixin:test
|
|
```
|
|
|
|
预期：编译成功，无错误
|
|
|
|
- [ ] **Step 2: 验证编译产物中的环境变量**
|
|
|
|
检查编译后的文件中环境变量是否正确注入
|
|
|
|
预期：API_BASE_URL 和 WS_URL 应为域名地址
|
|
|
|
- [ ] **Step 3: 提交验证**
|
|
|
|
如果编译成功，记录验证结果
|
|
|
|
---
|
|
|
|
## 验证步骤
|
|
|
|
完成所有任务后，执行以下验证：
|
|
|
|
1. **配置验证**: 确认三个环境配置文件都已更新为域名访问
|
|
2. **编译验证**: 确认小程序可以正常编译
|
|
3. **代码验证**: 确认现有代码能够正确处理 HTTPS/WSS 地址
|
|
|
|
---
|
|
|
|
## 注意事项
|
|
|
|
1. 所有环境都使用 HTTPS/WSS 协议，微信小程序要求加密连接
|
|
2. 开发环境也使用服务器 API，本地无需启动后端服务
|
|
3. 确保服务器 CORS 配置允许小程序域名访问
|
|
4. 确保服务器 Nginx 配置了正确的 SSL 证书
|