
  
<div align="center">

  <img src="./res/icons/wechat-devtools.png" height="100px" width="100px"/>

  <h3>微信开发者工具 Linux版</h3>
  <br>

----

[![Node.js CI](https://github.com/msojocs/wechat-devtools-linux/actions/workflows/release.yml/badge.svg)](https://github.com/msojocs/wechat-devtools-linux/actions/workflows/release.yml)
[![wechat-tools](https://img.shields.io/badge/wechat--devtools-1.05.2204180-yellow)](https://developers.weixin.qq.com/miniprogram/dev/devtools/download.html)
[![nwjs](https://img.shields.io/badge/nwjs-0.55.0-green)](https://nwjs.io/downloads/)
[![node](https://img.shields.io/badge/node-16.4.2-orange)](https://nodejs.org/en/)
[![aur](https://img.shields.io/aur/version/wechat-devtools)](https://aur.archlinux.org/packages/wechat-devtools)

  这是微信开发者工具 Linux版
  

  <br>
</div>

# 项目说明

本项目是一个完整的搭建Linux下可用的“微信开发者工具”的脚本和工具集，
用于在Linux下的GNOME桌面上搭建可以持续更新和使用的“微信开发者工具”。
本项目修改自：https://github.com/dragonation/wechat-devtools/

# 项目地址
* https://github.com/msojocs/wechat-devtools-linux

# 进度

当前工具可以在Linux上构筑最新版1.05.2203070，支持CLI模式。
另现在已经可以直接在设置界面里面修改字体，手工输入字体名称就可以。

# 功能测试记录

[测试记录](docs/Features.MD)

注意: 

此测试仅在修复某项功能时测试通过，并不代表阁下在使用时是正常可用的；因为我没有精力在每个版本发布前进行一次测试。

在阁下遇到任何无法解决的问题时，请新建一个 [issue](https://github.com/msojocs/wechat-web-devtools-linux/issues/new/choose)

# 使用方法

1. 可以在本项目的[Release](https://github.com/msojocs/wechat-devtools-linux/releases)中，寻找已经构筑好了的`.tar.gz`包，下载解压后，运行其中的`bin/wechat-devtools`即可运行；也可以下载`AppImage`授予可执行权限后，直接运行。
如果`Release`版本存在问题，可以尝试[Continuous](https://github.com/msojocs/wechat-web-devtools-linux/releases/tag/continuous)版本，这是基于`master`分支的最新提交构建的，会及时修复一些bug。
2. 你可以[自行构建](#自行构建)


# 系统要求

* 基于Linux的桌面系统，首选GNOME（其他的桌面环境可能会有问题，未测试）
* CI自动构建的包对glibc和libstdc++有一定的版本要求，glibc的版本要求2.23，libstdc++的版本要求3.4.21
* 如果你下载的是`wine`版本，那么你需要安装有`wine` `wine-binfmt`支持，建议版本在5.0以上，低版本可能会存在有问题

# CLI支持

在项目的`bin`目录中有`wechat-devtools-cli`命令，是微信开发者工具的命令行支持Linux版本。相关资料可以在[微信CLI命令行V2](https://developers.weixin.qq.com/miniprogram/dev/devtools/cli.html)上找到。

# 自行构建

> 注：
> 如果不想使用`wine`，请添加环境变量：`export NO_WINE=true`,但是稳定性未测试

## 方法0（推荐）

理论上此方法99%成功;在网络不稳定时容易失败（原因懂得都懂，构建过程已经尽量使用镜像源）

1. 如果构建`wine`版本，请先在Linux环境中自行安装`wine` `wine-binfmt`；
2. 请安装`docker` `docker-compose`
3. 克隆本项目：
```
git clone https://github.com/msojocs/wechat-devtools-linux.git
```
4. 在本地项目目录中执行如下的语句，构筑开发者工具：
```
docker-compose up
```
5. 在本地项目目录中执行如下的语句，可以安装应用图标（非必须）：
```
./tools/install-desktop-icon-node
```

之后即可通过点击应用图标启动微信开发者工具，也可以运行`bin/wechat-devtools`通过命令行启动

## 方法1

由于使用到`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`
3. 克隆本项目：
```
git clone https://github.com/msojocs/wechat-devtools-linux.git
```
4. 在本地项目目录中执行如下的语句，构筑开发者工具：
```
./tools/setup-wechat-devtools-bash
```
5. 在本地项目目录中执行如下的语句，可以安装应用图标（非必须）：
```
./tools/install-desktop-icon-node
```

之后即可通过点击应用图标启动微信开发者工具，也可以运行`bin/wechat-devtools`通过命令行启动

# 与其他Linux下的微信开发者工具版本区别

1. 支持最新版本，并个人会持续更新，在添加新的tag时，actions会自动构建并上传Release；
2. 核心构筑过程完全开源，可以自行修改；
3. 修复了nwjs上关于Menu的段错误，确保最新版本可以正常启动 (by dragonation)；
4. 在构筑过程中会重新编译node_modules，确保原生模块可以在Linux上正确运行；
5. 下载更新可以支持断点再续，并使用了taobao国内的npm源，加速下载（稳定性待测试）。
6. 可以不需要`wine`环境的支持

# 后续计划

1. [处理计划](https://github.com/msojocs/wechat-devtools-linux/projects?type=beta)

# FAQ
[GO](docs/FAQ.MD)

# 界面截图

版本 1.05.2201240
![screenshot 1.03.2006090](res/screenshots/1.05.2201240.png)

版本 1.03.2006090
![screenshot 1.03.2006090](res/screenshots/1.03.2006090.jpg)

版本 1.02.2001191
![screenshot 1.02.2001191](res/screenshots/1.02.2001191.jpg)

# 免责声明

微信开发者工具版权归腾讯公司所有，本项目旨在交流学习之用。如有不当之处，请联系本人，邮箱：jiyecafe@gmail.com

# 赞赏
  如果这个仓库让你感到舒适，可以点个Star或者请这个菜鸡大学生喝杯咖啡（请尽量带上github昵称）：

  ![赞赏码](https://user-images.githubusercontent.com/20937135/154661198-93854dc1-c8ba-4c97-a7ab-9f8de26c0226.png)

# 感谢赞赏支持
  1. *喆
  2. shaoxp
  3. .
  4. IvesSSa
  5. icepie
  6. zyk-miao
  7. Starrah
  8. CoryByte