grant-compose/dev.brewkits.grant.compose/GrantDialogStrings

GrantDialogStrings

data class GrantDialogStrings(val rationaleTitle: String = "Permission Required", val rationaleConfirm: String = "Continue", val rationaleDismiss: String = "Cancel", val settingsTitle: String = "Permission Denied", val settingsConfirm: String = "Open Settings", val settingsDismiss: String = "Cancel", val serviceSettingsTitle: String = "Service Required", val serviceSettingsConfirm: String = "Enable Service", val serviceSettingsDismiss: String = "Cancel", val rationaleMessage: String = "This permission is needed for this feature to work properly.", val settingsMessage: String = "This permission was denied. Please enable it in Settings.", val serviceSettingsMessage: String = "This service needs to be enabled for this feature to work.")

All user-visible strings shown by GrantDialog, GrantGroupDialog, and GrantAndServiceDialog.

The library ships English defaults as a last-resort fallback only. Host apps own the translation responsibility — set your strings once at the top of the composition tree via GrantDialogStringsProvider and every GrantDialog call in the subtree picks them up automatically.

// In your app theme / root composable — do this ONCE:
GrantDialogStringsProvider(
    strings = GrantDialogStrings(
        rationaleTitle   = stringResource(Res.string.grant_rationale_title),
        rationaleConfirm = stringResource(Res.string.grant_ok),
        rationaleDismiss = stringResource(Res.string.grant_cancel),
        settingsTitle    = stringResource(Res.string.grant_settings_title),
        settingsConfirm  = stringResource(Res.string.grant_open_settings),
        settingsDismiss  = stringResource(Res.string.grant_cancel),
    )
) {
    // Every GrantDialog() call inside here uses the strings above.
    MyAppContent()
}

Individual call sites can still override a single dialog's text by passing a strings parameter directly to GrantDialog.

Constructors

GrantDialogStrings

constructor(rationaleTitle: String = "Permission Required", rationaleConfirm: String = "Continue", rationaleDismiss: String = "Cancel", settingsTitle: String = "Permission Denied", settingsConfirm: String = "Open Settings", settingsDismiss: String = "Cancel", serviceSettingsTitle: String = "Service Required", serviceSettingsConfirm: String = "Enable Service", serviceSettingsDismiss: String = "Cancel", rationaleMessage: String = "This permission is needed for this feature to work properly.", settingsMessage: String = "This permission was denied. Please enable it in Settings.", serviceSettingsMessage: String = "This service needs to be enabled for this feature to work.")