From 044f5ce1948536bd044ef2a44df4986a35954bf2 Mon Sep 17 00:00:00 2001
From: stuartmorgan <stuartmorgan@google.com>
Date: Tue, 7 Jun 2022 12:53:10 -0400
Subject: [PATCH] [url_launcher] Update README discussion of permissions
 (#5424)

---
 .../url_launcher/url_launcher/CHANGELOG.md    |  5 +++
 packages/url_launcher/url_launcher/README.md  | 40 ++++++++-----------
 .../android/app/src/main/AndroidManifest.xml  |  6 +--
 .../url_launcher/url_launcher/pubspec.yaml    |  2 +-
 4 files changed, 25 insertions(+), 28 deletions(-)

diff --git a/packages/url_launcher/url_launcher/CHANGELOG.md b/packages/url_launcher/url_launcher/CHANGELOG.md
index 043edeb3d8e2..d2c4206718ec 100644
--- a/packages/url_launcher/url_launcher/CHANGELOG.md
+++ b/packages/url_launcher/url_launcher/CHANGELOG.md
@@ -1,3 +1,8 @@
+## 6.1.3
+
+* Updates README section about query permissions to better reflect changes to
+  `canLaunchUrl` recommendations.
+
 ## 6.1.2
 
 * Minor fixes for new analysis options.
diff --git a/packages/url_launcher/url_launcher/README.md b/packages/url_launcher/url_launcher/README.md
index 9c9f0b57e667..9ef6b5aac5c7 100644
--- a/packages/url_launcher/url_launcher/README.md
+++ b/packages/url_launcher/url_launcher/README.md
@@ -43,14 +43,15 @@ See the example app for more complex examples.
 ## Configuration
 
 ### iOS
-Add any URL schemes passed to `canLaunchUrl` as `LSApplicationQueriesSchemes` entries in your Info.plist file.
+Add any URL schemes passed to `canLaunchUrl` as `LSApplicationQueriesSchemes`
+entries in your Info.plist file, otherwise it will return false.
 
 Example:
 ```xml
 <key>LSApplicationQueriesSchemes</key>
 <array>
-  <string>https</string>
-  <string>http</string>
+  <string>sms</string>
+  <string>tel</string>
 </array>
 ```
 
@@ -58,40 +59,31 @@ See [`-[UIApplication canOpenURL:]`](https://developer.apple.com/documentation/u
 
 ### Android
 
-Starting from API 30 Android requires package visibility configuration in your
-`AndroidManifest.xml` otherwise `canLaunchUrl` will return `false`. A `<queries>`
+Add any URL schemes passed to `canLaunchUrl` as `<queries>` entries in your
+`AndroidManifest.xml`, otherwise it will return false in most cases starting
+on Android 11 (API 30) or higher. A `<queries>`
 element must be added to your manifest as a child of the root element.
 
-The snippet below shows an example for an application that uses `https`, `tel`,
-and `mailto` URLs with `url_launcher`. See
-[the Android documentation](https://developer.android.com/training/package-visibility/use-cases)
-for examples of other queries.
-
+Example:
 ``` xml
 <queries>
-  <!-- If your app opens https URLs -->
+  <!-- If your app checks for SMS support -->
   <intent>
     <action android:name="android.intent.action.VIEW" />
-    <data android:scheme="https" />
+    <data android:scheme="sms" />
   </intent>
-  <!-- If your app makes calls -->
+  <!-- If your app checks for call support -->
   <intent>
-    <action android:name="android.intent.action.DIAL" />
+    <action android:name="android.intent.action.VIEW" />
     <data android:scheme="tel" />
   </intent>
-  <!-- If your sends SMS messages -->
-  <intent>
-    <action android:name="android.intent.action.SENDTO" />
-    <data android:scheme="smsto" />
-  </intent>
-  <!-- If your app sends emails -->
-  <intent>
-    <action android:name="android.intent.action.SEND" />
-    <data android:mimeType="*/*" />
-  </intent>
 </queries>
 ```
 
+See
+[the Android documentation](https://developer.android.com/training/package-visibility/use-cases)
+for examples of other queries.
+
 ## Supported URL schemes
 
 The provided URL is passed directly to the host platform for handling. The
diff --git a/packages/url_launcher/url_launcher/example/android/app/src/main/AndroidManifest.xml b/packages/url_launcher/url_launcher/example/android/app/src/main/AndroidManifest.xml
index fa149f94adf0..5c0d0afa0fe4 100644
--- a/packages/url_launcher/url_launcher/example/android/app/src/main/AndroidManifest.xml
+++ b/packages/url_launcher/url_launcher/example/android/app/src/main/AndroidManifest.xml
@@ -14,12 +14,12 @@
       <data android:scheme="https" />
     </intent>
     <intent>
-      <action android:name="android.intent.action.DIAL" />
+      <action android:name="android.intent.action.VIEW" />
       <data android:scheme="tel" />
     </intent>
     <intent>
-      <action android:name="android.intent.action.SENDTO" />
-      <data android:scheme="smsto" />
+      <action android:name="android.intent.action.VIEW" />
+      <data android:scheme="sms" />
     </intent>
   </queries>
 
diff --git a/packages/url_launcher/url_launcher/pubspec.yaml b/packages/url_launcher/url_launcher/pubspec.yaml
index 319b6bfd3e0b..2a7ddcdb1dbe 100644
--- a/packages/url_launcher/url_launcher/pubspec.yaml
+++ b/packages/url_launcher/url_launcher/pubspec.yaml
@@ -3,7 +3,7 @@ description: Flutter plugin for launching a URL. Supports
   web, phone, SMS, and email schemes.
 repository: https://github.com/flutter/plugins/tree/main/packages/url_launcher/url_launcher
 issue_tracker: https://github.com/flutter/flutter/issues?q=is%3Aissue+is%3Aopen+label%3A%22p%3A+url_launcher%22
-version: 6.1.2
+version: 6.1.3
 
 environment:
   sdk: ">=2.14.0 <3.0.0"