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. - ![](../../.gitbook/assets/app-disambiguation\_2x.png) +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 | +|-----------------------------------------------------------------------------------------------------------|--------------------------------------------------------------|-------------------------------------------------------------------------------------------------|------------------------------------------------------------------|----------------------------------------------------|--------------------------------------------------| +| ![chrome_welcome_accept](https://github.com/user-attachments/assets/95a899f7-a375-455c-91ff-e15e2cbf6c79) | ![chrome_welcome_account](../../.gitbook/assets/account.png) | ![chrome_sync](https://github.com/user-attachments/assets/8e790d27-fe89-470d-a28b-1bda8853f59d) | ![chrome_notifications](../../.gitbook/assets/notifications.png) | ![ad_privacy](../../.gitbook/assets/adprivacy.png) | ![ad_privacy](../../.gitbook/assets/otherad.png) |