docs: 更新 issue 模板 & readme

This commit is contained in:
msojocs 2022-04-28 16:48:06 +08:00
parent bd74d566f3
commit 99bf79ae66
3 changed files with 64 additions and 58 deletions

40
.github/ISSUE_TEMPLATE/bug_report.md vendored Normal file
View File

@ -0,0 +1,40 @@
---
name: 报告Bug
about: 如果阁下提交的 `issue` 属于bug但没有按模板提交那么将会被忽略或删除
title: ''
labels: bug
assignees: ''
---
**预先准备**
1. 删除 `~/.config/wechat-devtools` 目录,重新打开项目(若发布 `issue` 即默认阁下执行了此操作且问题没有解决);
2. HelloWorld是否正常登录状态新建默认项目,执行复现步骤):正常/不正常
**问题描述**
<!-- 请对问题做一个简单描述。 -->
**问题复现**
<!-- 复现问题需要进行的操作: -->
1. 打开项目
2. 点击 '....'
3. 看到问题
**期望的效果**
<!-- 经过上述操作你希望得到的结果. -->
**截屏**
<!-- 添加截图图片有助于解释您的问题,请尽量将整个开发工具都涵括在截图在(复制图片后直接粘贴将自动上传图片)。 -->
**版本信息 (这是必要的):**
- OS: e.g. manjaro
- Package: e.g. xxx_wine.tar.gz
- Wine Version: e.g. 7 可选
**代码片段**
<!-- 提供代码片段对维护者定位与修复问题有极大帮助;
若阁下不能提供,且维护者不能复现问题,那么阁下的`issue`将被搁置或者关闭。
[查看创建代码片段的教程](https://developers.weixin.qq.com/miniprogram/dev/devtools/minicode.html) -->
**额外的信息**
<!-- 一些关于此问题的额外信息。 -->

View File

@ -1,40 +0,0 @@
---
name: 报告Bug
about: 如果阁下提交的`issue`属于bug但没有按模板提交那么将会被忽略或删除
title: ''
labels: bug
assignees: ''
---
**预先准备**
1. 删除`~/.config/wechat-devtools`目录,重新打开项目(若发布`issue`即默认阁下执行了此操作且问题没有解决);
2. HelloWorld是否正常登录状态新建默认项目,执行复现步骤):正常/不正常
**问题描述**
请对问题做一个简单描述。
**问题复现**
复现问题需要进行的操作:
1. 打开项目
2. 点击 '....'
3. 看到问题
**期望的效果**
经过上述操作你希望得到的结果.
**截屏**
添加截图图片有助于解释您的问题,请尽量将整个开发工具都涵括在截图在(复制图片后直接粘贴将自动上传图片)。
**版本信息 (这是必要的):**
- OS: e.g. manjaro
- Package: e.g. xxx_wine.tar.gz
- Wine Version: e.g. 7 可选
**代码片段**
提供代码片段对维护者定位与修复问题有极大帮助;
若阁下不能提供,且维护者不能复现问题,那么阁下的`issue`将被搁置或者关闭。
[查看创建代码片段的教程](https://developers.weixin.qq.com/miniprogram/dev/devtools/minicode.html)
**额外的信息**
一些关于此问题的额外信息。

View File

@ -91,24 +91,26 @@ docker-compose up
## 方法1
由于使用到`node-gyp` `nw-gyp`,此方法会受`python``node`版本影响出现一些难以预料的异常(比如使用`node15.0.1`时,大部分模块构建会被忽略,但没有任何报错信息)。但是,`Docker`构建方式会帮你处理好这些问题。
由于使用到 `node-gyp` `nw-gyp`,此方法会受 `python``node` 版本影响出现一些难以预料的异常(比如使用 `node15.0.1` 时,大部分模块构建会被忽略,但没有任何报错信息)。但是,`Docker` 构建方式会帮你处理好这些问题。
1. 如果构建`wine`版本请先在Linux环境中自行安装`wine` `wine-binfmt`
2. 安装编译`nodegit`所需的依赖:`python2.7 python3.6及以上 libkrb5-dev gcc openssl libssh2-1-dev g++ make pkg-config` `7z`旧版解压可能存在问题未测试最低版本号比如ubuntu16.04自带的不行),请参考`Dockerfile`
1. 如果构建 `wine` 版本请先在Linux环境中自行安装 `wine` `wine-binfmt`
2. 安装编译`nodegit`所需的依赖:`python2.7 python3.6及以上 libkrb5-dev gcc openssl libssh2-1-dev g++ make pkg-config`
另外 `7z` 旧版解压可能存在问题未测试最低版本号比如ubuntu16.04 自带的不行),请参考 `Dockerfile`
3. 克隆本项目:
```
git clone https://github.com/msojocs/wechat-devtools-linux.git
```
```
git clone https://github.com/msojocs/wechat-devtools-linux.git
```
4. 在本地项目目录中执行如下的语句,构筑开发者工具:
```
./tools/setup-wechat-devtools-bash
```
```
./tools/setup-wechat-devtools-bash
```
5. 在本地项目目录中执行如下的语句,可以安装应用图标(非必须):
```
./tools/install-desktop-icon-node
```
```
./tools/install-desktop-icon-node
```
之后即可通过点击应用图标启动微信开发者工具,也可以运行`bin/wechat-devtools`通过命令行启动
之后即可通过点击应用图标启动微信开发者工具,也可以运行 `bin/wechat-devtools` 通过命令行启动
# 与其他Linux下的微信开发者工具版本区别
@ -117,12 +119,16 @@ git clone https://github.com/msojocs/wechat-devtools-linux.git
3. 修复了nwjs上关于Menu的段错误确保最新版本可以正常启动 (by dragonation)
4. 在构筑过程中会重新编译node_modules确保原生模块可以在Linux上正确运行
5. 下载更新可以支持断点再续并使用了taobao国内的npm源加速下载稳定性待测试
6. 可以不需要`wine`环境的支持
6. 纯 Linux 支持
# 后续计划
1. [处理计划](https://github.com/msojocs/wechat-devtools-linux/projects?type=beta)
# 移植相关
请参考: [移植流程记录](https://github.com/msojocs/wechat-web-devtools-linux/wiki)
# FAQ
[GO](docs/FAQ.MD)
@ -137,10 +143,6 @@ git clone https://github.com/msojocs/wechat-devtools-linux.git
版本 1.02.2001191
![screenshot 1.02.2001191](res/screenshots/1.02.2001191.jpg)
# 免责声明
微信开发者工具版权归腾讯公司所有本项目旨在交流学习之用。如有不当之处请联系本人邮箱jiyecafe@gmail.com
# 赞赏
如果这个仓库让你感到舒适可以点个Star或者请这个菜鸡大学生喝杯咖啡请尽量带上github昵称
@ -155,3 +157,7 @@ git clone https://github.com/msojocs/wechat-devtools-linux.git
6. zyk-miao
7. Starrah
8. CoryByte
# 免责声明
微信开发者工具版权归腾讯公司所有本项目旨在交流学习之用。如有不当之处请联系本人邮箱jiyecafe@gmail.com