From b42e628424857e3110005a4bbcc3ecc8d986fff6 Mon Sep 17 00:00:00 2001 From: Paul d'Aoust Date: Mon, 24 Jun 2024 13:20:18 -0700 Subject: [PATCH] clarify what packages are for which webview container --- src/pages/get-started/index.md | 2 ++ src/pages/get-started/install-advanced.md | 12 ++++++++++-- 2 files changed, 12 insertions(+), 2 deletions(-) diff --git a/src/pages/get-started/index.md b/src/pages/get-started/index.md index 6d31fa296..c20fda96a 100644 --- a/src/pages/get-started/index.md +++ b/src/pages/get-started/index.md @@ -53,6 +53,8 @@ You'll also need to install a few packages if you want to run two dev tools, `hc sudo apt install -y libnss3 libatk1.0-0 libatk-bridge2.0-0 libcups2 libgtk-3-dev libasound2 adwaita-icon-theme ``` +Read more about these fixes in the [Dev Tools Setup guide](/get-started/install-advanced/#opening-your-h-app-s-gui-in-ubuntu-on-ws-l2-windows-subsystem-for-linux). + ### 2.3. Set up development environment Once you've ensured that your system meets the hardware requirements and set up WSL2 on Windows or a dual-boot Linux OS (if applicable), you can proceed with the installation of the Nix package manager and the binary package cache for Holochain. diff --git a/src/pages/get-started/install-advanced.md b/src/pages/get-started/install-advanced.md index 34762060d..f2a18cd8d 100644 --- a/src/pages/get-started/install-advanced.md +++ b/src/pages/get-started/install-advanced.md @@ -293,8 +293,16 @@ Because the template repo `holochain-kangaroo-electron` also bundles Electron's ## Opening your hApp's GUI in Ubuntu on WSL2 (Windows Subsystem for Linux) -There are two dev tools, `hc launch` and `hc spin`, which start your app's back end and open its GUI in Tauri or Electron webviews. Because the Ubuntu OS installed from the Microsoft Store doesn't come with GUI packages by default, you'll need to install just a few in order to get these tools to work: +There are two dev tools, `hc launch` and `hc spin`, which start your app's back end and open its GUI in [Tauri](https://tauri.app/) or [Electron](https://www.electronjs.org/) webview containers, respectively. Because the Ubuntu OS installed from the Microsoft Store doesn't come with GUI packages by default, you'll need to install just a few in order to get these tools to work. + +If you're only using `hc launch`, which uses the Tauri webview, install this package, which resolves a GDK error about cursors: ```shell -sudo apt install -y libnss3 libatk1.0-0 libatk-bridge2.0-0 libcups2 libgtk-3-dev libasound2 adwaita-icon-theme +sudo apt install -y adwaita-icon-theme ``` + +If you're only using the more modern `hd spin`, which uses the Electron webview, install these missing packages that are needed by the `chrome-sandbox` binary: + +```shell +sudo apt install -y libnss3 libatk1.0-0 libatk-bridge2.0-0 libcups2 libgtk-3-dev libasound2 +``` \ No newline at end of file