Repository navigation

开发与调试流程

这一章覆盖什么

项目初始化
代码结构
IDE 开发流程
域名配置
真机验证

项目结构

SuperBox 小程序整体可按微信小程序风格理解：

根文件：app.js、app.json、app.wxss
页面文件：.js、.wxml、.json、.wxss
页面文件同路径同名

IDE 配置

project.config.json 重点字段：

miniprogramRoot
compileType
TCMPPappid
libVersion
condition
mockConfig

开发流程

用正确的 AppID 创建 IDE 项目
配置源码目录和基础库版本
开发页面与功能
用模拟器做大部分验证
用真机远程调试验证设备相关行为
上传代码包

域名配置

正式依赖网络前，要先在控制台配置：

wx.request
wx.uploadFile
wx.downloadFile
wx.connectSocket
如使用，则还包括 TCP / UDP

重要规则：

不能直接用 IP 或 localhost
不能只配父域名
TLS 和证书链必须有效

IDE 调试面板

常用调试面板：

WXML
Console
Sources
Network
AppData
Storage
Sensor
Mock
Compatibility

真机验证

这些能力只要用到，就应该真机回归：

登录与授权
钱包连接
交易签名
存储
域名校验
设备 API

常见阻塞点

AppID 不匹配
项目配置和控制台配置不一致
开发时关闭了严格域名校验，后续才暴露问题
AppSecret 重置后后端未同步

完成检查

IDE 用正确 AppID 成功打开项目
模拟器通过核心页面检查
严格校验模式下网络通过
关键流程做过真机调试
代码包上传成功