diff --git a/blog/2023-02-03-tauri-2-0-0-alpha-3 .mdx b/blog/2023-02-03-tauri-2-0-0-alpha-3 .mdx new file mode 100644 index 0000000000..cf575efcb8 --- /dev/null +++ b/blog/2023-02-03-tauri-2-0-0-alpha-3 .mdx @@ -0,0 +1,40 @@ +--- +authors: [wusyong] +description: New v2.0 alpha released and new backend for Linux port +--- + +# Migration to `webkit2gtk-4.1` on Linux port + +Hello everybody! We just released [Tauri v2.0.0-alpha3](https://github.com/tauri-apps/tauri/releases/tag/tauri-v2.0.0-alpha.3) recently. While it doesn't bring any major feature, it does bring some huge impacts on Linux port. +We will use [WebKit2GTK–4.1](https://webkitgtk.org/reference/webkit2gtk/stable/index.html) in 2.0 from now on. + + + +## What does this mean? + +If you are using Tauri version 1.x, there's nothing to worry about. Everything you need is still the same. +But if you are using Tauri version 2.0 alpha version starting from `alpha.3`, you will need to install the new WebKit2GTK package with API version 4.1. +We will update the prerequisites in our site soon. But if you want to know how to install such version, here are some instructions from [wry](https://github.com/tauri-apps/wry#linux): + +```bash +# On Arch Linux / Manjaro: +sudo pacman -S webkit2gtk-4.1 +# On Debian / Ubuntu: +sudo apt install libwebkit2gtk-4.1-dev +# On Fedora: +sudo dnf install webkit2gtk4.1-devel +``` + +## Will this bring breaking changes to my code? + +The main difference between version 4.0 and 4.1 are the soup library. WebKit2GTK-4.0 uses soup2 and WebKit2GTK-4.1 uses soup3. +So if you didn't use any soup2-specific APIs, your applications should continue to work fine. + +The reason behind this change is because we aim to add flatpak support, but [Gnome runtime](https://docs.flatpak.org/en/latest/available-runtimes.html#gnome) uses webkit2gtk-4.1. +There are also some subtle bugs like [this](https://github.com/tauri-apps/wry/issues/717) that only happen in soup2 and they can be fixed by upgrading to soup3. + +## What other breaking changes we are going to expect? + +The major one will be the MSRV. With Tauri v2.0.0-alpha.3 released, MSRV is bumped to 1.64. We will also update windows-rs in the future. +This Rust version should satisfy the latest version of windows-rs. +We do plan to update our MSRV with minor releases after 2.0. This could ease the friction to stick to any fixed Rust version while updating dependencies. diff --git a/blog/authors.yml b/blog/authors.yml index 9fbd302277..017f7748f0 100644 --- a/blog/authors.yml +++ b/blog/authors.yml @@ -21,3 +21,9 @@ lucasfernog: title: Tauri Cofounder url: https://github.com/lucasfernog image_url: ./author_images/lucasfernog.jpg + +wusyong: + name: Wu Yu Wei + title: Tauri Core + url: https://github.com/wusyong + image_url: https://pbs.twimg.com/profile_images/1600685503820419072/dNc2PpN3_400x400.jpg \ No newline at end of file