Skip to content

Commit 1279617

Browse files
committed
Create If-App-Lab-does-not-open.md
1 parent a1f8759 commit 1279617

File tree

1 file changed

+60
-0
lines changed

1 file changed

+60
-0
lines changed
Lines changed: 60 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,60 @@
1+
---
2+
title: "If App Lab does not open on Linux"
3+
---
4+
5+
If you’re running App Lab on Linux, the application will not be able to launch if the WebKit2 library is not installed. Learn how to install the library and diagnose other potential issues.
6+
7+
---
8+
9+
In this article:
10+
11+
<!-- TOC -->
12+
13+
- [Make sure the WebKit2 library is installed](#make-sure-the-webkit2-library-is-installed)
14+
- [Try launching App Lab in Terminal](#try-launching-app-lab-in-terminal)
15+
16+
<!-- /TOC -->
17+
18+
## Make sure the WebKit2 library is installed
19+
20+
If you’re running App Lab on Linux, the application will not be able to launch if an appropriate version of the **WebKitGTK** library is missing.
21+
22+
Resolve the issue by installing the library:
23+
24+
1. Open Terminal from the main application menu, or press <kbd>Ctrl</kbd> + <kbd>Alt</kbd> + <kbd>T</kbd>.
25+
26+
1. Type the following command:
27+
28+
- **Ubuntu/Debian/Mint:** `sudo apt install libwebkit2gtk-4.1-0`
29+
- **Arch:** `sudo pacman -S webkit2gtk-4.1`
30+
31+
1. Press <kbd>Enter</kbd>.
32+
33+
1. Try launching App Lab again.
34+
35+
If the library was already installed, check for other errors by [launching App Lab in Terminal](#try-launching-app-lab-in-terminal).
36+
37+
38+
## Launch App Lab in Terminal
39+
40+
If App Lab still isn't launching, you can try opening the application from Terminal, to reveal error output not visible when launching the application normally.
41+
42+
Follow these steps:
43+
44+
1. Open Terminal from the main application menu, or press <kbd>Ctrl</kbd> + <kbd>Alt</kbd> + <kbd>T</kbd>.
45+
46+
1. Navigate to the directory containing Arduino App Lab. A quick way to do this is by typing `cd`and a space, and then drag and drop the file's folder directly onto the Terminal window. The path will appear automatically. Press <kbd>Enter</kbd> to confirm.
47+
48+
1. Type `./arduino-app-lab` and press <kbd>Enter</kbd>.
49+
50+
1. Observe the Terminal output.
51+
52+
* If you see this error, you are still missing the WebKitGTK library.
53+
54+
```
55+
./arduino-app-lab: error while loading shared libraries: libwebkit2gtk-4.1.so.0: cannot open shared object file: No such file or directory
56+
```
57+
58+
Follow the steps in [Make sure the WebKit2 library is installed](#make-sure-the-webkit2-library-is-installed).
59+
60+
* For other issues, try seraching the Arduino Help Center or [contacting Arduino Support](https://www.arduino.cc/en/contact-us/).

0 commit comments

Comments
 (0)