Qt5 Interface/ru: what changed

Revision 3 to 4. Removed lines have a minus sign; added lines have a plus sign.

Old	New		Line
1	1		(Qt only)
2	2
3	3		## Введение
4	4
5	5		Этот интерфейс основан на Qt 5 (тестируется Qt 5.6.2). Для получения документации, исправлений и загрузки перейдите на [Project](http://qt-project.org/Qt) (установщик доступен на [странице загрузки 5.6.2](https://download.qt.io/new_archive/qt/5.6/5.6.2/)). Lazarus с интерфейсом Qt5 (qt5-lcl) можно использовать в Windows 32/64, Linux x32/x64/arm, macOS x64 (Cocoa). Наборы виджетов Qt5 были доступны в Lazarus, начиная со стабильной версии 1.8.
6	6
7	7		> Note: С недавних пор российские IP стали баниться. Такова печальная реальность. Поэтому лучше используйте прокси и скачивайте [оффлайн инсталлятор](https://www.qt.io/offline-installers). Устанавливать с него необходимо при отключенном интернете и именно по той же причине
8	8
9	9		Большинство современных дистрибутивов Linux имеют подходящий Qt5 в своих стандартных репозиториях, однако выпуски с долгосрочной поддержкой имеют проблемы из-за их возраста. Ubuntu 16.04 имеет слишком старый QT5.5, а 18.04 содержит проблемную версию libQt5Pas, которую необходимо заменить, см. ниже.
10	10
11	11		------------------------------------------------------------------------
12	12
13	13		Также подробнее об установке "с нуля" под Windows и Linux можно почитать [здесь](https://github.com/zoltanleo/fpc_lazarus_notes/blob/main/README.md#installing_qt_lazarus) (подойдет также для qt6)
14	14
15	15		------------------------------------------------------------------------
16	16
17	17		## Windows
18	18
19	19		Бинарный файл Q5Pas1.dll доступен здесь
20	20
21	21		- x86: <https://gitlab.com/freepascal.org/lazarus/binaries/-/raw/main/i386-win32/qt5/Qt5Pas1.dll?inline=false>
22	22
23	23		а вот готовой 64-битной версии нет.
24	24
25	25		Сборка основана на MinGW, поэтому вы можете использовать библиотеку MinGW Qt (например, qt-opensource-windows-x86-mingw492-5.6.2.exe).
26	26
27	27		Если вам нужно собрать проект cbindings, вам понадобится MinGW. Вы можете использовать MinGW из пакета Qt (qt-opensource-windows-x86-mingw492-5.6.2.exe) — это необязательный компонент установки пакета Qt.
28	28
29	29		### Запуск и развертывание
30	30
31	31		Проект должен быть развернут с использованием Q5Pas1.dll.
32	32
33	33		Файлы .dll Qt5, которые необходимо развернуть, см. в руководствах по Qt5: <https://doc.qt.io/qt-5/windows-deployment.html>.
34	34
35	35		Для пакета на основе MinGW потребуется следующий набор библиотек DLL для запуска одного проекта FORM.
36	36
37	37		Эти библиотеки DLL поставляются с пакетом Qt5 (можно найти в C:\QtQt5.6.2\5.6\mingw49_32\bin).
38	38
39	39
40	40		Qt5Core.dll
41	41
42	42		Qt5PrintSupport.dll
43	43
44	44		Qt5Widgets.dll
45	45
46	46		Qt5Gui.dll
47	47
48	48		Qt5Network.dll
49	49
50	50		libstdc++-6.dll
51	51
52	52		libwinpthread-1.dll
53	53
54	54		libgcc_s_dw2-1.dll
55	55
56	56		Для сборок, основанных на MSVC, а не на MinGW, может потребоваться другой набор dll(не Qt5). Обратите внимание, что [Qt5Pas1.dll](https://gitlab.com/freepascal.org/lazarus/binaries/-/raw/main/i386-win32/qt5/Qt5Pas1.dll?inline=false) собран для Qt5-5.6.2, но Qt5Pas1.dll можно использовать с любым Qt5 \> 5.6.2.
57	57
58	58		## Linux
59	59
60	60		### Lazarus
61	61
62	62		![Image of Qt5 selected](/wiki-images/4/46/SelectQt5.png)Lazarus «из коробки» в Linux использует и создает приложения для GTK2. Он не помечен как имеющий зависимость от Qt5, поэтому, если вы хотите создавать приложения Qt5 или собирать версию Lazarus для Qt5, вам, вероятно, потребуется установить «libQt5Pas-dev», используя репозиторий вашего дистрибутива:
63	63
64	64		- Fedora, Mageia - sudo dnf install qt5pas-devel \<enter\>
65	65		- Ubuntu, Debian — sudo apt install libqt5pas-dev \<enter\>
66	66
67	67		это добавит необходимые библиотеки Qt5 в качестве зависимостей, обычно около 50 МБ в системе, в которой нет существующих потребностей Qt5. Если вы хотите использовать версию Lazarus для Qt5, выполните сборку из исходного кода с помощью такой команды, как
68	68
69		-	~~` make bigide LCL_PLATFORM=qt5 <enter>`~~
	69	+	```text
	70	+	make bigide LCL_PLATFORM=qt5 <enter>
	71	+	```
70	72
71	73		но обратите внимание, что по умолчанию GTK2 Lazarus с удовольствием создаст для вас приложения Qt5.
72	74
73	75		В Lazarus, чтобы выбрать сборку приложения Qt5, сделайте так: Projects --\> ProjectOptions --\> Additions and Overrides, нажмите Set "LCLWidgetType" и выберите Qt5 для текущего режима сборки. А еще лучше добавить специальный режим сборки для Qt5, может быть, релиз и отладку.
74	76
75	77		> Note: если вы устанавливаете Lazarus, используя версию Lazarus вашего дистрибутива, вам может потребоваться специально запросить компоненты Qt5 LCL. Если вы устанавливаете из исходного кода, вы получите намного больше с самого начала.
76	78
77	79		Не забудьте, что при релизе вашего приложения оно должно быть помечено как зависимое от libqt5pas1.
78	80
79	81		### libqt5pas
80	82
81	83		libqt5pas — это библиотека, связывающая Qt5 и ваше приложение Lazarus. Более новые дистрибутивы (U20.04, Debian Buster и т.д.) имеют рабочие версии, доступные в их репозиториях. Отметьте свое приложение как зависимое от libqt5pas1 и все будет в порядке. Вам, как разработчику, использующему Qt5, также понадобится libqt5pas-dev, как упоминалось выше.
82	84
83	85		> Note: если вы используете версию Lazarus более позднюю, чем 2.2.0, вам (и вашим конечным пользователям) потребуется libQt5Pas выше или равной 1.2.10. Дистрибутивам потребуется некоторое время, чтобы обновить версию, которую они распространяют, поэтому либо создайте свою собственную, либо используйте неофициальные <https://github.com/davidbannon/libqt5pas/releases/latest> debs и rpms, как указано ниже. Помните, что вашим конечным пользователям тоже нужна версия 1.2.10!
84	86
85	87		Использование вашего репозитория дистрибутивов -
86	88
87	89		- Fedora, Mageia - sudo dnf install qt5pas\<enter\>
88	90		- Ubuntu, Debian - sudo apt install libqt5pas1 \<enter\>
89	91
90	92		#### Проблема с версией?
91	93
92	94		Версия libQt5Pas вызовет проблемы у следующих людей, помните, что это влияет на вас, как на разработчика, и на ваших конечных пользователей.
93	95
94	96		- Пользователи очень старых дистрибутивов Linux, таких как Ubuntu 16.04 - жаль, нет решения, не используйте Qt5, если вам нужна поддержка таких операционных систем.
95	97		- Старые дистрибутивы Linux, такие как U18.04, официально поддерживаются до 2023 года, но используют неподходящий libQt5Pas. Вы увидите сбой, если ваше приложение использует TMemo. Замените существующий libQt5Pas.
96	98		- Текущие дистрибутивы LTS, такие как 20.04 (и, возможно, 22.04, Debian Bullseye и т. д.), будут иметь libQt5Pas более ранней, чем 1.2.10, и это проблема, если вы используете версию Lazarus более позднюю, чем 2.2.0. Опять же, вы можете заменить существующий libQt5Pas
97	99
98	100		Замена своего libQt5Pas?
99	101
100	102		Два варианта: используйте Deb- или RPM-пакеты из <https://github.com/davidbannon/libqt5pas/releases/latest> — вы должны убедиться, что ваш менеджер пакетов не возражает, или даже заменить ваш новый сияющий файл другим из предпочитаемого дистрибутива. Пишите на форуме, если вам нужно что-то кроме 64-битных Deb и RPM (Signing, 32bit, Pacman и т.д.). Установите, например, с помощью
101	103
102		-	~~` sudo apt install ./libqt5pas1_2.10-0_amd64.deb <enter> `~~
	104	+	```text
	105	+	sudo apt install ./libqt5pas1_2.10-0_amd64.deb <enter>
	106	+	```
103	107
104	108		Как разработчику, вам также понадобится dev-пакет, удалите существующий, если он есть.
105	109
106	110		Во-вторых, в исходниках Lazarus есть код для создания собственной библиотеки, вам понадобится gcc и несколько других вещей, задокументированных в README.txt. Затем скопируйте новую библиотеку поверх существующей libQt5Pas1 (конечно, как root)
107	111
108	112		Примечание 1 Эти два пакета deb созданы для Ubuntu 18.04 (или более поздней версии), они совершенно не помогут в Ubuntu 16.04, так как его основные библиотеки Qt5 слишком устарели.
109	113
110	114		Примечание 2 Ubuntu будет постоянно перезаписывать эту пару обновленных пакетов с помощью инструмента «автоматического обновления». Вы должны занести пакеты в черный список, чтобы средство автоматического обновления не испортило вашу хорошую работу.
111	115
112	116		### Системы, использующие Wayland
113	117
114	118		Некоторые дистрибутивы используют Wayland по умолчанию (например, Fedora по умолчанию с рабочим столом GNOME), а QT5 не работает с Wayland. Вы получите сообщение вида:
115	119
116	120		QSocketNotifier: Can only be used with threads started with QThread
117	121		[FORMS.PP] ExceptionOccurred
118	122		....
119	123
120	124		Выйдите из системы, на экране входа щелкните маленький значок шестеренки, выберите «GNOME on XOrg». Войдите снова.
121	125
122	126		Есть, видимо, плагин Wayland для Qt5, для смелых - <https://wayland.freedesktop.org/qt5.html>
123	127
124	128		### Цвета Qt5
125	129
126	130		В Linux иногда приложения Qt5 наследуют используемые цвета от рабочего стола/ОС. Однако это не всегда работает и, по-видимому, зависит от дистрибутива/рабочего стола. С нынешней модой на темные темы более надежным подходом является использование qt5ct. qt5ct присутствует в репозитории большинства дистрибутивов, и его можно быстро и легко установить. Когда вы запускаете его, он открывается на вкладке «Внешний вид», для темной темы выберите «Палитра = Пользовательская», «Цветовая схема» = «Темная». Нажмите «Применить» и «ОК», чтобы закрыть приложение.
127	131
128	132		![](/wiki-images/6/6d/Qt5ct_dark.png)
129	133
130	134		Вы заметили сообщение вверху «Приложение настроено неправильно»? Его беспокоит то, что вы не добавили настройку переменной среды, которая укажет вашему приложению использовать только что установленные цвета. Вы можете задать его только для одного приложения, установив его в командной строке приложения:
131	135
132	136		QT_QPA_PLATFORMTHEME=qt5ct myapplication
133	137
134	138		Это может быть добавлено в файл рабочего стола приложения или, возможно, вы отредактируете пункт меню. Альтернативой является добавление его в /etc/environment (очевидно, без имени приложения), чтобы оно автоматически устанавливалось для всех приложений, вам нужно выйти из системы и снова войти. Добавление записи в собственный .bashrc не совсем уместно, поскольку приложения с графическим интерфейсом, запускаемые, например, из меню, не будут об этом уведомлены.
135	139
136	140		> Note: В Debian при установке qt5ct автоматически добавляется QT_QPA_PLATFORMTHEME в переменные среды.
137	141
138	142		### Почему Qt5, а не GTK?
139	143
140	144		Хороший вопрос! Большинство приложений Linux Lazarus создаются с использованием GTK2 по умолчанию. Различные дистрибутивы Linux предоставляют все меньше и меньше приложений GTK2, обычно «обновляя» их до GTK3. Тем не менее, интерфейс Lazarus GTK3 все еще нуждается в некоторой доработке, и он еще не готов для производственных систем. До конца 2019 года это не имело большого значения, GTK2 работает нормально. Но Ubuntu19.10 не имеет библиотек GTK2, установленных по умолчанию, и Xfce объявил, что его следующий выпуск будет свободен от GTK2, по-видимому, многие дистрибутивы хотят исключить GTK2 из своих наборов по умолчанию. Хотя вы все еще можете установить GTK2, он довольно большой....
141	145
142	146		Qt5 — очевидное решение, оно уже установлено в таких дистрибутивах, как Fedora 30 plus, это относительно легкое дополнение к Ubuntu, всего 48 мегабайт по сравнению с 445 мегабайтами GTK2. Если вы пометите свое приложение как зависимое от libqt5pas, оно будет установлено одновременно с другими файлами qt5, если это необходимо. Ручная установка libqt5pas с помощью вашего менеджера пакетов (при условии, что он разрешает зависимости!) также будет работать.
143	147
144	148		Очевидно, что дистрибутивы на основе Qt, использующие Plasma или KDE в качестве рабочего стола, потребуют только libqt5pas.
145	149
146	150		## macOS (64-бит)
147	151
148	152		Следующие шаги были протестированы с macOS 10.13.6 (High Sierra), инструментами командной строки Xcode 10.0.0 (Xcode не требуется), Lazarus 1.8.4 и минимальной версией Qt 5.6.2 (Qt 5.12.xx тоже работает без проблем).
149	153
150	154		После установки Qt 5.6.2 (см. выше) откройте окно терминала и выполните следующие команды (пути могут отличаться):
151	155
152	156		export LazarusDir=/Developer/Lazarus
153	157		export QtDir=~/Qt5.6.2
154	158		cd $LazarusDir/lcl/interfaces/qt5/cbindings
155	159		export PATH=$QtDir/5.6/clang_64/bin:$PATH
156	160		qmake
157	161
158	162		Если qmake завершается со следующей ошибкой:
159	163
160	164		xcode-select: error: tool 'xcodebuild' requires Xcode, but active developer directory '/Library/Developer/CommandLineTools' is a command line tools instance
161	165
162	166		это не означает, что вы должны установить Xcode. См. обходной путь [Qt без Xcode](https://gist.github.com/shoogle/750a330c851bd1a924dfe1346b0b4a08) и попробуйте снова запустить `qmake`. (Зависимость от Xcode, кажется, исправлена в Qt 5.9.4 или, возможно, ранее.)
163	167
164	168		Продолжайте процесс сборки с помощью следующих команд:
165	169
166	170		make
167	171		make install
168	172
169	173		Может быть полезно добавить символические ссылки в Qt5Pas.framework и другие файлы *.framework (чтобы не требовалось никаких изменений в пути):
170	174
171	175		cd /Library/Frameworks/
172	176		sudo ln -s $QtDir/5.6/clang_64/lib/*.framework .
173	177
174	178		Помните, что Qt5 является 64-битным, поэтому в Lazarus в разделеTools - Options - Environment вам нужно изменить исполняемый файл компилятора с `/usr/local/bin/ppc386` на `/usr/local/bin/ppcx64`. При использовании ppc386 вы позже получите следующие ошибки при компиляции ваших проектов Lazarus:
175	179
176	180		Error: linker: Undefined symbols for architecture i386:
177	181		Error: linker: "_QAbstractButton_click", referenced from:
178	182		[...]
179	183		ld: symbol(s) not found for architecture i386
180	184
181	185		Наконец, создайте новый проект Lazarus (или откройте существующий), откройте Project - Project options - Compiler options - Additions and overrides, установите `LCLWidgetType:=qt5`. Теперь вы сможете скомпилировать свой проект с набором виджетов Qt5.
182	186
183	187		## Пример проекта
184	188
185	189		См. [Первые шаги с интерфейсом Lazarus Qt5](https://tondrej.blogspot.com/2018/04/first-steps-with-lazarus-qt5-interface.html) для примера проекта для Win32, Win64, macOS (64-разрядная версия) и Linux (64 бит).
186	190
187	191		---
188	192		From the Free Pascal wiki, page "Qt5 Interface/ru", as it stood on 2022-12-20 after a change by Zoltanleo, out of the wiki's dump of 2024-05-26. Copyright stays with the author who wrote it, according to the old wiki's [[Licensing]] page. If you have concerns about this material, [message the admin](/wiki-contact).

Back to history