1# Setting Up the Ubuntu Environment
2
3In embedded development, Windows-based tools, such as Visual Studio Code, are widely used in code editing. Yet, because the source code of most development boards, such as Hi3861 and Hi3516, cannot be built in Windows, these development boards require the Ubuntu build environment.
4
5In the Windows+Ubuntu hybrid build environment, you can enjoy the benefits of both DevEco Device Tool for Windows and DevEco Device Tool for Ubuntu (where Visual Studio Code is optional).
6
7The following describes how to set up the Ubuntu environment.
8
9> ![icon-note.gif](public_sys-resources/icon-note.gif) **NOTE**
10>
11> If the Ubuntu system has not been set up yet, set it up on a virtual machine running Windows. For details, see [Ubuntu Installation Guide](https://developer.huawei.com/consumer/cn/training/course/video/C101639987816176315). Then, [configure the Ubuntu basic environment](https://developer.huawei.com/consumer/cn/training/course/video/C101639988048536240).
12
13
14## System Requirements
15
16- Ubuntu: Ubuntu 18.04 to 21.10; version 20.04 with 16 GB or larger memory and a 100 GB or larger hard disk is recommended
17
18- User name (Ubuntu): cannot contain Chinese characters
19
20- DevEco Device Tool: latest and same version installed on both Ubuntu and Windows
21
22  > ![icon-note.gif](public_sys-resources/icon-note.gif) **NOTE**
23  >
24  > The following uses DevEco Device Tool of the 3.1 Release version as an example. The supported features and operations vary according to the DevEco Device Tool version. For details, see the [User Guide](https://device.harmonyos.com/en/docs/documentation/guide/service_introduction-0000001050166905).
25
26
27## Procedure
28
291. Make sure the Ubuntu shell environment is **bash**.
30   1. Run the following command and check whether the command output is **bash**. If the command output is not **bash**, go to step 2.
31
32       ```shell
33       ls -l /bin/sh
34       ```
35
36       ![en-us_image_0000001226764302](figures/en-us_image_0000001226764302.png)
37
38   2. Start the command-line tool, run the following command, enter your password, and select **No** to set **Ubuntu shell** to **bash**.
39
40       ```shell
41       sudo dpkg-reconfigure dash
42       ```
43
44       ![ubuntu-dash-to-bash](figures/ubuntu-dash-to-bash.png)
45
462. Download the latest version of [DevEco Device Tool](https://device.harmonyos.com/cn/ide#download) for Linux.
47
483. Decompress the DevEco Device Tool software package and assign permission on the folder obtained from the decompression.
49   1. Go to the directory where the DevEco Device Tool software package is stored and run the following command to decompress the software package. In the command, **devicetool-linux-tool-{Version}.zip** indicates the software package name.
50
51       ```shell
52       unzip devicetool-linux-tool-{Version}.zip
53       ```
54   2. Open the folder of the decompressed software package and run the following command to grant the execute permission on the installation file. In the command, **devicetool-linux-tool-{Version}.sh** indicates the installation file name.
55
56       ```shell
57       chmod u+x devicetool-linux-tool-{Version}.sh
58       ```
59
604. Run the following command to install DevEco Device Tool, where **devicetool-linux-tool-{Version}.sh** indicates the installation file name.
61
62   ```shell
63   sudo ./devicetool-linux-tool-{Version}.sh
64   ```
65
665. On the page for agreeing to the user agreement and privacy statement, read and agree to the user agreement and privacy statement. You can scroll through the options by pressing the up and down arrow keys on the keyboard.
67
68   ![en-us_image_0000001340557741](figures/en-us_image_0000001340557741.png)
69
70   Wait until the "DevEco Device Tool successfully installed." message is displayed.
71
72   ![en-us_image_0000001338201457](figures/en-us_image_0000001338201457.png)
73