[flutter_local_notifications] renamed requestPermission method on Android to requestNotificationsPermission (#2053)

* renamed requestPermission method on Android to requestNotificationsPermission

* Google Java Format

---------

Co-authored-by: github-actions <>

Author: MaikuB

flutter_local_notifications/CHANGELOG.md

@@ -1,6 +1,7 @@
 # [16.0.0-dev.1]
 
-* [Android] **Breaking changes** the plugin now only declares the bare minimum in its `AndroidManifest.xml`. This means applications making use of either scheduled notifications, full-screen intent notifications or notification actions will now require changes in the application's own `AndroidManifest.xml` file. Please check the [AndroidManifest.xml setup](https://pub.dev/packages/flutter_local_notifications#androidmanifestxml-setup) section of the readme for more details. The reason this was done was because not all applications will leverage all of the plugin's features. Doing this will now allow applications to only request the appropriate permissions needed for their application. This addresses issue [1687](https://github.com/MaikuB/flutter_local_notifications/issues/1687)
+* [Android] **Breaking change** renamed the `requestPermission()` associated with the `AndroidFlutterLocalNotificationsPlugin` class to `requestNotificationsPermission()`. This was done to be more explicit given another method (`requestExactAlarmsPermission()`) has been added that also requests a permission (more details below).
+* [Android] **Breaking change** the plugin now only declares the bare minimum in its `AndroidManifest.xml`. This means applications making use of either scheduled notifications, full-screen intent notifications or notification actions will now require changes in the application's own `AndroidManifest.xml` file. Please check the [AndroidManifest.xml setup](https://pub.dev/packages/flutter_local_notifications#androidmanifestxml-setup) section of the readme for more details. The reason this was done was because not all applications will leverage all of the plugin's features. Doing this will now allow applications to only request the appropriate permissions needed for their application. This addresses issue [1687](https://github.com/MaikuB/flutter_local_notifications/issues/1687)
 * [Android] added the ability to request permission to schedule exact alarms via the `requestExactAlarmsPermission()` method that has been added to the `AndroidFlutterLocalNotificationsPlugin` class that represents the Android implementation of the plugin. This has been done in response to behaviour changes introduced in Android 14 (API level 34) when comes to using exact alarms. See the official documentation about these changes [here](https://developer.android.com/about/versions/14/changes/schedule-exact-alarms). This change addresses issue [1906](https://github.com/MaikuB/flutter_local_notifications/issues/1906)
 
 

flutter_local_notifications/android/src/main/java/com/dexterous/flutterlocalnotifications/FlutterLocalNotificationsPlugin.java

@@ -158,7 +158,8 @@ public class FlutterLocalNotificationsPlugin
   private static final String PERIODICALLY_SHOW_METHOD = "periodicallyShow";
   private static final String GET_NOTIFICATION_APP_LAUNCH_DETAILS_METHOD =
       "getNotificationAppLaunchDetails";
-  private static final String REQUEST_PERMISSION_METHOD = "requestPermission";
+  private static final String REQUEST_NOTIFICATIONS_PERMISSION_METHOD =
+      "requestNotificationsPermission";
   private static final String REQUEST_EXACT_ALARMS_PERMISSION_METHOD =
       "requestExactAlarmsPermission";
   private static final String METHOD_CHANNEL = "dexterous.com/flutter/local_notifications";
@@ -1394,8 +1395,8 @@ public void onMethodCall(MethodCall call, @NonNull Result result) {
       case ZONED_SCHEDULE_METHOD:
         zonedSchedule(call, result);
         break;
-      case REQUEST_PERMISSION_METHOD:
-        requestPermission(
+      case REQUEST_NOTIFICATIONS_PERMISSION_METHOD:
+        requestNotificationsPermission(
             new PermissionRequestListener() {
               @Override
               public void complete(boolean granted) {
@@ -1741,7 +1742,7 @@ private void cancelAllNotifications(Result result) {
     result.success(null);
   }
 
-  public void requestPermission(@NonNull PermissionRequestListener callback) {
+  public void requestNotificationsPermission(@NonNull PermissionRequestListener callback) {
     if (permissionRequestProgress != PermissionRequestProgress.None) {
       callback.fail(PERMISSION_REQUEST_IN_PROGRESS_ERROR_MESSAGE);
       return;

flutter_local_notifications/example/lib/main.dart

@@ -304,7 +304,7 @@ class _HomePageState extends State<HomePage> {
               AndroidFlutterLocalNotificationsPlugin>();
 
       final bool? grantedNotificationPermission =
-          await androidImplementation?.requestPermission();
+          await androidImplementation?.requestNotificationsPermission();
       setState(() {
         _notificationsEnabled = grantedNotificationPermission ?? false;
       });

flutter_local_notifications/lib/src/platform_flutter_local_notifications.dart

@@ -162,8 +162,8 @@ class AndroidFlutterLocalNotificationsPlugin
   /// See also:
   ///
   ///  * https://developer.android.com/about/versions/13/changes/notification-permission
-  Future<bool?> requestPermission() async =>
-      _channel.invokeMethod<bool>('requestPermission');
+  Future<bool?> requestNotificationsPermission() async =>
+      _channel.invokeMethod<bool>('requestNotificationsPermission');
 
   /// Schedules a notification to be shown at the specified date and time
   /// relative to a specific time zone.

flutter_local_notifications/test/android_flutter_local_notifications_test.dart

@@ -2508,6 +2508,15 @@ void main() {
           ));
     });
 
+    test('requestNotificationsPermission', () async {
+      await flutterLocalNotificationsPlugin
+          .resolvePlatformSpecificImplementation<
+              AndroidFlutterLocalNotificationsPlugin>()!
+          .requestNotificationsPermission();
+      expect(log.last,
+          isMethodCall('requestNotificationsPermission', arguments: null));
+    });
+
     test('requestExactAlarmsPermission', () async {
       await flutterLocalNotificationsPlugin
           .resolvePlatformSpecificImplementation<