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

[VladShturma]

This PR fixes the issue #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

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