Ionic Framework 4 is almost here. Preview the beta docs and try it out now! Try Ionic 4 Beta

Android Permissions

Improve this doc

This plugin is designed to support Android new permissions checking mechanism.

You can find all permissions here: https://developer.android.com/reference/android/Manifest.permission.html

Repo: https://github.com/NeoLSN/cordova-plugin-android-permissions

Installation

  1. Install the Cordova and Ionic Native plugins:
    $ ionic cordova plugin add cordova-plugin-android-permissions
    $ npm install --save @ionic-native/android-permissions
    
  2. Add this plugin to your app's module

Supported platforms

Usage

import { AndroidPermissions } from '@ionic-native/android-permissions';


constructor(private androidPermissions: AndroidPermissions) { }

...

this.androidPermissions.checkPermission(this.androidPermissions.PERMISSION.CAMERA).then(
  result => console.log('Has permission?',result.hasPermission),
  err => this.androidPermissions.requestPermission(this.androidPermissions.PERMISSION.CAMERA)
);

this.androidPermissions.requestPermissions([this.androidPermissions.PERMISSION.CAMERA, this.androidPermissions.PERMISSION.GET_ACCOUNTS]);

Android 26 and above: due to Android 26's changes to permissions handling (permissions are requested at time of use rather than at runtime,) if your app does not include any functions (eg. other Ionic Native plugins) that utilize a particular permission, then requestPermission() and requestPermissions() will resolve immediately with no prompt shown to the user. Thus, you must include a function utilizing the feature you would like to use before requesting permission for it.

Instance Members

PERMISSION

checkPermission(permission)

Check permission

Param Type Details
permission string

The name of the permission

Returns: Promise<any> Returns a promise

requestPermission(permission)

Request permission

Param Type Details
permission string

The name of the permission to request

Returns: Promise<any>

requestPermissions(permissions)

Request permissions

Param Type Details
permissions Array<string>

An array with permissions

Returns: Promise<any> Returns a promise

hasPermission(permission)

This function still works now, will not support in the future.

Param Type Details
permission string

The name of the permission

Returns: Promise<any> Returns a promise

API

Native

General