pushdeer/quickapp/README.md

89 lines
2.8 KiB
Markdown
Raw Normal View History

2022-02-22 20:44:15 +08:00
# PushDeer-快应用
2021-12-28 12:58:20 +08:00
PushDeer 是一个开放源码的无 App 推送服务
2022-02-22 20:44:15 +08:00
这里是 PushDeer 的 `快应用` 端的源码
2022-02-22 22:42:28 +08:00
![演示](https://s2.loli.net/2022/02/22/4vMP7VrutciCdw6.gif)
2022-02-22 20:44:15 +08:00
---
## 支持明细
厂商|支持|备注
-|-|-
华为 | ❌ | 华为快应用与联盟快应用属于不同体系,暂未完全适配
一加 | ✅ | -
小米 | ✅ | -
> 其他机型未进行测试
## TODO
- [ ] 添加自架支持
- [ ] 接入MiPush消息接收
- [ ] 优化界面显示效果
---
2022-02-22 22:42:28 +08:00
2022-02-22 20:44:15 +08:00
## 环境准备
- node环境(开发使用的版本是v16.13.1)
- [快应用IDE](https://www.quickapp.cn/docCenter/post/97)
- adb
- [调试器](https://www.quickapp.cn/docCenter/post/69)
- Android手机一台
## 配置项修改
> 由于快应用编译器貌似不支持从.env文件加载相关配置此步骤通过手工进行
- 修改后端API地址
2022-02-22 22:42:28 +08:00
2022-02-22 20:44:15 +08:00
编辑`src/helper/api.js`文件,修改`baseUrl`常量为当前使用的API地址
- 修改包名
2022-02-22 22:42:28 +08:00
2022-02-22 20:44:15 +08:00
编辑`src/manifest.js`文件,修改`package`参数为目标包名
> 包名关系到各厂商的应用申请,及微信平台应用信息
- 修改微信开放平台APPID
2022-02-22 22:42:28 +08:00
2022-02-22 20:44:15 +08:00
编辑`src/manifest.js`文件,修改`features/{"name": "service.wxaccount"}`下的`appId`参数为微信开放平台ID
> 需要与微信开放平台的应用匹配,否则无法使用微信登录
## 编译及运行
- 克隆源码
- 安装依赖
```bash
cd quickapp && yarn
```
- 启动快应用IDE
启动IDE打开quickapp文件夹
![快应用IDE界面](https://s2.loli.net/2022/02/22/ymgavTXHZ6zDLKx.png)
IDE打开项目后会自动编译执行并把界面展示到模拟器
> 模拟器结果会与真机有所出入,请以真机调试效果为准
## 运行与调试
- 真机预览
2022-02-22 22:42:28 +08:00
2022-02-22 20:44:15 +08:00
`IDE`中,点击模拟器上方二维码按钮,弹出当前二维码
![预览二维码](https://s2.loli.net/2022/02/22/f75jwbEI9y8RJHl.png)
手机保持与PC在同一网络打开`快应用调试器`,点击`扫码安装`
<img src="https://s2.loli.net/2022/02/22/hBGlUcEKsw1fjz3.jpg" height='400px'>
- 真机调试
2022-02-22 22:42:28 +08:00
2022-02-22 20:44:15 +08:00
运行成功后,回到`快应用调试器`,点击`开始调试`PC端会自动打开调试器可以查看预览及日志等信息
![调试](https://s2.loli.net/2022/02/22/ZFghDiBWTRa42yd.png)
> 若调试界面不弹出,请多试几次
> 调试界面容易卡死不显示最新日志,清关闭调试界面,重新在手机端开始调试
## 发布上线流程
基本步骤如下:
- 注册快应用及各厂商开发者账号
2022-02-22 22:42:28 +08:00
- 绑定厂商开发者账号
2022-02-22 20:44:15 +08:00
- 生成证书(证书路径位于`/sign/release` 及`/sign/debug`目录下)
- 获取证书指纹
- 在各厂商开放平台创建应用、完成审核
详细操作,请移步[快应用官网](https://www.quickapp.cn/docCenter)
![picture 5](https://s2.loli.net/2022/02/22/wGhKtBiNAmbjCls.png)