docs/README-RPi.rst

branch
eric7
changeset 9354
91ae1bc5ee9b
child 10031
6d4b46787f30
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/docs/README-RPi.rst	Mon Sep 26 14:07:07 2022 +0200
@@ -0,0 +1,65 @@
+==================================
+Readme for use on a Raspberry Pi 4
+==================================
+
+In order to use eric7 on a Raspberry Pi 4 computer a Linux distribution providing
+Qt6 and PyQt6 packages need to be installed. This recipe was tested on
+**Manjaro ARM**.
+
+This requirement is there because up to now no PyQt6 and PyQt6-Qt6 (and the like) wheels
+are available via the Python Packaging Index PyPI.</p>
+
+1. Step 1: Qt6 and PyQt6
+------------------------
+Ensure the following Qt6 and PyQt6 packages are installed or install them.
+  - qt6-base
+  - qt6-charts
+  - qt6-doc
+  - qt6-imageformats
+  - qt6-multimedia
+  - qt6-serialport
+  - qt6-svg
+  - qt6-tools
+  - qt6-translations
+  - qt6-webchannel
+  - qt6-webengine
+  - python-pyqt6
+  - python-pyqt6-charts
+  - python-pyqt6-sip
+  - python-pyqt6-webengine
+  - python-qscintilla-qt6
+  - qscintilla-qt6
+
+
+2. Step 2: Spell Checking
+-------------------------
+If spell checking is desired, ensure the following packages are installed.
+  - enchant
+  - python-enchant
+  - aspell
+  - any aspell language dictionary desired (suggested at least 'aspell-en')
+
+3. Step 3: Prepare eric7 Installation
+-------------------------------------
+In order to install eric7 it is recommended to create a Python virtual environment in
+order to isolate the eric7 execution environment as much as possible from the standard
+installation. In order to create this environment execute the following in a terminal
+window.
+
+::
+
+    python3 -m venv --system-site-packages eric7_env
+    ~/eric7_env/bin/python3 -m pip install --upgrade pip
+
+**Note:** The switch ``--system-site-packages`` is necessary because there are no
+PyQt6/Qt6 packages available for the AArch64 (ARM) platform. This necessitates
+the use of the packages provided by the distribution.
+
+4. Step 4: Install eric7 (eric-ide)
+-----------------------------------
+Install eric7 into the created Python virtual environment by following these steps.
+
+::
+
+    ~/eric7_env/bin/python3 -m pip install eric-ide
+    ~/eric7_env/bin/eric7_post_install

eric ide

mercurial