Загрузка COMTool - Загрузка исходного кода COMTool

COMTool

английский | 中文

Кроссплатформенные инструменты последовательной отладки, написанные на Python.

Окна	Линукс	Малиновый Пи	macOS

Белая тема	Темная тема	плагин протокола	TCP/UDP	Терминал	График

Скриншот может быть старой версии, последняя может совсем не та же самая! Но более высокая производительность, более простой в использовании и более элегантный

Функции

Установка

Установить COMTool можно двумя способами:

Загрузите двоичные файлы и запустите: Для Windows или macOS, а также для простых пользователей.
Установить как пакет Python (исходный код): для Linux или необходимо использовать пользователя плагинов или пользователей, знающих о Python.

Установить бинарный файл

Окна

Загрузите последнюю версию bin-файла на странице выпуска или на sourceforge.
Разархивируйте .zip файл и нажмите comtool.exe , чтобы запустить его.

И вы можете установить с помощью совка, поддерживаемого StudentWeis.
 scoop bucket add Nightly https://github.com/StudentWeis/Nightly
scoop install comtool

Линукс

У Linux слишком много версий, поэтому мы компилируем только двоичный файл для Ubuntu. Другие дистрибутивы следует устанавливать из pypi или исходного кода. Если у вас есть идея упаковать кроссплатформенный двоичный файл, например Flatpak или Appimage, вы можете отправить запрос на включение или добавить задачу, чтобы рассказать мне, как это сделать.

Arch Linux и его производные дистрибутивы можно установить из AUR (поддерживается taotieren):
 # Release version
yay -S python-comtool
# Development version
yay -S python-comtool-git

Загрузите выпуск на странице выпуска, извлеките файлы из файла .zip и нажмите comtool для запуска.
Добавьте текущего пользователя в группу набора номера, чтобы избежать команды sudo

sudo usermod -a -G dialout $USER
grep ' dialout ' /etc/group
reboot # must reboot to take effect

Расберри Пи

Откройте терминал, установите зависимости с помощью менеджера пакетов:

sudo apt install git python3-pyqt5 python3-numpy

Используйте диспетчер пакетов для установки pyqt5 numpy и т. д. Этот способ упрощает установку. Если при установке с помощью pip вы столкнулись с какой-либо ошибкой, вы можете сначала попробовать установить с помощью менеджера пакетов. Чтобы найти имя пакета, нужно использовать sudo apt-cache search package_name | grep package_name для поиска имени пакета, а затем установите его.

Затем установите другие пакеты с помощью pip :

 git clone https://github.com/Neutree/COMTool.git --depth=1
cd COMTool
pip3 install . --verbose
# 或者
# python setup.py bdist_wheel
# sudo pip3 install dist/COMTool-*.*.*-py3-none-any.whl --verbose

Добавьте текущего пользователя в группу набора номера, чтобы избежать команды sudo

sudo usermod -a -G dialout $USER
grep ' dialout ' /etc/group
reboot # must reboot to take effect

тогда наслаждайся по команде

 comtool

macOS

Загрузите релиз на странице релиза или на sourceforge.
Установить пакет DMG

Если вы хотите открыть несколько инструментов Comtool, просто щелкните правой кнопкой мыши значок док-станции и выберите New Window .

или вы можете открыть терминал и ввести

 open -n /Application/comtool.app

или

 cd /Applicatioin/comtool.app/Contents/MacOS
./comtool

Поскольку программа не подписана разработчиком, она выдаст предупреждение при первом открытии. Вам нужно зайти в Settings -> Security and Privacy -> General , чтобы увидеть comtool , и нажать Open anyway .

Защитник Windows показывает, что двоичный файл comtool является вредоносным ПО?

Если ваша программа загружена отсюда, все в порядке, ошибка вызвана проблемой с пакетом, весь исходный код и сценарий упаковки находятся здесь, даже процесс упаковки полностью автоматизирован с помощью действия GitHub, никто не упаковывает вручную.

Если у вас все еще есть опасения, просто загрузите исходный код для работы с Python или упакуйте его самостоятельно.

Конечно, если вы найдете лучший способ упаковки, пожалуйста, откройте проблему, чтобы сообщить нам.

Установить пакет Python

Если разработчики или двоичный файл не поддерживают вашу платформу, используйте этот способ установки.

Сначала установите Python3
- Если Windows или macOS: загрузите python3
- Если Linux: например, Ubuntu sudo apt install python3 python3-pip , macOS brew install python3 python3-pip
Убедитесь, что у вас есть pip

pip3 --version
# or
pip --version

Если этой команды нет, установите

python3 -m ensurepip

Затем установите из pypi:

pip3 install comtool
comtool

для китайского языка вы можете использовать зеркала тунца для более быстрой загрузки:

pip install -i https://pypi.tuna.tsinghua.edu.cn/simple comtool

Или вы можете установить напрямую с github.

 pip3 install git+https://github.com/Neutree/COMTool

Или вы можете скачать исходный код, а затем установить из исходного кода.
- загрузить исходный код, загрузить на веб-страницу или git clone https://github.com/Neutree/COMTool.git
- установить

 cd COMTool
pip install .

или создайте свой собственный бинарный код колеса

 pip3 install wheel
python setup.py bdist_wheel
pip install dist/COMTool-*.*.*-py3-none-any.whl
comtool

Если при установке с помощью pip возникла ошибка, вы можете сначала попробовать установить с помощью диспетчера пакетов, а затем снова установить с помощью pip . например

 sudo apt install python3-pyqt5 python3-numpy cython3

Чтобы найти имя пакета, нужно использовать sudo apt-cache search package_name | grep package_name для поиска имени пакета, а затем установите его.

Кстати, вам следует добавить текущего пользователя в группу дозвона, чтобы избежать команды sudo .

sudo usermod -a -G dialout $USER
grep ' dialout ' /etc/group
reboot # must reboot to take effect

Вручную добавить приложение в меню «Пуск» в Linux

Скопируйте инструмент/comtool.desktop в папку /usr/share/applications (для этого может потребоваться пользователь root )
Отредактируйте /usr/share/applications/comtool.desktop , измените путь к значку Icon=/usr/local/COMTool/assets/logo.ico на фактический путь к значку, вы также можете использовать свой значок любви
Затем вы можете найти приложение Comtool в меню «Пуск» (или в центре приложений).

Упаковать двоичный файл

pip3 install pyinstaller
python pack.py
cd dist
ls

Лучше создать виртуальную среду перед пакетом, чтобы уменьшить размер двоичного файла pip install virtualenv virtualenv venv source venv/bin/activate # linux venv/Scripts/activate # windows Если вы обнаружите, running scripts is disabled on this system , вы можете временно разрешить текущий терминал для выполнения сценариев Set-ExecutionPolicy -Scope Process -ExecutionPolicy RemoteSigned Затем pip install pyinstaller и python pack.py

Разработка

Установите python(>=3.8) и pip3.

Линукс:

 sudo apt install python3 python3-pip

Windows: скачать python3

установите пакеты, такие как pyserial , PyQt5 и т. д. (список в файле require.txt)

 cd COMTool
pip3 install -r requirements.txt

На Raspberry python3-pyqt5 можно установить с помощью команды apt :

 sudo pip3 install --upgrade pyserial
sudo apt install python3-pyqt5

клонировать проект

 git clone https://github.com/Neutree/COMTool.git

код, устраняйте ошибки или добавляйте новые свойства

Рекомендуемая PyCharm IDE или vscode для начала

Как запустить: сначала сгенерируйте двоичные файлы перевода ( .mo ).

 python COMTool/i18n.py finish

Затем выполните основную программу

 python COMTool/Main.py

запрос на вытягивание

Напишите свои собственные плагины за считанные минуты

см. документы/plugins.md

Добавить перевод

Сначала установите среду (пакеты Python pip в файле requirements.txt)

apt install python3 python3-pip
pip3 install -r requirements.txt

Если вам нужно добавить новый язык или пропустить

Добавьте локаль в i18n.py

 locales=["en", "zh_CN", "zh_TW", "ja"]

добавьте свой язык в этот список, локали можно найти здесь или в Википедии, например zh_CN означает материковый Китай, соответствующий язык упрощен китайскими иероглифами, zh_TW означает Китай Тайвань, а язык — традиционные китайские иероглифы, вы также можете использовать только zh для использования упрощенных символов Китайские иероглифы.

Создание файлов перевода

python i18n.py prepare

Эта команда создаст файлы .po в папке локалей.

Перевести вручную

Затем переведите файлы .po . Это стандартный формат файла перевода с именем gettext

Создание файлов двоичного перевода

Чтобы программа читалась быстрее, текстовые файлы .po следует преобразовать в двоичные файлы .mo , просто запустите команду:

python i18n.py finish

и затем вы увидите файл locales/<locale>/LC_MESSAGES/messages.mo

Тест

Запустите приложение, вы увидите новый перевод.

Запрос на вытягивание

Создайте PR, чтобы объединить ваши изменения в этот репозиторий.

Настроить тему

В каталоге assets/qss в каталоге исходного кода или двоичной программы скопируйте файл style-dark.qss или style-light.qss , имя файла — style-xxx.qss , здесь xxx — имя темы, чтобы программное обеспечение могло обнаружить тему. Затем измените файл qss в соответствии со своими предпочтениями. Синтаксис qss аналогичен css , но поддержка неполная. Можно ли использовать синтаксис css , зависит от фактического эффекта, ха-ха. Добавление кода темы приветствуется!(PR)

Кроме того, программное обеспечение не было специально оптимизировано для этой темы, а класс и идентификатор могли быть написаны случайно, поэтому нет никакой гарантии, что будущие коды будут полностью совместимы с текущим qss.