Skip to content

Commit

Permalink
clarify what packages are for which webview container
Browse files Browse the repository at this point in the history
  • Loading branch information
pdaoust committed Jun 24, 2024
1 parent 0c3159f commit b42e628
Show file tree
Hide file tree
Showing 2 changed files with 12 additions and 2 deletions.
2 changes: 2 additions & 0 deletions src/pages/get-started/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -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

Check warning on line 53 in src/pages/get-started/index.md

View workflow job for this annotation

GitHub Actions / spellcheck

Unknown word (libnss)

Check warning on line 53 in src/pages/get-started/index.md

View workflow job for this annotation

GitHub Actions / spellcheck

Unknown word (libatk)

Check warning on line 53 in src/pages/get-started/index.md

View workflow job for this annotation

GitHub Actions / spellcheck

Unknown word (libatk)

Check warning on line 53 in src/pages/get-started/index.md

View workflow job for this annotation

GitHub Actions / spellcheck

Unknown word (libcups)

Check warning on line 53 in src/pages/get-started/index.md

View workflow job for this annotation

GitHub Actions / spellcheck

Unknown word (libgtk)

Check warning on line 53 in src/pages/get-started/index.md

View workflow job for this annotation

GitHub Actions / spellcheck

Unknown word (libasound)

Check warning on line 53 in src/pages/get-started/index.md

View workflow job for this annotation

GitHub Actions / spellcheck

Unknown word (adwaita)

Check warning on line 53 in src/pages/get-started/index.md

View workflow job for this annotation

GitHub Actions / spellcheck

Unknown word (libnss)

Check warning on line 53 in src/pages/get-started/index.md

View workflow job for this annotation

GitHub Actions / spellcheck

Unknown word (libatk)

Check warning on line 53 in src/pages/get-started/index.md

View workflow job for this annotation

GitHub Actions / spellcheck

Unknown word (libatk)

Check warning on line 53 in src/pages/get-started/index.md

View workflow job for this annotation

GitHub Actions / spellcheck

Unknown word (libcups)

Check warning on line 53 in src/pages/get-started/index.md

View workflow job for this annotation

GitHub Actions / spellcheck

Unknown word (libgtk)

Check warning on line 53 in src/pages/get-started/index.md

View workflow job for this annotation

GitHub Actions / spellcheck

Unknown word (libasound)

Check warning on line 53 in src/pages/get-started/index.md

View workflow job for this annotation

GitHub Actions / spellcheck

Unknown word (adwaita)
```

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.
Expand Down
12 changes: 10 additions & 2 deletions src/pages/get-started/install-advanced.md
Original file line number Diff line number Diff line change
Expand Up @@ -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

Check warning on line 301 in src/pages/get-started/install-advanced.md

View workflow job for this annotation

GitHub Actions / spellcheck

Unknown word (adwaita)

Check warning on line 301 in src/pages/get-started/install-advanced.md

View workflow job for this annotation

GitHub Actions / spellcheck

Unknown word (adwaita)
```

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

Check warning on line 307 in src/pages/get-started/install-advanced.md

View workflow job for this annotation

GitHub Actions / spellcheck

Unknown word (libnss)

Check warning on line 307 in src/pages/get-started/install-advanced.md

View workflow job for this annotation

GitHub Actions / spellcheck

Unknown word (libnss)
```

0 comments on commit b42e628

Please sign in to comment.