harmony(鸿蒙)Setting Up the Windows+Ubuntu Hybrid Development Environment

2022-08-09
浏览 (1289)

Setting Up the Windows+Ubuntu Hybrid Development Environment

In embedded development, Windows-based tools, such as Visual Studio Code, are widely used in code editing. Yet, as the source code of most development boards, such as Hi3861 and Hi3516, cannot be built in Windows, these development boards require the Ubuntu development environment.

In the Windows+Ubuntu hybrid development 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).

System Requirements

Windows: Windows 10 (64-bit)
Ubuntu: Ubuntu 20.04 or later; recommended memory: 16 GB or higher
User name (Ubuntu): cannot contain Chinese characters
DevEco Device Tool: 3.0 Release

Setting Up the Ubuntu Development Environment

NOTE If the Ubuntu system has not been set up yet, set it up on a virtual machine running Windows. Then, configure the Ubuntu basic environment.

Make sure the Ubuntu shell environment is bash.
1. Run the following command and check whether the command output is bash. If the command output is not bash, go to step 2.
```
   ls -l /bin/sh
```
1. Start the command-line tool, run the following command, enter your password, and select No to set Ubuntu shell to bash.
```
   sudo dpkg-reconfigure dash
```
Download the DevEco Device Tool 3.0 Release Linux version.
Decompress the DevEco Device Tool software package and assign permission on the folder obtained from the decompression.
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, change devicetool-linux-tool-3.0.0.401.zip to the actual software package name.
```
   unzip devicetool-linux-tool-3.0.0.401.zip
```
1. 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, change devicetool-linux-tool-3.0.0.401.sh to the actual installation file name.
```
   chmod u+x devicetool-linux-tool-3.0.0.401.sh
```
Run the following command to install DevEco Device Tool, where devicetool-linux-tool-3.0.0.401.sh indicates the installation file name.

   sudo ./devicetool-linux-tool-3.0.0.401.sh

NOTE
During the installation, the setup wizard automatically checks whether Python 3.8 or 3.9 is installed. If Python 3.8 or 3.9 is not installed, the setup wizard displays the “Do you want to continue?” message; enter Y to allow the setup wizard to automatically install Python.

During the installation, the page for agreeing to the user agreement and privacy statement is displayed. Read and agree to the user agreement and privacy statement.

If this page is not displayed and the installation exits, run the apt-get install whiptail command, then the installation command.

Wait until the “Deveco Device Tool successfully installed.” message is displayed.

en-us_image_0000001198722374

Setting Up Windows Development Environment

To remotely access the Ubuntu environment through Windows and enjoy the benefits of DevEco Device Tool for Windows, you need to install DevEco Device Tool on Windows.

Download the DevEco Device Tool 3.0 Release Windows edition.
Decompress the DevEco Device Tool package, double-click the installer, and then click Next.
Set the installation path of DevEco Device Tool to a path that does not contain any Chinese characters, and then click Next. You are advised to install DevEco Device Tool in a non-system drive.

NOTE If you have installed DevEco Device Tool 3.0 Beta2 or earlier, the earlier version will be uninstalled before you install a new version. If the following error message is displayed during the uninstallation, click Ignore to continue the installation. This error does not affect the installation of the new version.

en-us_image_0000001270076961

When prompted, select the tools to be automatically installed.
1. On the VSCode installation confirm page, select Install VScode 1.62.2 automatically and click Next.
NOTE
If Visual Studio Code 1.62 or later has been installed, this step will be skipped.
1. On the displayed Python select page, select Download from Huawei mirror and click Next.
NOTE
If Python 3.8 or 3.9 has been installed, select Use one of compatible on your PC.
In the dialog box shown below, click Next.

en-us_image_0000001239634067

Read the user agreement and privacy statement carefully, select I accept the licenses, and click Next.

en-us_image_0000001307019009 7. Wait for the DevEco Device Tool setup wizard to automatically install DevEco Device Tool. After the installation is complete, click Finish to close the setup wizard.

en-us_image_0000001239650137

From Visual Studio Code, access the DevEco Device Tool page. Now you can conduct your development in DevEco Device Tool.

en-us_image_0000001225760456

Configuring Windows to Remotely Access the Ubuntu Development Environment

Installing the SSH Service and Obtaining the IP Address for Remote Access

In Ubuntu, open the Terminal tool and run the following command to install the SSH service:

NOTE
If the command fails to be executed and the system displays a message indicating that the openssh-server and openssh-client depend on different versions, install the openssh-client of the required version (for example, sudo apt-get install openssh-client=1:8.2p1-4) as prompted on the command-line interface (CLI) and run the command again to install the openssh-server.

   sudo apt-get install openssh-server

Run the following command to start the SSH service:

   sudo systemctl start ssh

Run the following command to obtain the IP address of the current user for remote access to the Ubuntu environment from Windows:

   ifconfig

en-us_image_0000001215737140

Installing Remote SSH

Open Visual Studio Code in Windows, click , and search for remote-ssh in the Extension Marketplace.

en-us_image_0000001193920448

Click Install to install Remote-SSH. After the installation is successful, Remote-SSH is displayed on the INSTALLED list.

en-us_image_0000001238880335

Remotely Connecting to the Ubuntu Environment

Open Visual Studio Code in Windows, click , and click + on the REMOTE EXOPLORER page.

en-us_image_0000001215878922

In the Enter SSH Connection Command text box, enter ssh *username@ip_address*, where ip_address indicates the IP address of the remote computer to be connected and username indicates the account name used for logging in to the remote computer.

en-us_image_0000001215879750

In the displayed dialog box, select the default first option as the SSH configuration file.

en-us_image_0000001260519729

Under SSH TARGETS, find the remote computer and click to start it.

en-us_image_0000001215720398

In the displayed dialog box, select Linux, select Continue, and enter the password for logging in to the remote computer. > NOTE > To eliminate the need for frequently entering the password for logging in to the remote computer, set an SSH public key.

en-us_image_0000001215897530

After the connection is successful, the plug-in is automatically installed in the .vscode-server folder on the remote computer. After the installation is complete, reload Visual Studio Code in Windows as prompted. Then you can develop, compile, and burn source code in DevEco Device Tool on Windows.