打开第一个小程序
登录完成之后,首页就是你的启动台。
用 AppID 打开
- 在首页输入框填入 AppID(
wx开头)或 原始 ID(gh_开头)。 - 点击 查询,App 会拉取小程序的名称、头像、版本等信息。
- 点击 打开小程序,小程序运行进程启动并渲染。
例如:
text
wx91d27dbf599dff74 # 一个示例 AppID
gh_xxxxxxxxxxxx # 原始 ID,二选一填写打开时还可以指定页面路径与版本类型:
| 参数 | 说明 |
|---|---|
appId | 小程序 AppID |
path | 页面路径,例如 pages/detail/index?id=42,留空进入首页 |
appType | 0 正式版 / 1 开发版 / 2 体验版 |
这些参数同样可以通过本地网关调用:
bash
curl -X POST http://127.0.0.1:9400/v1/apps/open \
-H 'content-type: application/json' \
-d '{"appId":"wx91d27dbf599dff74","path":"pages/index/index"}'最近使用
首页的「最近使用」按当前账号拉取,最多显示 20 个。点一下卡片直接启动,长按会弹出「打开 / 查询详细」。
这个列表来自 WMPF 的账号数据,所以:
- 换账号后列表会跟着变;
- 新账号可能没有历史记录,属于正常现象;
- 列表为空时,直接用 AppID 打开一次,之后就会出现。
关闭与重启
打开小程序后,右上角胶囊菜单里可以:
- 关闭小程序:结束当前小程序进程,调试 target 会随之消失;
- 重启小程序:等价于关闭再打开,适合改完插件或调试开关后重载;
- 插件:打开当前小程序上的浮窗面板。
网关也提供对应的动作接口:
bash
curl -X POST http://127.0.0.1:9400/v1/apps/wx91d27dbf599dff74:close
curl -X POST http://127.0.0.1:9400/v1/apps/wx91d27dbf599dff74:restart多账号
「账号」页会列出所有已保存的账号,绿点代表会话在线。
| 操作 | 行为 |
|---|---|
| 切换 | 写入 current 标记 → 把该账号的会话拷回主目录 → 杀掉 WMPF 进程 |
| 删除 | 清掉该账号的独立存储目录 |
| 刷新 | 重新探测各账号的在线状态 |
切换之后必须重启小程序进程,否则查询和打开仍会走旧会话。App 已经把这步自动化了。
常见问题
白屏怎么办?
先确认没有误开「业务层调试」——它和渲染互斥。关闭后重启小程序。其次确认这个小程序本身可以在当前环境中运行。
提示 appid 不存在 / 无法打开?
确认 AppID 拼写;部分小程序只允许在微信内打开,或依赖本机缓存。换一个已知可用的小程序先验证链路。
打开很慢?
首次打开需要下载并解压小程序包,几秒到十几秒都正常。第二次会快很多。