Linux微信web开发者工具

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

Description

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

Usage

下载项目和初始化

bashCopy
git clone https://github.com/cytle/wechat_web_devtools.git
cd wechat_web_devtools
# 自动下载最新 `nw.js` , 同时部署目录 `~/.config/wechat_web_devtools/`
./bin/wxdt install

启动ide，开发和调试网页

运行准备:

1. GUI环境

bashCopy
./bin/wxdt # 启动

启动ide，开发和预览小程序

运行准备:

1. GUI环境
2. 需要安装wine
3. 并且已经执行过./bin/wxdt install

bashCopy
./bin/wxdt # 启动

命令行和HTTP调用

运行准备:

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

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

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

微信文档参考:

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

Docker

未安装wine，仅限cli调用

可以直接run

bashCopy
docker run -it \
    -v $PWD:/projects \
    canyoutle/wxdt \
    sh -c "cli -l && cli -p /projects/your-project"

或是启动一个持久的容器

bashCopy
docker run -d \
    --name wxdt \
    -p 6080:80 \
    -v $PWD:/projects \
    canyoutle/wxdt

docker exec -it wxdt cli -l # 登录
docker exec -it wxdt cli -p /projects/your-project # 预览工程

docker stop wxdt # 暂停容器
docker start wxdt # 下次使用，不用再run，可以直接exec

其它说明

安装Wine

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

1. 安装wine-binfmt

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

2. 正常安装wine

bashCopy
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: error while loading shared libraries: libnw.so: cannot open shared object file: No such file or directory

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

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

bashCopy
# 请务必等待执行完成
./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

完成后, 点击 <kbd>编译</kbd> 即可.

参考:

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

更新到最新版

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

bashCopy
git pull origin

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

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

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

bashCopy
./bin/update_package_nw.sh

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

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

bashCopy
./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重建字体缓存
• 确认字体安装成功

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

• 重启微信开发者工具

卸载

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

Arch Linux

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

截图

上面项目来自wechat-v2ex

赞赏

<img width="400px" height="400px" alt="赞赏码" src="https://raw.githubusercontent.com/cytle/wechat_web_devtools/master/images/%E5%BE%AE%E4%BF%A1%E8%B5%9E%E8%B5%8F%E7%A0%81.jpeg"/>

Changelog

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

免责声明

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