Fix: Return correct permission status for Android's limited media access

[VladShturma]

This PR fixes the issue https://github.com/Baseflow/flutter-permission-handler/issues/1243

Before fix when selecting 'Selected Photos Access enabled' on Android 14 the code await Permission.photos.request(); returned PermissionStatus.denied. After fix it returns PermissionStatus.limited

Pre-launch Checklist

• [X] I made sure the project builds.
• [X] I read the Contributor Guide and followed the process outlined there for submitting PRs.
• [X] I updated pubspec.yaml with an appropriate new version according to the pub versioning philosophy, or this PR is does not need version changes.
• [X] I updated CHANGELOG.md to add a description of the change.
• [X] I updated/added relevant documentation (doc comments with ///).
• [X] I rebased onto main.
• [X] I added new tests to check the change I am making, or this PR does not need tests.
• [X] I made sure all existing and new tests are passing.
• [X] I ran dart format . and committed any changes.
• [X] I ran flutter analyze and fixed any errors.

[LulleBulle]

nice job @VladShturma. I was looking at it the other day but did not understand why requestPermissions implementation was not enough and I had some issues locating the success callback but now saw that the comment above mentions onRequestPermissionsResult

[LulleBulle]

I have tried it in the examples app and I still get that it returns denied. @VladShturma @mvanbeusekom

[VladShturma]

@LulleBulle are you using example app that is inside permission_handler_android directory? Because I also checked in example app and it returns limited

[LulleBulle]

@LulleBulle are you using example app that is inside permission_handler_android directory? Because I also checked in example app and it returns limited

Yes, I might have had some issues with gradle not compiling correctly and using an old version. Thanks for verifying for me :)