安装与首次启动
环境要求
| 项 | 要求 |
|---|---|
| 系统 | Android 7.0 及以上 |
| 架构 | arm64-v8a（主流手机、平板、车机） |
| 存储 | 建议预留 500 MB 以上，用于运行时与小程序包缓存 |
| 网络 | 首次登录需要联网 |
| 电脑（可选） | 需要断点调试时使用 |
下载
APK 发布在 GitHub Releases：
- github.com/RYF5584/WeAppDev/releases
- 官网首页的「下载 APK」按钮指向同一个地址。
下载最新的 WeAppDev-*.apk 即可，不需要额外的框架包或模块。
安装
- 把 APK 传到手机（数据线、网盘、聊天工具均可）。
- 点击安装，系统提示「未知来源」时允许当前文件管理器安装。
- 安装完成后，桌面出现 WeAppDev 图标。
WeAppDev 与原版微信使用不同的包名，可以同时安装，互不影响。它也不会读取微信的数据。
首次启动
打开 App，进入「我的 / 登录」页：
- 点击 获取登录二维码。
- 用微信扫描屏幕上的二维码，并在手机上确认授权。
- App 会轮询扫码状态：
waiting → scanned → authorized。 - 登录成功后，点击 保存当前登录到多账号，这个账号会出现在「账号」页。
二维码有效期约 240 秒，页面上会显示剩余时间。过期后重新获取即可。
会话时效
登录态保存在本地，有效期约 24 小时。过期后需要重新扫码。多账号目录里的会话可以随时切换，但同一时间只有一个「当前账号」生效。
认识主界面
底部有三个 Tab：
| Tab | 作用 |
|---|---|
| 首页 | 输入 AppID / 原始 ID 查询并打开小程序；最近使用；快捷调试 |
| 开发者工具 | 网络调试、Native 调试、插件、日志、API Server、开发配置 |
| 我的 | 账号管理、主题、横竖屏、关于 |
首页顶部的状态标识会显示 WMPF 运行时的连接状态。如果显示未连接，先打开任意一个小程序。
常见安装问题
| 现象 | 处理 |
|---|---|
| 解析包错误 | 下载不完整，重新下载；确认是 arm64 版本 |
| 安装被拦截 | 允许「安装未知应用」；部分厂商需要在安全中心里放行 |
| 打开闪退 | 确认 Android 版本 ≥ 7；查看日志页是否有 native 崩溃 |
| 扫码后一直 waiting | 检查网络；二维码是否过期；重新获取 |
| 登录成功但列表为空 | 该账号没有最近使用记录，直接输入 AppID 打开即可 |