Создаём окружение для PyQt5 в Linux MInt (Ubuntu)

в 9:45, , рубрики: mint, pyqt5, python, python3, qt, qt5, Ubuntu

image image image
Давно уже до пятой версии обновился Qt и вместе с ним PyQt, но найти информацию по ним в русскоязычном сегменте — задача не из простых. Под катом подробный туториал для тех, кто только начинает знакомиться со связкой Qt + python3.

Цель: собрать и настроить окружение, пройти путь от установки PyQt5 и создания формы в Qt Designer до запуска переносимого бинарника.

Пути установки

Исходя из того, что мы — совсем новички, я постараюсь использовать пути в системе, которые используются по-умолчанию, или которые мы создадим исходя из следующей логики размещения:

  • Все необходимые файлы и папки хранятся в директории dev в домашней директории пользователя, т.е. ~/dev/
  • Мы будем использовать виртуальные окружения для питона, и хранить их будем в директории envs, т.е. ~/dev/envs/
  • Наши проекты будут храниться в директории src, т.е. ~/dev/src/

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

Настройка окружения

Создаём структуру директорий. Откройте консоль и выполните:

cd ~
mkdir -p dev/envs dev/src
cd dev/envs

Ставим пакет, который потребуется нам для сборки в будущем:

sudo apt-get install python3-dev

Ставим pip и virtualenv:

wget https://bootstrap.pypa.io/get-pip.py
sudo python3 get-pip.py
rm get-pip.py
sudo pip install virtualenv

Создаём виртуальное окружение, активируем его и обновляем пакеты:

virtualenv --prompt="[pyqt5] " pyqt5
source pyqt5/bin/activate
pip install -U pip setuptools

Ставим Qt5. При выборе пути установки я оставил «по-умолчанию» ~/Qt. Если Вы выберите другой, то необходимо менять пути в командах ниже:

# Для x64-архитектуры
# http://www.qt.io/download-open-source/#section-2
wget http://download.qt-project.org/official_releases/online_installers/qt-opensource-linux-x64-online.run
chmod u+x qt-opensource-linux-x64-online.run
./qt-opensource-linux-x64-online.run
rm qt-opensource-linux-x64-online.run

# Для x86-архитектуры
# http://www.qt.io/download-open-source/#section-2
# wget http://download.qt-project.org/official_releases/online_installers/qt-opensource-linux-x86-online.run
# chmod u+x qt-opensource-linux-x86-online.run
# ./qt-opensource-linux-x86-online.run
# rm qt-opensource-linux-x86-online.run

Ставим SIP — модуль, необходимый для работы PyQt:

# http://www.riverbankcomputing.com/software/sip/download
wget http://sourceforge.net/projects/pyqt/files/sip/sip-4.16.5/sip-4.16.5.tar.gz
tar xvzf sip-4.16.5.tar.gz
cd sip-4.16.5/
python configure.py -d ~/dev/envs/pyqt5/lib/python3.4/site-packages/
make
sudo make install
sudo make clean
cd ..
rm -rf sip*

Ставим PyQt:

wget http://sourceforge.net/projects/pyqt/files/PyQt5/PyQt-5.4/PyQt-gpl-5.4.tar.gz
tar xvzf PyQt-gpl-5.4.tar.gz
cd PyQt-gpl-5.4/
# У меня под рукой только x64-архитектура, поэтому моя команда выглядит именно так.
# Если же у вас x86, то путь ~/Qt/5.4/gcc_64/bin/qmake будет выглядеть иначе.
# Буду признателен, если в комментариях подскажут, как именно
python configure.py --destdir ~/dev/envs/pyqt5/lib/python3.4/site-packages/ --qmake ~/Qt/5.4/gcc_64/bin/qmake
make
sudo make install
sudo make clean
cd ..
rm -rf PyQt*

На этом всё. Окружение установлено и готово к работе. Для проверки выполните команду:

python -c "from PyQt5.QtCore import QT_VERSION_STR;from PyQt5.Qt import PYQT_VERSION_STR;from sip import SIP_VERSION_STR;print('Qt version: ',QT_VERSION_STR);print('SIP version: ',SIP_VERSION_STR);print('PyQt version: ',PYQT_VERSION_STR)"

Ответ должен выглядеть следующим образом:

Qt version:  5.4.0
SIP version:  4.16.5
PyQt version:  5.4

Для проверки, что всё действительно установилось в виртуальное окружение, откройте новое окно терминала и повторите команду проверки:

В ответ должна появиться ошибка ImportError. Новое окно терминала после этого можно закрыть.

Создание приложения

Перейдём в директорию с нашими исходниками и создадим директорию проекта:

cd ../src/
mkdir pyqt_test
cd pyqt_test/

Далее нам потребуется Qt Designer. Если Вы не меняли пусть установки Qt, то запустить его можно командой:

# И вновь эта команда будет работать только для x64-архитектуры.
# Для x86 вместо gcc_64 вероятнее всего будет иная директория.
~/Qt/5.4/gcc_64/bin/designer

Вот так выглядит запущенный Qt Designer на моей системе:
Создаём окружение для PyQt5 в Linux MInt (Ubuntu) - 4
В данном руководстве я не буду подробно останавливаться на описании интерфейса дизайнера, мы пройдём простейший путь до минимальной готовой формы. Если Вам необходима более подробная информация — Google It!

В диалоговом окне выбираем «Widget» (последний пункт в списке «templates/forms») и нажимаем кнопку «Создать». Откроется форма редактирования виджета:
Создаём окружение для PyQt5 в Linux MInt (Ubuntu) - 5

Перетащите на форму кнопку из меню слева и сохраните полученную форму с именем test.ui в директорию ~/dev/src/pyqt_test/:
Создаём окружение для PyQt5 в Linux MInt (Ubuntu) - 6
Tips&Tricks: Нажав [Crtl + R] Вы можете запустить свою форму и «потрогать» её в режиме реального времени.

Конвертируем файл интерфейса из XML формы в понятную python форму:

pyuic5 test.ui > test_ui.py

Я не хочу редактировать что-либо в файле, созданном конвертером PyQt, поэтому наши слоты мы опишем в отдельном файле. Создайте файл test_slots.py и откройте его в любимом Вами редакторе. Наполнение файла должно выглядеть примерно так:

"""
Пользовательские слоты для виджетов.
"""
# Импортируем модуль времени
from datetime import datetime
# Импортируем класс интерфейса из созданного конвертером модуля 
from test_ui import Ui_Form


# Создаём собственный класс, наследуясь от автоматически сгенерированного
class MainWindowSlots(Ui_Form):
    
    # Определяем пользовательский слот
    def set_time(self):
        # Получаем текущую метку времени в формате 'Ч:М:С'
        str_time = datetime.now().strftime('%H:%M:%S')
        # Присваиваем надписи на кнопке метку времени
        self.pushButton.setText(str_time)
        return None

Затем, создайте ещё один файл с именем main.py, в котором мы опишем основную логику:

"""
Основной скрипт программы.
Запускает конфигуратор окна, подключает слоты и отображает окно.
"""
# Импортируем системый модуль для корректного закрытия программы
import sys
# Импортируем минимальный набор виджетов
from PyQt5.QtWidgets import QApplication, QWidget
# Импортируем созданный нами класс со слотами
from test_slots import MainWindowSlots


# Создаём ещё один класс, наследуясь от класса со слотами
class MainWindow(MainWindowSlots):

    # При инициализации класса нам необходимо выпонить некоторые операции
    def __init__(self, form):
        # Сконфигурировать интерфейс методом из базового класса Ui_Form
        self.setupUi(form)
        # Подключить созданные нами слоты к виджетам
        self.connect_slots()

    # Подключаем слоты к виджетам
    def connect_slots(self):
        self.pushButton.clicked.connect(self.set_time)
        return None

if __name__ == '__main__':
    # Создаём экземпляр приложения
    app = QApplication(sys.argv)
    # Создаём базовое окно, в котором будет отображаться наш UI
    window = QWidget()
    # Создаём экземпляр нашего UI
    ui = MainWindow(window)
    # Отображаем окно
    window.show()
    # Обрабатываем нажатие на кнопку окна "Закрыть"
    sys.exit(app.exec_())

На этом наше приложение завершено. Выполнив из консоли

python main.py

мы должны увидеть форму с кнопкой посередине, нажатие на которую меняет название кнопки на системную дату.
Создаём окружение для PyQt5 в Linux MInt (Ubuntu) - 7

Упаковка в исполняемый файл для Linux

Упаковщик потребует некоторой магии при установке.
Скачиваем пакет, не устанавливая его и распаковываем:

cd ../../envs/pyqt/
pip install -d . cx_freeze
tar xvfz cx_Freeze-4.3.4.tar.gz

Открываем любимым редактором файл cx_Freeze-4.3.4/setup.py. Я использую SublimeText:

subl cx_Freeze-4.3.4/setup.py

Правим строку №84, чтобы она выглядела, как на картинке:
Создаём окружение для PyQt5 в Linux MInt (Ubuntu) - 8
Tips&Tricks: А вы знали, что если запустить SublimeText из виртуального окружения, то интерпретатором по-умолчанию будет из виртуального окружения?

Сохраняем изменения, закрываем редактор, устанавливаем пакет, возвращаемся в папку с исходниками, запускаем упаковку:

cd cx_Freeze-4.3.4
python setup.py install
rm ../cx_Freeze-4.3.4.tar.gz
cd ../../../src/pyqt_test
cxfreeze main.py

После этого в директории с исходниками появится директория dist, в которой среди множества файлов можно заметить файл без расширения main — это и есть наш бинарник, готовый для запуска и переноски. Откровенно говоря, немного расстраивает размер дистрибьютива: на моей машине это — 70,1 Мб, но не стоит забывать, что туда упакованы: python, PyQt, Qt и некоторые общесистемные библиотеки. Сборочный скрипт cxfreeze достаточно гибко конфигурируется, но подбор оптимальных параметров я оставлю на совести читателя. Скажу только, что счастье кроется в сжатии, оптимизации и ручном ограничении зависимостей.

P.S.: Все исходники на GitHub`е

Автор: ZAhmed

Источник


* - обязательные к заполнению поля


https://ajax.googleapis.com/ajax/libs/jquery/3.4.1/jquery.min.js