boringcat/wxdt repository overview

⁠Linux微信开发者工具

linux 下使用微信开发者工具.

⁠Description

Linux微信开发者工具, 可在 linux Docker环境跑起 微信开发者工具, 原理是 微信开发者工具 本质是 nw.js 程序, 把它移植到 linux 下没大问题. 负责编译 wxml 和 wxss 的 wcc 和 wcsc (可能还有其他功能), 则利用 wine 来跑即可.

⁠初始化

⁠下载 docker 镜像

docker pull boringcat/wxdt:latest

⁠标签对应列表

⁠启动

docker run --name=wxdt -d \
  -v /tmp/.X11-unix:/tmp/.X11-unix \
  -v $PWD:/projects \
  boringcat/wxdt:latest

⁠命令行和HTTP调用

运行准备:

1. GUI环境，命令行和HTTP调用会自动启动ide(服务器没条件的可以使用docker)
2. 并且已经执行过./bin/wxdt install
3. 在ide的设置中开启服务端口： 设置 -> 安全 -> 服务端口(开启)

命令行工具所在位置: <安装路径>/bin/cli

端口号文件位置：~/.config/wechat_web_devtools/Default/.ide

微信文档参考:

• 命令行 调用 · 小程序⁠
• HTTP 调用 · 小程序⁠

⁠NoVnc

docker run --name=wxdt -d \
  -v $PWD:/projects \
  -p 6080:80 \
  boringcat/wxdt:novnc-latest

以下内容未改动

⁠其它说明

⁠安装Wine

请参考搜索引擎安装 Wine⁠，以下是Ubuntu下两种安装

⁠1. 安装wine-binfmt

sudo apt-get install wine-binfmt
sudo update-binfmts --import /usr/share/binfmts/wine

⁠2. 正常安装wine

dpkg --add-architecture i386 \
  && wget -nc https://dl.winehq.org/wine-builds/winehq.key \
  && apt-key add winehq.key \
  && apt-add-repository 'deb https://dl.winehq.org/wine-builds/ubuntu/ bionic main' \
  && apt-get update \
  && apt-get install -y --no-install-recommends --allow-unauthenticated winehq-stable

⁠./bin/wxdt install 报错失败

该错误是由 nw.js 下载失败所致. 删除缓存, 重新下载即可.

rm -rf /path/to/wechat_web_devtools/dist
rm -rf /tmp/wxdt_xsp

# 请务必等待执行完成
./bin/wxdt install

参考

• https://github.com/cytle/wechat_web_devtools/issues/49#issuecomment-350478295⁠

⁠wcc 和 wcsc 编译错误

是wine没安装好导致的，或是没有成功替换wcc 和 wcsc两个二进制文件

• 方案一: 安装wine并且执行./bin/wxdt install
• 方案二: 安装wine-binfmt

完成后, 点击 编译 即可.

参考:

1. https://github.com/cytle/wechat_web_devtools/issues/66#issuecomment-368434141⁠
2. https://github.com/cytle/wechat_web_devtools/issues/56#issuecomment-371999385⁠

⁠更新到最新版

⁠方案一: 直接从当前项目源码 进行 更新 (稳定, 推荐)

git pull origin

⁠方案二: 使用腾讯原始安装程序 进行 自助复制更新 (及时, 自行折腾)

注: 如果抽风了, 可以尝试使用 git reset --hard 等操作, 还原到最初的状态.

执行更新, 自动下载最新 Windows x64 版开发者工具, 并且使用7z解压.  

./bin/update_package_nw.sh

⁠方案三: 同上 手动指定 -l <微信开发工具下载地址> -v <版本号> (可指定预发布版或开发版)

注: -l -v 选项务必同时指定, 并且版本号 形如1.02.2001191

./bin/update_package_nw.sh -l <微信开发工具下载地址> -v <版本号>

Tips

• 运行没问题，欢迎PR

⁠Ubuntu环境下编辑器字体安装

Ubuntu环境下默认没有Cosolas字体，同时目前无法修改字体，因此下载安装Consolas字体是较优方案，使得编辑器将显示更舒服。

• 下载https://github.com/kakkoyun/linux.files/raw/master/fonts/Consolas.ttf 至/usr/local/share/fonts or ~/.fonts
• sudo fc-cache -f重建字体缓存
• 确认字体安装成功

sudo fc-list|grep Consol
.fonts/Consolas.ttf: Consolas:style=Regular

• 重启微信开发者工具

⁠卸载

1. 关闭 微信开发者工具
2. 项目文件夹下运行 ./bin/wxdt uninstall (删除桌面图标、微b开发者工具配置目录), 开发者工具配置文件, 所有工程和登录信息均会消失
3. 删除项目文件夹

⁠Arch Linux

Arch Linux 及其衍生发行版，如 Manjaro，可以通过 AUR 进行安装：https://aur.archlinux.org/packages/wechat-devtool/⁠

⁠截图

上面项目来自wechat-v2ex⁠

⁠赞赏

⁠Changelog

• 更新日志⁠
• 腾讯官方更新日志⁠

⁠免责声明

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