Qt Environment Deployment - Ubuntu

Was ist die Qt-Umgebung?

Qt ist ein plattformübergreifendes C++-Entwicklungsframework für grafische Benutzeroberflächenanwendungen, mit dem Sie leistungsstarke Desktop-, Mobil- und Webanwendungen erstellen können. Es kann auch zur Entwicklung von Nicht-GUI-Programmen wie Konsolentools und Servern verwendet werden. Qt ist ein objektorientiertes Framework, das spezielle Codegenerierungs-Erweiterungen und einige Makros nutzt. Qt ist einfach zu erweitern und ermöglicht echten Komponenten-Programmierstil.

Ubuntu 18/20 Deployment

Firefly bietet ein entsprechendes Qt-Umgebungspaket für das auf Firefly-Produkten laufende Ubuntu 18/20-System an, das eine schnelle Bereitstellung und Entwicklung ermöglicht. Die Umgebungen der beiden Systeme sind nicht austauschbar. Bitte wählen Sie die entsprechende Umgebung gemäß der auf Ihrem Firefly-Gerät laufenden Systemversion aus.

Wenn Sie ein Umgebungspaket benötigen, wenden Sie sich bitte an uns, um es anzufordern.

Das Umgebungspaket nutzt einen Cross-Compilation-Modus, um ausführbaren Code auf einer Plattform für eine andere Plattform zu generieren. Wir müssen auf einem Linux-Computer mit x86_64-Architektur entwickeln und kompilieren und die kompilierte ausführbare Datei auf das Zielgerät mit Arm64-Architektur zum Ausführen legen. Daher muss das Umgebungspaket sowohl auf dem Host als auch auf dem Gerät bereitgestellt werden.

Hinweis: Es gibt geringfügige Unterschiede zwischen verschiedenen Versionen der Umgebungspakete. Die folgenden Abschnitte zur Bereitstellung und Umgebungseinrichtung können nur einer zur Erklärung verwendet werden. Bitte beziehen Sie sich auf die im Umgebungspaket enthaltene Dokumentation für die spezifische Verwendung.

Hostseitige Bereitstellung

Bezüglich der Wahl des Hosts: Bitte verwenden Sie einen Host mit demselben System wie das Zielgerät zur Entwicklung.

Beispielsweise, wenn Sie ein Qt-Programm für ein Firefly-Gerät mit Ubuntu 20 entwickeln müssen, sollte der Host ebenfalls ein Computer mit Ubuntu 20 sein.

1. Start der Bereitstellung

Entpacken Sie das Umgebungspaket auf Ihrem Computer und wechseln Sie in das entpackte Verzeichnis, um die Bereitstellung zu starten. Dies gliedert sich hauptsächlich in 3 Schritte:

1. # Kopieren Sie die Datei in das Systemverzeichnis /opt/
2. cp -rfd firefly_qt5.15_arm64_20.04 /opt/
4. # Kopieren Sie sysroot in das Verzeichnis /opt/
5. cp -rfd sysroot /opt/
7. # Kopieren Sie die Umgebungsvariablen-Datei in /etc/profile.d/
8. cp host/host_qtEnv.sh /etc/profile.d

2. Umgebungseinrichtung

Installieren Sie den Cross-Compiler.

1. sudo apt update
2. sudo apt install -y crossbuild-essential-arm64

Melden Sie sich dann erneut an oder starten Sie den Computer neu, um sicherzustellen, dass die zuvor kopierten Umgebungsvariablen wirksam werden.

3. Überprüfung

Das Komprimierungspaket enthält auch einen Beispielordner mit mehreren einfachen Qt-Demos, die verwendet werden können, um zu überprüfen, ob die Umgebung erfolgreich eingerichtet wurde. Wenn alles gut geht, bedeutet dies, dass die Umgebung erfolgreich bereitgestellt wurde.

1. # Beispielsweise verwenden Sie analogclock zur Überprüfung
2. cd example/analogclock
4. # Führen Sie qmake aus, um das Kompilierungssystem automatisch zu generieren
5. qmake
7. # Führen Sie make aus, um die Kompilierung zu starten
8. make

Gerätebereitstellung

1. Start der Bereitstellung

Entpacken Sie das Umgebungspaket auf Ihrem Computer und wechseln Sie in das entpackte Verzeichnis, um die Bereitstellung zu starten. Dies gliedert sich hauptsächlich in 2 Schritte:

1. # Kopieren Sie den ext-Teil in das Systemverzeichnis /opt/. Beachten Sie, dass ext in firefly_qt5.15 umbenannt wird
2. cp -rfd firefly_qt5.15_arm64_20.04/ext /opt/firefly_qt5.15
4. # Kopieren Sie die Umgebungsvariablen-Datei in /etc/profile.d/
5. cp target/target_qtEnv.sh /etc/profile.d/

2. Umgebungseinrichtung

Sie müssen auch einige notwendige Bibliotheken auf dem Gerät installieren:

1. apt install -y libmtdev1 libinput10 libxkbcommon0 </code>

libdouble-conversion3 libicu66 libharfbuzz0b </code>

libwebpdemux2 libwebpmux3

Öffnen Sie "/etc/profile.d/target_qtEnv.sh", und Sie werden drei auskommentierte Umgebungsvariablen sehen:

1. #XCB
2. #export QT_QPA_PLATFORM=XCB
3. #export QT_QPA_EGLFS_INTEGRATION=XCB_EGL
5. #LinuxFB
6. #export QT_QPA_PLATFORM=LINUXFB
7. #export QT_QPA_FB_DRM=1
9. #EGLFS
10. #export QT_QPA_PLATFORM=EGLFS
11. #export QT_QPA_EGLFS_INTEGRATION=EGLFS_KMS #in minimal ubuntu, use eglfs_kms.
12. A_EGLFS_KMS_ATOMIC=1 #use drm atomic api or legacy api(two different)
13. #export QT_QPA_EGLFS_HIDECURSOR=1 #hide cursor

Entfernen Sie die Kommentare des entsprechenden Teils gemäß der von Ihnen gewünschten QPA_PLATFORM. Beispielsweise wird XCB in der Ubuntu-Umgebung üblicherweise verwendet. Entfernen Sie die Kommentare dieses Teils, speichern Sie die Datei und verlassen Sie den Editor.

1. #XCB
2. export QT_QPA_PLATFORM=XCB
3. export QT_QPA_EGLFS_INTEGRATION=XCB_EGL

Wenn Sie XCB verwenden, müssen Sie einige zusätzliche Bibliotheken installieren:

1. apt install -y libxcb-icccm4 libxcb-image0 libxcb-shm0 </code>

libxcb-keysyms1 libxcb-render0 libxcb-render-util0 </code>

libxcb-shape0 libxcb-sync1 libxcb-xfixes0 </code>

libxcb-xinerama0 libxcb-xkb1 libxcb-randr0 </code>

libsm6 libice6 libxkbcommon-x11-0

Führen Sie schließlich "reboot" aus, um das Gerät neu zu starten.

3. Überprüfung

Übertragen Sie die auf der Hostseite kompilierte ausführbare Datei auf das Gerät und führen Sie sie aus. Wenn sie normal läuft, bedeutet dies, dass die Geräteumgebung erfolgreich eingerichtet wurde.

1. LD_LIBRARY_PATH=/opt/firefly_qt5.15/lib ./analogclock

Ubuntu 22 Deployment

Wenn das Ziel-Firefly-Gerät Ubuntu 22 ausführt, ist keine Cross-Compilation-Entwicklung erforderlich, und die Installation von Qt ist viel einfacher und bequemer.

Firefly hat die Qt-Umgebung für Ubuntu 22 in ein deb-Paket verpackt, das auf dem Zielgerät mit apt installiert werden kann:

1. # Installieren Sie die Basisumgebung
2. apt update
3. apt install -y qtcreator qtbase5-dev
5. # Installieren Sie zusätzliche Qt-Komponenten und Entwicklungsumgebungen gemäß den Entwicklungsanforderungen, wie z.B.
6. apt install -y libqt5multimedia5 qtmultimedia5-dev libqt5quick5 qtdeclarative5-dev

Qt Creator-Konfiguration

Bei der Qt-Entwicklung wird häufig Qt Creator als IDE verwendet. Im vorherigen Teil haben wir die Qt-Entwicklungsumgebung eingerichtet. Im Folgenden wird erläutert, wie Sie sicherstellen können, dass Qt Creator die von Ihnen eingerichtete Umgebung verwendet und nicht die mit der IDE mitgelieferte oder eine andere Umgebung.

Ubuntu 18/20

Auf der Hostseite können Sie Qt Creator mit dem folgenden Befehl schnell installieren:

1. sudo apt update
2. sudo apt install qtcreator

Nach dem Start von Qt Creator klicken Sie zunächst auf "Werkzeuge" -> "Optionen", um die Einstellungsoberfläche zu öffnen:

Wählen Sie dann "Qt-Versionen" und klicken Sie auf "Hinzufügen", um die Qt-Version hinzuzufügen:

Wählen Sie im geöffneten Fenster die zuvor in das Verzeichnis /opt kopierte Qt-Umgebung aus:

Hinweis: Der Pfad hier kann je nach Version des Umgebungspakets variieren, aber am Ende müssen Sie den Speicherort von qmake unter /opt auswählen.

Sie können der neu hinzugefügten Qt-Version einen Namen geben und dann auf "Anwenden" klicken, um die Hinzufügung zu bestätigen:

Wählen Sie dann die Seite "Kits" und fügen Sie ein neues Kit hinzu:

Konfigurieren Sie das neue Kit wie folgt:

Bedeutung der Konfiguration: Benennen Sie zunächst das Kit, um es leicht identifizieren zu können. Wählen Sie als "Gerätetyp" "Allgemeines Linux-Gerät". Der Schwerpunkt liegt auf den folgenden drei Konfigurationen. Wählen Sie für "Sysroot" das zuvor in das Verzeichnis /opt kopierte sysroot aus. Wählen Sie für den Compiler den 64-Bit-GCC für ARM aus. Wählen Sie für die Qt-Version die in einem vorherigen Schritt hinzugefügte Qt-Version aus und klicken Sie dann auf "Anwenden", um die Änderungen zu übernehmen.

Schließlich können Sie ein Projekt öffnen und unser neu hinzugefügtes Kit auswählen, um zu kompilieren. Wenn die Kompilierung erfolgreich ist, bedeutet dies, dass unsere Konfiguration korrekt ist:

Ubuntu 22

Das Zielgerät verwendet das Ubuntu 22-System, und es ist keine Cross-Compilation erforderlich. Daher wird Qt Creator direkt auf dem Gerät installiert.

Da die Qt-Umgebung über apt installiert wird, sollte Qt Creator beim Öffnen automatisch den Speicherort von qmake erkennen:

Der von Qt Creator automatisch erkannte Pfad für qmake lautet "/usr/lib/qt5/bin/qmake". Daher müssen Sie keine Qt-Version manuell hinzufügen.

Bei der Kit-Konfiguration wird kein Sysroot festgelegt, da keine Cross-Compilation erforderlich ist. Wählen Sie für die Qt-Version die automatisch erkannte Qt-Version aus. Der Rest der Konfigurationen kann gleich wie im vorherigen Kapitel bleiben.

Häufig gestellte Fragen

1. Entpacken fehlgeschlagen

Falls Sie beim Entpacken des Umgebungspakets diesen Fehler erhalten:

1. tar: xxxxx: Directory renamed before its status could be extracted
2. tar: Exiting with failure status due to previous errors

Sie können dem tar-Befehl den Parameter -P hinzufügen und erneut versuchen, es zu entpacken, z.B.:

1. tar -Pzxf firefly_arm64_qt5.15_20.04_20230415.tgz

2. Konflikt zwischen mehreren Qt-Versionen

Falls beim Ausführen eines Qt-Programms die Qt-Bibliothek nicht gefunden werden kann:

1. ./analogclock: symbol lookup error: ./analogclock: undefined symbol: _ZN9QGradientD1Ev, version Qt_5

Dies bedeutet, dass das Qt-Programm eine Qt-Bibliothek gefunden hat, die nicht mit seiner Version übereinstimmt. Dieses Problem tritt häufig in Systemen mit mehreren Qt-Versionen auf. Beispielsweise benötigen wir eigentlich eine Umgebung unter "/opt/firefly_qt5.15", aber das Qt-Programm versucht, "/lib/aarch64-linux-gnu/libQt5Gui.so.5" zu verwenden, was Probleme verursacht.

Verwenden Sie den Befehl "ldd", um die Bibliotheken zu sehen, die ein Programm verwenden möchte:

1. root@firefly:~/analogclock# ldd analogclock | grep -i qt
2. libQt5Gui.so.5 => /opt/firefly_qt5.15/lib/libQt5Gui.so.5 (0x0000007f8e0b2000)
3. libQt5Core.so.5 => /opt/firefly_qt5.15/lib/libQt5Core.so.5 (0x0000007f8daf6000)

Lösung 1: Geben Sie den Pfad an, in dem das Programm zunächst nach der Bibliothek suchen soll, bevor Sie kompilieren. Fügen Sie der pro-Datei des Projekts Folgendes hinzu:

1. QMAKE_RPATHDIR += /opt/firefly_qt5.15/lib

Lösung 2: Geben Sie "LD_LIBRARY_PATH" beim Ausführen des Programms an:

1. LD_LIBRARY_PATH=/opt/firefly_qt5.15/lib ./analogclock

3. Anzeige nicht gefunden

Wenn Sie beim Ausführen eines Qt-Programms keine Verbindung zur Anzeige herstellen können:

1. qt.qpa.xcb: could not connect to display
2. qt.qpa.plugin: Could not load the Qt platform plugin "xcb" in "" even though it was found.
3. Diese Anwendung konnte nicht gestartet werden, da kein Qt-Plattform-Plugin initialisiert werden konnte. Ein Neinstallieren der Anwendung könnte dieses Problem beheben.
5. Verfügbare Plattform-Plugins sind: eglfs, linuxfb, minimal, minimalegl, offscreen, vnc, wayland-egl, wayland, wayland-xcomposite-egl, webgl, xcb.
7. Abgebrochen

Es handelt sich höchstwahrscheinlich um ein Problem mit den Umgebungsvariablen, die angegeben werden müssen. Üblicherweise:

1. # Verwendung in einer X11-Umgebung:
2. export DISPLAY=:0
4. # Verwendung in einer Wayland-Umgebung:
5. export WAYLAND_DISPLAY=wayland-0

4. Qt-Bibliothek nicht gefunden

Wenn die Qt-Bibliothek beim Ausführen eines Qt-Programms nicht gefunden werden kann:

1. ./analogclock: error while loading shared libraries: libQt5Gui.so.5: cannot open shared object file: No such file or directory

Bitte überprüfen Sie, ob die Umgebungsvariablen-Datei "/etc/profile.d/target_qtEnv.sh" existiert. Wenn sie existiert, ist sie wirksam? Ist der Pfad zur Qt-Bibliothek wie im Dokument gefordert an der angegebenen Stelle platziert?