docs/README-ChromeOS.rst

branch
eric7
changeset 8477
81e25fe19818
child 8570
65ec02bfa9d2
equal deleted inserted replaced
8476:87c0b6e6e118 8477:81e25fe19818
1 =========================
2 Readme for ChromeOS usage
3 =========================
4
5 This Readme describes the steps to be performed to use eric on a
6 Chromebook with ChromeOS.
7
8 1. Preparation
9 --------------
10 Step 1: activate the Linux environment through the settings
11
12 Step 2: open a terminal window and execute these steps
13
14 ::
15
16 sudo apt update
17 sudo apt upgrade
18 sudo apt install libopengl0 python3-pip python3-venv
19
20 Step 3: modify environment to make Qt not use Wayland
21 As of ChromeOS 91 Qt6 is not yet compatible with the ChromeOS Wayland
22 implementation. In order to force Qt applications to use X11 modify
23 the "cros-garcon-override.conf" file.
24
25 ::
26
27 sudo vi /etc/systemd/user/cros-garcon.service.d/cros-garcon-override.conf
28
29 and add the line
30
31 ::
32
33 Environment="QT_QPA_PLATFORM=xcb"
34
35 2. eric Installation
36 --------------------
37 Installing eric7 is a simple process. There are various methods available.
38 Please choose the one best suited to your needs and skills. eric7 may be must
39 with Python 3, Qt5 and PyQt5.
40
41 2.1 Create a Python virtual environment for eric7
42 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
43 It is recommended to install eric7 into a Python virtual environment in order
44 to keep your Python distribution clean. In order to do that create it by
45 entering the following command in the terminal window.
46
47 ::
48
49 python3 -m venv eric7_venv
50
51 Replace ``eric7_venv`` with the desired path to the directory for the virtual
52 environment. All further instructions will assume this environment name.
53
54 2.2 Variant 2: Installation via the Python Package Index PyPI
55 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
56 Enter the following command in the terminal window.
57
58 ::
59
60 ~/eric7_venv/bin/python3 -m pip install --upgrade eric-ide
61
62 Once the installation is finished navigate to the executable directory of
63 the Python virtual environment and execute the ``eric7_post_install`` script.
64
65 ::
66
67 ~/eric7_venv/bin/eric7_post_install
68
69 2.3 Installation of Qt Tools via Qt online installer
70 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
71 In order to get the most out of eric7 it is recommended to install the Qt Tools
72 like ``Qt Designer`` or ``Qt Linguist``. The recommended way is this.
73
74 1. Download the Qt online installer from the Qt download site.
75
76 2. Install Qt by executing the installer.
77
78 3. Configure the path to the Qt tools on the ``Qt`` configuration page of the
79 eric7 configuration dialog.
80
81 3.0 Install optional packages for eric7 (for plug-ins)
82 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
83 eric7 provides an extension mechanism via plug-ins. The plug-ins are
84 available via the Plugin Repository dialog from within eric7. Some plugins
85 require the installation of additional python packages. This is done
86 automatically during the plugin installation.

eric ide

mercurial