[#48] [Part-1] As a developer, I can request permission in Compose

[thawzintoe-ptut]

#48

What happened 👀

This PR adds Jetpack Compose support to the library and introduces permission handling utilities for Compose apps.

Changes:

• Added Compose dependencies (Compose BOM, Runtime, Runtime Saveable)
• Added Accompanist Permissions library
• Created PermissionExt.kt with three main utilities:
  • PermissionsHandler - Data class to manage permission state
  • rememberPermissionHandler() - Composable to handle single permissions
  • HandlePermissionsRequest() - Composable wrapper for permission flows
• Included permanent denial detection logic
• Added comprehensive unit tests for PermissionsHandler data class
• Updated Gradle dependencies and enabled Compose compiler plugin

Insight 📝

Why this approach:

The permission utilities wrap Accompanist's permission APIs with a cleaner interface. The key addition is permanent denial detection - tracking when users select "Don't ask again" on Android. This state isn't directly provided by the system, so we track the transition from showing rationale to not showing rationale while the permission remains denied.

Implementation details:

1. rememberPermanentDenialTracking() uses rememberSaveable to persist state across configuration changes and detects the rationale → no rationale transition
2. PermissionsHandler is an @Immutable data class for predictable Compose recomposition
3. The openSettings function uses the existing getAppSettingsIntent() extension from ContextExt.kt

Related:

• Accompanist Permissions Documentation
• Android Permissions Best Practices

Proof Of Work 📹

Note

I didn't add POC codes in this PR.

Screen_recording_20260113_094931.webm

[github-actions]

	2 Warnings
⚠️	Uh oh! PermissionExt.kt is under 95% coverage!
⚠️	Uh oh! Your project is under 80% coverage!

Kover report for Android Common Extensions

🧛 Android Common Extensions Unit Tests Code Coverage: 41.67%

Coverage of Modified Files:

File	Coverage
PermissionExt.kt	13.46%

Modified Files Not Found In Coverage Report:

PermissionExtTest.kt
build.gradle.kts
libs.versions.toml

Codebase cunningly covered by count Shroud 🧛

Generated by 🚫 Danger

[RkNaing]

Hi @thawzintoe-ptut 👋 , IMHO, it would be nice to place the implementation under package co.nimblehq.common.compose.permission. CC: @hoangnguyen92dn 🙇

co.nimblehq.common
├── compose
│   └── permission
│
└── extensions

[hoangnguyen92dn]

@thawzintoe-ptut Please add sample usage of permission in :app model, if the code changes requires adding a lot of file changes, you could open part 2 instead.

[thawzintoe-ptut]

updated fbbd521. FYI: I will create part-2 for simple usage permission. 🙏