Skip to content

Commit c91dc7a

Browse files
wusyongWu Yu Wei
andauthored
feat: tauri v2.0-alpha.3 release post (#1096)
* Add version 2 alpha 3 release post * Fix typo * Mention exact version --------- Co-authored-by: Wu Yu Wei <[email protected]>
1 parent 08b79f8 commit c91dc7a

File tree

2 files changed

+46
-0
lines changed

2 files changed

+46
-0
lines changed
Lines changed: 40 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,40 @@
1+
---
2+
authors: [wusyong]
3+
description: New v2.0 alpha released and new backend for Linux port
4+
---
5+
6+
# Migration to `webkit2gtk-4.1` on Linux port
7+
8+
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.
9+
We will use [WebKit2GTK–4.1](https://webkitgtk.org/reference/webkit2gtk/stable/index.html) in 2.0 from now on.
10+
11+
<!--truncate-->
12+
13+
## What does this mean?
14+
15+
If you are using Tauri version 1.x, there's nothing to worry about. Everything you need is still the same.
16+
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.
17+
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):
18+
19+
```bash
20+
# On Arch Linux / Manjaro:
21+
sudo pacman -S webkit2gtk-4.1
22+
# On Debian / Ubuntu:
23+
sudo apt install libwebkit2gtk-4.1-dev
24+
# On Fedora:
25+
sudo dnf install webkit2gtk4.1-devel
26+
```
27+
28+
## Will this bring breaking changes to my code?
29+
30+
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.
31+
So if you didn't use any soup2-specific APIs, your applications should continue to work fine.
32+
33+
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.
34+
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.
35+
36+
## What other breaking changes we are going to expect?
37+
38+
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.
39+
This Rust version should satisfy the latest version of windows-rs.
40+
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.

blog/authors.yml

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -21,3 +21,9 @@ lucasfernog:
2121
title: Tauri Cofounder
2222
url: https://github.com/lucasfernog
2323
image_url: ./author_images/lucasfernog.jpg
24+
25+
wusyong:
26+
name: Wu Yu Wei
27+
title: Tauri Core
28+
url: https://github.com/wusyong
29+
image_url: https://pbs.twimg.com/profile_images/1600685503820419072/dNc2PpN3_400x400.jpg

0 commit comments

Comments
 (0)