diff --git a/.gitbook/assets/account.png b/.gitbook/assets/account.png
new file mode 100644
index 0000000..4cef7a1
Binary files /dev/null and b/.gitbook/assets/account.png differ
diff --git a/.gitbook/assets/adprivacy.png b/.gitbook/assets/adprivacy.png
new file mode 100644
index 0000000..f30af3b
Binary files /dev/null and b/.gitbook/assets/adprivacy.png differ
diff --git a/.gitbook/assets/app-disambiguation_2x.png b/.gitbook/assets/app-disambiguation_2x.png
deleted file mode 100644
index b71f6d7..0000000
Binary files a/.gitbook/assets/app-disambiguation_2x.png and /dev/null differ
diff --git a/.gitbook/assets/chooser1.png b/.gitbook/assets/chooser1.png
new file mode 100644
index 0000000..fc555b3
Binary files /dev/null and b/.gitbook/assets/chooser1.png differ
diff --git a/.gitbook/assets/chooser2.png b/.gitbook/assets/chooser2.png
new file mode 100644
index 0000000..b079f6e
Binary files /dev/null and b/.gitbook/assets/chooser2.png differ
diff --git a/.gitbook/assets/notifications.png b/.gitbook/assets/notifications.png
new file mode 100644
index 0000000..81df78a
Binary files /dev/null and b/.gitbook/assets/notifications.png differ
diff --git a/.gitbook/assets/open1.png b/.gitbook/assets/open1.png
new file mode 100644
index 0000000..087fc98
Binary files /dev/null and b/.gitbook/assets/open1.png differ
diff --git a/.gitbook/assets/open2.png b/.gitbook/assets/open2.png
new file mode 100644
index 0000000..368dfde
Binary files /dev/null and b/.gitbook/assets/open2.png differ
diff --git a/.gitbook/assets/open3.png b/.gitbook/assets/open3.png
new file mode 100644
index 0000000..4f3f3d8
Binary files /dev/null and b/.gitbook/assets/open3.png differ
diff --git a/.gitbook/assets/otherad.png b/.gitbook/assets/otherad.png
new file mode 100644
index 0000000..fb2160a
Binary files /dev/null and b/.gitbook/assets/otherad.png differ
diff --git a/api-reference/commands/openlink.md b/api-reference/commands/openlink.md
index ff10b15..6cc8b81 100644
--- a/api-reference/commands/openlink.md
+++ b/api-reference/commands/openlink.md
@@ -8,9 +8,15 @@ To open a link on a device (i.e. a deep link):
### Auto verification of your Android Apps
-If your app shows a disambiguation dialog along with other apps that can open the web link:
+On Android, applications can declare intent filters for handling the opening of some links from specific domains.
- 
+If the app had implemented [App Links](https://developer.android.com/training/app-links#android-app-links) in order to verify the association with these domains by hosting a Digital Asset Links JSON file, the link would open the app automatically.
+
+If not, the behavior would depend on the Android version of the device.
+
+Starting from Android 12, such apps needs for the user to manually verify the association of the app with the domains through the "Open by default" settings menu.
+
+Before Android 12, the system would show a disambiguation menu (called "Chooser") for the user to choose which app to use.
You can auto-verify the web link to be opened by your app with `autoVerify` attribute:
@@ -19,15 +25,32 @@ You can auto-verify the web link to be opened by your app with `autoVerify` attr
link: https://example.com
autoVerify: true
```
+Starting from Android 12, setting `autoVerify` to true will automatically enable the verification of the domain of the link as if the user manually enabled it through the "Open by default" settings menu.
+
+| Chooser | Choice |
+|-------------------------------------------------------------|--------------------------------------------------------------|
+|
|
|
+
+Before Android 12, setting `autoVerify` to true will automatically pick the app in the Chooser.
+
+
+| Before verification | Supported links | After verification |
+|----------------------------------------------------------|----------------------------------------------------------|----------------------------------------------------------|
+|
|
|
|
-Beyond Android version 12, web links are by default opened in the web browser. It is possible for maestro to also auto-accept agreements of Google chrome if shown with the same `autoVerify` flag.
### Opening web links in the browser for Android
-It is possible with maestro to force open web links with the web browser:
+It is possible with maestro to force open web links with the web browser (Chrome):
```yaml
- openLink:
link: https://example.com
browser: true
```
+
+In that case, setting `autoVerify` to true would skip the various Chrome onboarding screens.
+
+| Accept | Sign in | Sync | Notifications | Ad privacy | Other ad privacy |
+|-----------------------------------------------------------------------------------------------------------|--------------------------------------------------------------|-------------------------------------------------------------------------------------------------|------------------------------------------------------------------|----------------------------------------------------|--------------------------------------------------|
+|  |  |  |  |  |  |