Skip to content
This repository has been archived by the owner on Oct 15, 2024. It is now read-only.

Latest commit

 

History

History
92 lines (61 loc) · 3.92 KB

contributing-windows.md

File metadata and controls

92 lines (61 loc) · 3.92 KB
Raw

Introduction

In this tutorial, you will learn how to set up a development environment for Elektra using Windows Subsystem for Linux (WSL) and Visual Studio 2019.

Visual Studio 2019 (VS2019) Community is free but requires a registration after a couple of days. Download it and install the Linux development with C++ workload.

Elektra development mainly happens on GNU/Linux distributions. Therefore, it makes sense to use WSL if you have Windows 10 installed on your PC. For the beginning, it does not matter if you choose WSL 1 or WSL 2. It is possible to convert them later.

Download and Installation

We assume you use Ubuntu as WSL distribution. Install the packages required for building from VS2019:

apt install g++ gdb make ninja-build rsync zip

Then clone the libelektra git repository:

git clone [email protected]:ElektraInitiative/libelektra.git

Do not use VS2019 to clone the repository: You will not be able to compile because of invalid line endings.

and open it in VS2019. It will complain that IntelliSense is out of date. In addition, the Error List at the bottom will show CMake errors about missing compilers. To solve this, you have to configure a Linux CMake project.

Configure a Linux CMake project

Microsoft has even more information about this task.

In the drop-down menu that says x64-Debug (Default) click Manage Configurations.... Add WSL-GCC-Debug and save the configuration.

You can remove x64-Debug (Default).

CMake generation will automatically restart. When it has completed, you can click the drop-down Select Startup Item... (by the green Play button).

A long list of targets should appear. Choose hello (bin\hello) and click the green Play button. You should now see the output Hello world in the Linux Console Window at the bottom.

Why choose VS2019

One advantage of using VS2019 is the graphical debugger. Search for hello.c in the Solution Explorer to the right. Create a breakpoint in the main function and run the program again using the green Play button.

On the bottom-left you will see the windows Autos, Locals and Watch 1. Click on Locals to inspect the Key * k. Right-click keyNew to access functions like Peek Definition.

Choosing your WSL version

It makes sense to compare WSL 1 and WSL 2 and make an informed decision for one of them. Your setup may require adaptions, such as installing an SSH server in your Linux distribution.

Good sources of information are:

Commands to change your WSL version can be found, for example, in the blog post WSL 2 is now available in Windows Insiders

Troubleshooting

For further information, consider the official Linux with Visual Studio C++ documentation.

If you choose to work with source code residing on a Windows filesystem mounted in WSL (e.g./mnt/c/...), please enable the metadata option to prevent problems due to permissions not being persisted:

  • Create or modify /etc/wsl.conf to contain the following section and setting:
[automount]
options = "metadata"
  • Restart the WSL VM by issuing wsl --shutdown in your window console.

Building from sources residing on a mounted Windows file system may incur a significant performance penalty. Consider using your WSL home directory (e.g. ~/) as your location for the Elektra sources.