flutter-permission-handler icon indicating copy to clipboard operation
flutter-permission-handler copied to clipboard

[Enhancement proposal]: Permission Table Documentation

Open TheFinestArtist opened this issue 8 months ago • 2 comments

Please check the following before submitting a new issue.

Please select affected platform(s)

  • [X] Android
  • [X] iOS
  • [X] Windows

Proposal

Untitled

I was collecting information regarding permissions that I need to support the app I am working on. I think it would be amazing for this library to support such information as a table.

Example Table

Permission OS Supporting API Related Doc Permission Name Permission Status
Notification Android API Level 33 or higher Doc notification granted, denied, permanentlyDenied
Do Not Disturb Android API Level 23 or higher Doc accessNotificationPolicy granted, denied

Pitch

iOS, Android, Windows, etc permissions is one of the most confusing features to support for not only engineers but product managers or even designers. It would be a great contribution to the community if there is a single source that accumulates all the information in one place. The whole front-end development community will be beneficial out of this.

It will also be helpful for this library to maintain permission easier.

TheFinestArtist avatar Oct 27 '23 05:10 TheFinestArtist

Hi @TheFinestArtist, thank you for bringing this up.

We agree that a table that provides an overview of the permissions and what they reflect is desirable. We are currently working on a major refactor of the plugin, which will, amongst other things, change how platform specific permissions are accessed. We decided that it is probably best to wait for the refactor to land before publishing such a table, as the refactor will change a substantial amount of the info that will be in the table. I will mark this issue as refactor, so we get reminded about it once the refactor lands.

JeroenWeener avatar Oct 30 '23 12:10 JeroenWeener

Sounds like a plan, Jeroen! I will look forward to the new big update and revisiting this documentation after then.

TheFinestArtist avatar Oct 31 '23 09:10 TheFinestArtist