ZeppPlayer
Эта программа позволяет запускать программы и циферблаты для ZeppOS прямо в браузере на вашем ПК. Удобно для разработки, быстрее и проще чем официальный эмулятор, пусть и с меньшей совместимостью.
Системные требования
- Windows 10+, или macOS Catalina+, или любой Linux с python3
- Браузер на базе Chromium, лучше всего чистый Chromium или Google Chrome. Другие браузеры, вроде Firefox, не поддерживаются и плеер в них может работать некорректно
Установка
Загрузить архив для вашей ОС, распакуйте куда-нибудь.
Пользователи Windows/macOS, просто запустите программу файлом ZeppPlayer.
Пользователи Linux должны страдать чуть больше. Установите на систему пакеты
python3
и python3-venv
, после чего из папки с программой запустите ./start.sh
.
Этот скрипт создаст venv, установит зависимости и запустит плеер. Просто подождите,
скорее всего всё запустится. В случае проблем, увидеть логи можно запустив программу с параметром dev
, то есть командой ./start.sh dev
.
Как добавить свои циферблаты/приложения
Поместите их в папку projects
. Если у вас есть лишь файл bin
, переименуйте
его в zip
и распакуйте.
В Windows/linux, папка с проектами лежит рядом с программой. В macOS,
она находится по пути ~/Library/Application Support/ZeppPlayer
. Проще
всего её найти, запустив плеер и выбрав пункт <file manager>
в списке
проектов (слева сверху).
Как завершить плеер
Найдите значок программы в области уведомлений, нажмите правой кнопкой мыши на него и выберите пункт "Exit".
Примечания
- Избегайте объявления переменных без var/let/const. Такие переменные по идее становятся глобальными, а современным браузерам такое не очень нравится;
- У настоящего браслета (Xiaomi Smart Band 7) есть некоторые проблемы с математикой, в особенности с делением и сравнением чисел. Эмулировать эти проблемы не представляется возможным, просто имейте это ввиду;
- Если в параметры виджета добавить свойство
_name
, это значение будет отображаться в Explorer-е в качестве названия виджета. Пример использования можно найти в комплектном циферблате demo.
(доп.) Установка через nodeJS для использования в терминале
Требуется nodeJs и npm.
Откройте терминал/командную строку в папке с программой и выполните (пользователи macOS для этого должны скачать linux-сборку программы):
npm i
npm i -g .
Подождите немного. После этого вы сможете генерировать превьюшки вызовом
zepp-player
в консоли:
zepp-preview [command]
Commands:
zepp-preview <projects...> Preview a list of projects
Options:
--help Show help [boolean]
--version Show version number [boolean]
--gif With GIF preview [boolean]
--png With PNG preview [boolean] [default: true]
-o Output path, {} will be replaced with current project path
[string] [default: "{}"]