pushdeer/quickapp/README.md
2022-02-22 22:42:28 +08:00

89 lines
2.8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

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