Linux微信web开发者工具

Использование инструмента разработчика WeChat в Linux.

wx_dev_tools v1.02.1910121	nw.js v0.24.4

Описание

Linux微信web开发者工具 позволяет запускать инструмент разработчика WeChat на рабочем столе Linux. По сути, инструмент разработчика WeChat — это программа nw.js, которую можно без проблем перенести на Linux. Она отвечает за компиляцию файлов wxml и wxss с помощью инструментов wcc и wcsc (возможно, есть и другие функции). Для запуска можно использовать wine.

Использование

Загрузка проекта и инициализация

git clone https://github.com/cytle/wechat_web_devtools.git
cd wechat_web_devtools
# автоматически загружает последнюю версию nw.js и развёртывает каталог ~/.config/wechat_web_devtools/
./bin/wxdt install

Запуск IDE, разработка и отладка веб-страниц

Подготовка к запуску:

• GUI-среда

Запуск:

./bin/wxdt # запуск

Запуск IDE, разработка и предварительный просмотр мини-программы

Подготовка к запуску:

• GUI-среда;
• необходимо установить wine (см. раздел «Установка Wine»);
• уже выполнена команда ./bin/wxdt install.

Запуск:

./bin/wxdt # запуск

Командная строка и HTTP-вызов

Подготовка к запуску:

• GUI-среда, командная строка и HTTP-вызовы автоматически запускают IDE (можно использовать docker, если нет условий для сервера);
• уже выполнена команда ./bin/wxdt install;
• в настройках IDE включён порт сервера: Настройки → Безопасность → Порт сервера (включить).

Расположение инструмента командной строки: <путь установки>/bin/cli.

Расположение файла номера порта: ~/.config/wechat_web_devtools/Default/.ide.

Документация WeChat:

• командный вызов · мини-программа (https://developers.weixin.qq.com/miniprogram/dev/devtools/cli.html);
• HTTP-вызов · мини-программа (https://developers.weixin.qq.com/miniprogram/dev/devtools/http.html).

Docker

Если не установлен wine, можно использовать только cli-вызов. Можно сразу запустить:

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

Или запустить постоянный контейнер:

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 # использовать снова, не нужно запускать, можно сразу выполнить команду exec

Другие инструкции

Установка Wine

Пожалуйста, обратитесь к поисковой системе для установки Wine (https://wiki.winehq.org/Download). Ниже приведены инструкции по установке в 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: error while loading shared libraries: libnw.so: cannot open shared object file: No such file or directory

Эта ошибка вызвана неудачной загрузкой 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 не были успешно заменены двумя двоичными файлами.

• Решение 1: Установите wine и выполните команду ./bin/wxdt install.
• Решение 2: Установите 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

Обновление до последней версии

Решение 1: Непосредственно из текущего исходного кода проекта (стабильное, рекомендуется)

git pull origin

Решение 2: Использовать исходный установщик Tencent для самостоятельного копирования и обновления (своевременное, самостоятельное решение проблем)

Примечание: Если возникнут проблемы, вы можете попробовать использовать git reset --hard и другие операции для восстановления исходного состояния. Выполните обновление, чтобы автоматически загрузить последнюю версию Windows x64 Developer Tool и использовать 7z для распаковки.

./bin/update_package_nw.sh

Решение 3: То же, что и выше, вручную указать -l <адрес загрузки инструмента разработки WeChat> -v <номер версии> (можно указать предварительную версию или версию для разработки)

Примечание: параметры -l и -v должны быть указаны одновременно, а номер версии должен иметь вид 1.02.2001191.

./bin/update_package_nw.sh -l <адрес загрузки инструмента разработки WeChat> -v <номер версии>

Советы:

• Работает нормально, добро пожаловать в PR.

В среде Ubuntu установите редактор шрифтов

В среде Ubuntu по умолчанию нет шрифта Consolas, и в настоящее время невозможно изменить шрифт, поэтому загрузка и установка шрифта Consolas является лучшим решением, которое делает редактор более удобным для просмотра.

• Загрузите https://github.com/kakkoyun/linux.files/raw/master/fonts/Consolas.ttf в /usr/local/share/fonts или ~/.fonts.
• sudo fc-cache -f для перестроения кэша шрифтов.
• Убедитесь, что установка шрифта прошла успешно.

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

• Перезапустите инструмент разработчика WeChat.

Удаление

1. Закройте инструмент разработчика WeChat.
2. В каталоге проекта выполните команду ./bin/wxdt uninstall (удалите значок рабочего стола, конфигурацию инструмента разработчика WeChat), конфигурация инструмента разработчика WeChat, все проекты и информация для входа будут удалены.
3. Удалите каталог проекта.

Arch Linux

Arch Linux и его производные дистрибутивы, такие как Manjaro, могут быть установлены через AUR: https://aur.archlinux.org/packages/wechat-devtool/.