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, разработка и отладка веб-страниц

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

1. GUI-среда

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

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

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

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

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

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

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

1. Командный интерфейс будет запущен автоматически при запуске IDE (сервер может быть недоступен, в этом случае можно использовать docker);
2. уже выполнена команда ./bin/wxdt install;
3. в настройках 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 не установлен, доступен только командный интерфейс.

Можно сразу запустить:

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

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

• Установка Wine

Рекомендуется обратиться к поисковику для установки Wine. Ниже приведены инструкции по установке Wine в Ubuntu.

• Установка wine-binfmt

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

• Обычная установка 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

• Ошибка при выполнении команды ./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_we‌​b_devtools/issues/56#issu‌​ecomment-371999385.

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

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

git pull origin

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

Выполните обновление, чтобы автоматически загрузить последнюю версию Windows x64 Developer Tool и использовать 7z для распаковки.

./bin/update_package_nw.sh

Решение 3: То же, что и решение 2, но укажите параметры вручную -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), все настройки инструмента разработчика, все проекты и информация для входа будут удалены.
3. Удалите папку проекта.

• Arch Linux

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

Основной язык текста запроса — китайский.

Текст без перевода:

• 截图1;
• 调试界面;
• wechat-v2ex;
• Changelog;
• %E5%BE%AE%E4%BF%A1%E8%B5%9E%E8%B5%8F%E7%A0%81.

Перевод:

1. Скриншот 1.
2. Интерфейс отладки.
3. Проект взят из wechat-v2ex.
4. Изменения.
5. Код для пожертвований.

Также в тексте есть ссылки, которые не были переведены.