blob: 0dae4dfbc1385a4fddbe4a3aa58095e9bf474e1b [file] [log] [blame]
<?xml version="1.0" encoding="UTF-8"?>
<!--
Copyright 2015 The Android Open Source Project
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
-->
<sample>
<name>RuntimePermissionsBasic</name>
<group>System</group>
<package>com.example.android.basicpermissions</package>
<minSdk>15</minSdk>
<strings>
<intro>
<![CDATA[
This sample shows a basic implementation for requesting permissions at runtime. Click the button to request the Camera permission and open a full-screen camera preview.
Note: The "RuntimePermissions" sample provides a more complete overview over the runtime permission features available.
]]>
</intro>
</strings>
<template src="base-build"/>
<metadata>
<status>PUBLISHED</status>
<categories>System</categories>
<technologies>Android</technologies>
<languages>Java</languages>
<solutions>Mobile</solutions>
<level>BEGINNER</level>
<icon>screenshots/big_icon.png</icon>
<screenshots>
<img>screenshots/screenshot-1.png</img>
</screenshots>
<api_refs>
<android>android.app.Activity</android>
<android>android.Manifest.permission</android>
</api_refs>
<description>
<![CDATA[
This basic sample shows runtime permissions available in the Android M and above.
It shows how to use the new runtime permissions API to check and request permissions through the
support library.
]]>
</description>
<intro>
<![CDATA[
Android M introduced runtime permissions. Applications targeting M and above need to request their
permissions at runtime.
This sample introduces the basic use of the runtime permissions API through the support library by
verifying permissions (ActivityCompat#checkSelfPermission(Context, String)), requesting permissions (ActivityCompat#requestPermissions(Activity, String[], int))
and handling the permission request callback (ActivityCompat.OnRequestPermissionsResultCallback).
An application can display additional context and justification for a permission after calling
ActivityCompat#shouldShowRequestPermissionRationale#shouldShowRequestPermissionRationale(Activity, String).
See the "RuntimePermissions" sample for a more complete description and reference implementation.
]]>
</intro>
</metadata>
</sample>