Android Permissions API
Android has an interesting way of handling permissions. You first have to declare the permission in the AndroidManifest.xml file, and then at runtime some permissions need to be 'requested' which gives the user and opportunity to deny that permission after your app is installed.
It was not always this way however. Before Android 6 you only had to declare the permission in the manifest (and the runtime request api was not available).
Fuse unifies these two different declarations to hopefully make android's approach slightly easier to work with.
Let's look and an example and then we will break it down:
public void TakePicture(object a1, EventArgs a2)
{
var permissionPromise = Permissions.Request(Permissions.Android.CAMERA); // [0]
permissionPromise.Then(OnPermitted, OnRejected); // [1]
}
void OnPermitted(PlatformPermission permission)
{
debug_log "Woo, we can take the picture now";
}
void OnRejected(Exception e)
{
debug_log "Blast: " + e.Message;
}[0] - Here we request the permission by calling the Request method and passing in the permission we want to be granted. Simply be referencing that permission Fuse will add it to your AndroidManifest.xml file.
[1] - We now specify which method to call if the permission is granted or if the permission is rejected.
And that's all there is to it!
What happens on older Android versions?
If you are on and older version of Android (from before the runtime permission request API) the request will always succeed.
Can I request multiple permissions at once?
Yes! Just pass an array of PlatformPermission objects to the Request method and make sure your OnPermitted method also takes an array of PlatformPermission objects.
What permissions are requestable by default?
ACCESS_CHECKIN_PROPERTIESACCESS_COARSE_LOCATIONACCESS_FINE_LOCATIONACCESS_LOCATION_EXTRA_COMMANDSACCESS_MOCK_LOCATIONACCESS_NETWORK_STATEACCESS_SURFACE_FLINGERACCESS_WIFI_STATEACCOUNT_MANAGERADD_VOICEMAILAUTHENTICATE_ACCOUNTSBATTERY_STATSBIND_ACCESSIBILITY_SERVICEBIND_APPWIDGETBIND_DEVICE_ADMINBIND_DREAM_SERVICEBIND_INPUT_METHODBIND_NFC_SERVICEBIND_NOTIFICATION_LISTENER_SERVICEBIND_PRINT_SERVICEBIND_REMOTEVIEWSBIND_TEXT_SERVICEBIND_TV_INPUTBIND_VOICE_INTERACTIONBIND_VPN_SERVICEBIND_WALLPAPERBLUETOOTHBLUETOOTH_ADMINBLUETOOTH_PRIVILEGEDBODY_SENSORSBRICKBROADCAST_PACKAGE_REMOVEDBROADCAST_SMSBROADCAST_STICKYBROADCAST_WAP_PUSHCALL_PHONECALL_PRIVILEGEDCAMERACAPTURE_AUDIO_OUTPUTCAPTURE_SECURE_VIDEO_OUTPUTCAPTURE_VIDEO_OUTPUTCHANGE_COMPONENT_ENABLED_STATECHANGE_CONFIGURATIONCHANGE_NETWORK_STATECHANGE_WIFI_MULTICAST_STATECHANGE_WIFI_STATECLEAR_APP_CACHECLEAR_APP_USER_DATACONTROL_LOCATION_UPDATESDELETE_CACHE_FILESDELETE_PACKAGESDEVICE_POWERDIAGNOSTICDISABLE_KEYGUARDDUMPEXPAND_STATUS_BARFACTORY_TESTFLASHLIGHTFORCE_BACKGET_ACCOUNTSGET_PACKAGE_SIZEGET_TASKSGET_TOP_ACTIVITY_INFOGLOBAL_SEARCHHARDWARE_TESTINJECT_EVENTSINSTALL_LOCATION_PROVIDERINSTALL_PACKAGESINSTALL_SHORTCUTINTERNAL_SYSTEM_WINDOWINTERNETKILL_BACKGROUND_PROCESSESLOCATION_HARDWAREMANAGE_ACCOUNTSMANAGE_APP_TOKENSMANAGE_DOCUMENTSMASTER_CLEARMEDIA_CONTENT_CONTROLMODIFY_AUDIO_SETTINGSMODIFY_PHONE_STATEMOUNT_FORMAT_FILESYSTEMSMOUNT_UNMOUNT_FILESYSTEMSNFCPERSISTENT_ACTIVITYPROCESS_OUTGOING_CALLSREAD_CALENDARREAD_CALL_LOGREAD_CONTACTSREAD_EXTERNAL_STORAGEREAD_FRAME_BUFFERREAD_HISTORY_BOOKMARKSREAD_INPUT_STATEREAD_LOGSREAD_PHONE_STATEREAD_PROFILEREAD_SMSREAD_SOCIAL_STREAMREAD_SYNC_SETTINGSREAD_SYNC_STATSREAD_USER_DICTIONARYREAD_VOICEMAILREBOOTRECEIVE_BOOT_COMPLETEDRECEIVE_MMSRECEIVE_SMSRECEIVE_WAP_PUSHRECORD_AUDIOREORDER_TASKSRESTART_PACKAGESSEND_RESPOND_VIA_MESSAGESEND_SMSSET_ACTIVITY_WATCHERSET_ALARMSET_ALWAYS_FINISHSET_ANIMATION_SCALESET_DEBUG_APPSET_ORIENTATIONSET_POINTER_SPEEDSET_PREFERRED_APPLICATIONSSET_PROCESS_LIMITSET_TIMESET_TIME_ZONESET_WALLPAPERSET_WALLPAPER_HINTSSIGNAL_PERSISTENT_PROCESSESSTATUS_BARSUBSCRIBED_FEEDS_READSUBSCRIBED_FEEDS_WRITESYSTEM_ALERT_WINDOWTRANSMIT_IRUNINSTALL_SHORTCUTUPDATE_DEVICE_STATSUSE_CREDENTIALSUSE_SIPVIBRATEWAKE_LOCKWRITE_APN_SETTINGSWRITE_CALENDARWRITE_CALL_LOGWRITE_CONTACTSWRITE_EXTERNAL_STORAGEWRITE_GSERVICESWRITE_HISTORY_BOOKMARKSWRITE_PROFILEWRITE_SECURE_SETTINGSWRITE_SETTINGSWRITE_SMSWRITE_SOCIAL_STREAMWRITE_SYNC_SETTINGSWRITE_USER_DICTIONARYWRITE_VOICEMAIL