Feature/supports_SPM

permission_handler/README.md

@@ -19,36 +19,49 @@ While the permissions are being requested during runtime, you'll still need to t
 **Upgrade pre-1.12 Android projects**
 
 Since version 4.4.0 this plugin is implemented using the Flutter 1.12 Android plugin APIs. Unfortunately, this means App developers also need to migrate their Apps to support the new Android infrastructure. You can do so by following the [Upgrading pre 1.12 Android projects](https://github.com/flutter/flutter/wiki/Upgrading-pre-1.12-Android-projects) migration guide. Failing to do so might result in unexpected behavior. The most common known error is the permission_handler not returning after calling the `.request()` method on permission.
-
+ 
 **AndroidX**
-
+ 
 As of version 3.1.0, the <kbd>permission_handler</kbd> plugin switched to the AndroidX version of the Android Support Libraries. This means you need to make sure your Android project is also upgraded to support AndroidX. Detailed instructions can be found [here](https://flutter.dev/docs/development/packages-and-plugins/androidx-compatibility).
-
+ 
 The TL;DR version is:
-
+ 
 1. Add the following to your "gradle.properties" file:
-
+ 
 ```properties
 android.useAndroidX=true
 android.enableJetifier=true
 ```
-
-2. Make sure you set the `compileSdkVersion` in your "android/app/build.gradle" file to 33:
-
+ 
+2. Make sure you set the `compileSdkVersion` in your "android/app/build.gradle" file to at least `36`: newer AndroidX artifacts (for example androidx.browser:browser:1.9.0 and androidx.core:core-ktx:1.17.0) require compiling against API 36 or later. Example:
+ 
 ```gradle
 android {
-  compileSdkVersion 35
+  compileSdkVersion 36
   ...
 }
 ```
-
-3. Make sure you replace all the `android.` dependencies to their AndroidX counterparts (a full list can be found [here](https://developer.android.com/jetpack/androidx/migrate)).
-
+
+3. If you see warnings from the Android Gradle Plugin about unsupported compileSdk versions, upgrade your Android Gradle Plugin (AGP) to a version that supports API 36 or later. We recommend using AGP 8.9.1 or newer and a compatible Gradle distribution (e.g. Gradle 8.11.1+).
+
+4. Make sure you replace all the `android.` dependencies to their AndroidX counterparts (a full list can be found [here](https://developer.android.com/jetpack/androidx/migrate)).
+
 Add permissions to your `AndroidManifest.xml` file.
 There are `debug`, `main`, and `profile` versions which are chosen depending on how you start your app.
 In general, it's sufficient to add permission only to the `main` version.
 [Here](https://github.com/Baseflow/flutter-permission-handler/blob/master/permission_handler/example/android/app/src/main/AndroidManifest.xml)'s an example `AndroidManifest.xml` with a complete list of all possible permissions.
 
+
+**Troubleshooting build memory issues**
+
+If you encounter Java heap space errors while building with newer AGP/Gradle, increase the Gradle JVM memory in `android/gradle.properties` for the app/project:
+
+```properties
+org.gradle.jvmargs=-Xmx4G
+android.useAndroidX=true
+android.enableJetifier=true
+```
+
 </details>
 
 <details>

permission_handler/example/android/app/build.gradle

@@ -28,10 +28,12 @@ android {
     compileSdkVersion 36
 
     compileOptions {
-        sourceCompatibility JavaVersion.VERSION_17
-        targetCompatibility JavaVersion.VERSION_17
+        sourceCompatibility JavaVersion.VERSION_18
+        targetCompatibility JavaVersion.VERSION_18
+    }
+    kotlinOptions {
+        jvmTarget = '18'
     }
-
     defaultConfig {
         // TODO: Specify your own unique Application ID (https://developer.android.com/studio/build/application-id.html).
         applicationId "com.baseflow.permissionhandler.example"

permission_handler/example/android/gradle.properties

@@ -1,3 +1,3 @@
-org.gradle.jvmargs=-Xmx1536M
+org.gradle.jvmargs=-Xmx4G
 android.useAndroidX=true
 android.enableJetifier=true

permission_handler/example/ios/Flutter/AppFrameworkInfo.plist

@@ -20,7 +20,5 @@
   <string>????</string>
   <key>CFBundleVersion</key>
   <string>1.0</string>
-  <key>MinimumOSVersion</key>
-  <string>12.0</string>
 </dict>
 </plist>

permission_handler/example/ios/Podfile

@@ -1,7 +1,4 @@
-# Uncomment this line to define a global platform for your project
-# platform :ios, '12.0'
-
-# CocoaPods analytics sends network stats synchronously affecting flutter build latency.
+platform :ios, '13.0'
 ENV['COCOAPODS_DISABLE_STATS'] = 'true'
 
 project 'Runner', {
@@ -39,61 +36,30 @@ post_install do |installer|
     flutter_additional_ios_build_settings(target)
 
     target.build_configurations.each do |config|
-      # You can remove unused permissions here
-      # for more infomation: https://github.com/Baseflow/flutter-permission-handler/blob/main/permission_handler_apple/ios/Classes/PermissionHandlerEnums.h
-      # e.g. when you don't need camera permission, just add 'PERMISSION_CAMERA=0'
+      # You can remove unused permissions here.
+      # For more information:
+      # https://github.com/Baseflow/flutter-permission-handler/blob/main/permission_handler_apple/ios/Classes/PermissionHandlerEnums.h
       config.build_settings['GCC_PREPROCESSOR_DEFINITIONS'] ||= [
         '$(inherited)',
-
-        ## dart: [PermissionGroup.calendarWriteOnly, PermissionGroup.calendar (until iOS 16)]
         'PERMISSION_EVENTS=1',
-
-        ## dart: [PermissionGroup.calendarFullAccess, PermissionGroup.calendar (from iOS 17)]
-       'PERMISSION_EVENTS_FULL_ACCESS=1',
-
-        ## dart: PermissionGroup.reminders
+        'PERMISSION_EVENTS_FULL_ACCESS=1',
         'PERMISSION_REMINDERS=1',
-
-        ## dart: PermissionGroup.contacts
         'PERMISSION_CONTACTS=1',
-
-        ## dart: PermissionGroup.camera
         'PERMISSION_CAMERA=1',
-
-        ## dart: PermissionGroup.microphone
         'PERMISSION_MICROPHONE=1',
-
-        ## dart: PermissionGroup.speech
         'PERMISSION_SPEECH_RECOGNIZER=1',
-
-        ## dart: PermissionGroup.photos
         'PERMISSION_PHOTOS=1',
-
-        ## dart: [PermissionGroup.location, PermissionGroup.locationAlways, PermissionGroup.locationWhenInUse]
         'PERMISSION_LOCATION=1',
-
-        ## dart: PermissionGroup.notification
+        'PERMISSION_LOCATION_WHENINUSE=0',
         'PERMISSION_NOTIFICATIONS=1',
-
-        ## dart: PermissionGroup.mediaLibrary
         'PERMISSION_MEDIA_LIBRARY=1',
-
-        ## dart: PermissionGroup.sensors
         'PERMISSION_SENSORS=1',
-
-        ## dart: PermissionGroup.bluetooth
         'PERMISSION_BLUETOOTH=1',
-
-        ## dart: PermissionGroup.appTrackingTransparency
         'PERMISSION_APP_TRACKING_TRANSPARENCY=1',
-
-        ## dart: PermissionGroup.criticalAlerts
         'PERMISSION_CRITICAL_ALERTS=1',
-
-        ## dart: PermissionGroup.assistant
         'PERMISSION_ASSISTANT=1',
       ]
-
     end
   end
 end
+