mirror of
https://github.com/facebook/react-native.git
synced 2025-11-01 09:14:26 +00:00
Website Deployment Script
d6c8c31cb1
Deploy website version based on aa6bca5d8b7a59a46c8e4e5a6803f43206c13b65
219 lines
39 KiB
HTML
219 lines
39 KiB
HTML
<!DOCTYPE html><html lang="en"><head><meta charSet="utf-8"/><meta http-equiv="X-UA-Compatible" content="IE=edge"/><title>PermissionsAndroid · React Native</title><meta name="viewport" content="width=device-width"/><meta name="generator" content="Docusaurus"/><meta name="description" content="<div class="banner-crna-ejected">"/><meta name="docsearch:version" content="0.56"/><meta name="docsearch:language" content="en"/><meta property="og:title" content="PermissionsAndroid · React Native"/><meta property="og:type" content="website"/><meta property="og:url" content="https://reactnative.dev/"/><meta property="og:description" content="<div class="banner-crna-ejected">"/><meta property="og:image" content="https://reactnative.dev/img/logo-og.png"/><meta name="twitter:card" content="summary"/><meta name="twitter:image" content="https://reactnative.dev/img/logo-og.png"/><link rel="shortcut icon" href="/img/favicon.ico"/><link rel="stylesheet" href="https://cdn.jsdelivr.net/docsearch.js/1/docsearch.min.css"/><link rel="stylesheet" href="//cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/styles/solarized-dark.min.css"/><link rel="alternate" type="application/atom+xml" href="https://reactnative.dev/blog/atom.xml" title="React Native Blog ATOM Feed"/><link rel="alternate" type="application/rss+xml" href="https://reactnative.dev/blog/feed.xml" title="React Native Blog RSS Feed"/><script>
|
||
(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
|
||
(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
|
||
m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
|
||
})(window,document,'script','https://www.google-analytics.com/analytics.js','ga');
|
||
|
||
ga('create', 'UA-41298772-2', 'auto');
|
||
ga('send', 'pageview');
|
||
</script><script type="text/javascript" src="https://cdn.jsdelivr.net/npm/focus-visible@5.0.2/dist/focus-visible.min.js"></script><script type="text/javascript" src="https://snack.expo.io/embed.js"></script><script type="text/javascript" src="https://platform.twitter.com/widgets.js"></script><script type="text/javascript" src="https://buttons.github.io/buttons.js"></script><script type="text/javascript" src="/js/codeblocks.js"></script><script type="text/javascript" src="/js/tabs.js"></script><script type="text/javascript" src="/js/docs-rating.js"></script><script src="https://unpkg.com/vanilla-back-to-top@7.1.14/dist/vanilla-back-to-top.min.js"></script><script>
|
||
document.addEventListener('DOMContentLoaded', function() {
|
||
addBackToTop(
|
||
{"zIndex":100}
|
||
)
|
||
});
|
||
</script><script src="/js/scrollSpy.js"></script><link rel="stylesheet" href="/css/prism.css"/><link rel="stylesheet" href="/css/main.css"/><script src="/js/codetabs.js"></script></head><body class="sideNavVisible separateOnPageNav"><div class="fixedHeaderContainer"><div class="headerWrapper wrapper"><header><a href="/"><img class="logo" src="/img/header_logo.svg" alt="React Native"/><h2 class="headerTitleWithLogo">React Native</h2></a><a href="/versions"><h3>0.56</h3></a><div class="navigationWrapper navigationSlider"><nav class="slidingNav"><ul class="nav-site nav-site-internal"><li class="siteNavGroupActive"><a href="/docs/0.56/getting-started" target="_self">Docs</a></li><li class="siteNavGroupActive"><a href="/docs/0.56/components-and-apis" target="_self">Components</a></li><li class="siteNavGroupActive"><a href="/docs/0.56/accessibilityinfo" target="_self">API</a></li><li class=""><a href="/help" target="_self">Community</a></li><li class=""><a href="/blog/" target="_self">Blog</a></li><li class="navSearchWrapper reactNavSearchWrapper"><input type="text" id="search_input_react" placeholder="Search" title="Search"/></li><li class=""><a href="https://github.com/facebook/react-native" target="_self">GitHub</a></li></ul></nav></div></header></div></div><div class="navPusher"><div class="docMainWrapper wrapper"><div class="docsNavContainer" id="docsNav"><nav class="toc"><div class="toggleNav"><section class="navWrapper wrapper"><div class="navBreadcrumb wrapper"><div class="navToggle" id="navToggler"><div class="hamburger-menu"><div class="line1"></div><div class="line2"></div><div class="line3"></div></div></div><h2><i>›</i><span>APIs</span></h2><div class="tocToggler" id="tocToggler"><i class="icon-toc"></i></div></div><div class="navGroups"><div class="navGroup"><h3 class="navGroupCategoryTitle collapsible">The Basics<span class="arrow"><svg width="24" height="24" viewBox="0 0 24 24"><path fill="#565656" d="M7.41 15.41L12 10.83l4.59 4.58L18 14l-6-6-6 6z"></path><path d="M0 0h24v24H0z" fill="none"></path></svg></span></h3><ul class="hide"><li class="navListItem"><a class="navItem" href="/docs/0.56/getting-started">Getting Started</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/tutorial">Learn the Basics</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/props">Props</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/state">State</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/style">Style</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/height-and-width">Height and Width</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/flexbox">Layout with Flexbox</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/handling-text-input">Handling Text Input</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/handling-touches">Handling Touches</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/using-a-scrollview">Using a ScrollView</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/using-a-listview">Using List Views</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/network">Networking</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/more-resources">More Resources</a></li></ul></div><div class="navGroup"><h3 class="navGroupCategoryTitle collapsible">Guides<span class="arrow"><svg width="24" height="24" viewBox="0 0 24 24"><path fill="#565656" d="M7.41 15.41L12 10.83l4.59 4.58L18 14l-6-6-6 6z"></path><path d="M0 0h24v24H0z" fill="none"></path></svg></span></h3><ul class="hide"><li class="navListItem"><a class="navItem" href="/docs/0.56/components-and-apis">Components and APIs</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/platform-specific-code">Platform Specific Code</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/navigation">Navigating Between Screens</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/images">Images</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/animations">Animations</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/accessibility">Accessibility</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/improvingux">Improving User Experience</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/timers">Timers</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/debugging">Debugging</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/performance">Performance</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/gesture-responder-system">Gesture Responder System</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/javascript-environment">JavaScript Environment</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/direct-manipulation">Direct Manipulation</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/colors">Color Reference</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/integration-with-existing-apps">Integration with Existing Apps</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/building-for-tv">Building For TV Devices</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/running-on-device">Running On Device</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/upgrading">Upgrading to new React Native versions</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/troubleshooting">Troubleshooting</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/native-modules-setup">Native Modules Setup</a></li></ul></div><div class="navGroup"><h3 class="navGroupCategoryTitle collapsible">Guides (iOS)<span class="arrow"><svg width="24" height="24" viewBox="0 0 24 24"><path fill="#565656" d="M7.41 15.41L12 10.83l4.59 4.58L18 14l-6-6-6 6z"></path><path d="M0 0h24v24H0z" fill="none"></path></svg></span></h3><ul class="hide"><li class="navListItem"><a class="navItem" href="/docs/0.56/native-modules-ios">Native Modules</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/native-components-ios">Native UI Components</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/linking-libraries-ios">Linking Libraries</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/running-on-simulator-ios">Running On Simulator</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/communication-ios">Communication between native and React Native</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/app-extensions">App Extensions</a></li></ul></div><div class="navGroup"><h3 class="navGroupCategoryTitle collapsible">Guides (Android)<span class="arrow"><svg width="24" height="24" viewBox="0 0 24 24"><path fill="#565656" d="M7.41 15.41L12 10.83l4.59 4.58L18 14l-6-6-6 6z"></path><path d="M0 0h24v24H0z" fill="none"></path></svg></span></h3><ul class="hide"><li class="navListItem"><a class="navItem" href="/docs/0.56/native-modules-android">Native Modules</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/native-components-android">Native UI Components</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/headless-js-android">Headless JS</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/signed-apk-android">Publishing to Google Play Store</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/removing-default-permissions">Removing Default Permissions</a></li></ul></div><div class="navGroup"><h3 class="navGroupCategoryTitle collapsible">Components<span class="arrow"><svg width="24" height="24" viewBox="0 0 24 24"><path fill="#565656" d="M7.41 15.41L12 10.83l4.59 4.58L18 14l-6-6-6 6z"></path><path d="M0 0h24v24H0z" fill="none"></path></svg></span></h3><ul class="hide"><li class="navListItem"><a class="navItem" href="/docs/0.56/activityindicator">ActivityIndicator</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/button">Button</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/datepickerios">DatePickerIOS</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/drawerlayoutandroid">DrawerLayoutAndroid</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/flatlist">FlatList</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/image">Image</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/imagebackground">ImageBackground</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/inputaccessoryview">InputAccessoryView</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/keyboardavoidingview">KeyboardAvoidingView</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/listview">ListView</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/maskedviewios">MaskedViewIOS</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/modal">Modal</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/navigatorios">NavigatorIOS</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/picker">Picker</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/pickerios">PickerIOS</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/progressbarandroid">ProgressBarAndroid</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/progressviewios">ProgressViewIOS</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/refreshcontrol">RefreshControl</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/safeareaview">SafeAreaView</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/scrollview">ScrollView</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/sectionlist">SectionList</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/segmentedcontrolios">SegmentedControlIOS</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/slider">Slider</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/snapshotviewios">SnapshotViewIOS</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/statusbar">StatusBar</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/switch">Switch</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/tabbarios">TabBarIOS</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/tabbarios-item">TabBarIOS.Item</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/text">Text</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/textinput">TextInput</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/toolbarandroid">ToolbarAndroid</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/touchablehighlight">TouchableHighlight</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/touchablenativefeedback">TouchableNativeFeedback</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/touchableopacity">TouchableOpacity</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/touchablewithoutfeedback">TouchableWithoutFeedback</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/view">View</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/viewpagerandroid">ViewPagerAndroid</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/virtualizedlist">VirtualizedList</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/webview">WebView</a></li></ul></div><div class="navGroup"><h3 class="navGroupCategoryTitle collapsible">APIs<span class="arrow"><svg width="24" height="24" viewBox="0 0 24 24"><path fill="#565656" d="M7.41 15.41L12 10.83l4.59 4.58L18 14l-6-6-6 6z"></path><path d="M0 0h24v24H0z" fill="none"></path></svg></span></h3><ul class="hide"><li class="navListItem"><a class="navItem" href="/docs/0.56/accessibilityinfo">AccessibilityInfo</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/actionsheetios">ActionSheetIOS</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/alert">Alert</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/alertios">AlertIOS</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/animated">Animated</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/appregistry">AppRegistry</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/appstate">AppState</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/asyncstorage">AsyncStorage</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/backandroid">BackAndroid</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/backhandler">BackHandler</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/cameraroll">CameraRoll</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/clipboard">Clipboard</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/datepickerandroid">DatePickerAndroid</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/dimensions">Dimensions</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/easing">Easing</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/geolocation">Geolocation</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/imageeditor">ImageEditor</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/imagepickerios">ImagePickerIOS</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/imagestore">ImageStore</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/image-style-props">Image Style Props</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/interactionmanager">InteractionManager</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/keyboard">Keyboard</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/layout-props">Layout Props</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/layoutanimation">LayoutAnimation</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/linking">Linking</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/listviewdatasource">ListViewDataSource</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/netinfo">NetInfo</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/panresponder">PanResponder</a></li><li class="navListItem navListItemActive"><a class="navItem" href="/docs/0.56/permissionsandroid">PermissionsAndroid</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/pixelratio">PixelRatio</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/pushnotificationios">PushNotificationIOS</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/settings">Settings</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/shadow-props">Shadow Props</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/share">Share</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/statusbarios">StatusBarIOS</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/stylesheet">StyleSheet</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/systrace">Systrace</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/text-style-props">Text Style Props</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/timepickerandroid">TimePickerAndroid</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/toastandroid">ToastAndroid</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/transforms">Transforms</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/vibration">Vibration</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/vibrationios">VibrationIOS</a></li><li class="navListItem"><a class="navItem" href="/docs/0.56/view-style-props">View Style Props</a></li></ul></div></div></section></div><script>
|
||
var coll = document.getElementsByClassName('collapsible');
|
||
var checkActiveCategory = true;
|
||
for (var i = 0; i < coll.length; i++) {
|
||
var links = coll[i].nextElementSibling.getElementsByTagName('*');
|
||
if (checkActiveCategory){
|
||
for (var j = 0; j < links.length; j++) {
|
||
if (links[j].classList.contains('navListItemActive')){
|
||
coll[i].nextElementSibling.classList.toggle('hide');
|
||
coll[i].childNodes[1].classList.toggle('rotate');
|
||
checkActiveCategory = false;
|
||
break;
|
||
}
|
||
}
|
||
}
|
||
|
||
coll[i].addEventListener('click', function() {
|
||
var arrow = this.childNodes[1];
|
||
arrow.classList.toggle('rotate');
|
||
var content = this.nextElementSibling;
|
||
content.classList.toggle('hide');
|
||
});
|
||
}
|
||
|
||
document.addEventListener('DOMContentLoaded', function() {
|
||
createToggler('#navToggler', '#docsNav', 'docsSliderActive');
|
||
createToggler('#tocToggler', 'body', 'tocActive');
|
||
|
||
var headings = document.querySelector('.toc-headings');
|
||
headings && headings.addEventListener('click', function(event) {
|
||
var el = event.target;
|
||
while(el !== headings){
|
||
if (el.tagName === 'A') {
|
||
document.body.classList.remove('tocActive');
|
||
break;
|
||
} else{
|
||
el = el.parentNode;
|
||
}
|
||
}
|
||
}, false);
|
||
|
||
function createToggler(togglerSelector, targetSelector, className) {
|
||
var toggler = document.querySelector(togglerSelector);
|
||
var target = document.querySelector(targetSelector);
|
||
|
||
if (!toggler) {
|
||
return;
|
||
}
|
||
|
||
toggler.onclick = function(event) {
|
||
event.preventDefault();
|
||
|
||
target.classList.toggle(className);
|
||
};
|
||
}
|
||
});
|
||
</script></nav></div><div class="container mainContainer docsContainer"><div class="wrapper"><div class="post"><header class="postHeader"><a class="edit-page-link button" href="https://github.com/facebook/react-native-website/blob/master/docs/permissionsandroid.md" target="_blank" rel="noreferrer noopener">Edit</a><h1 id="__docusaurus" class="postHeaderTitle">PermissionsAndroid</h1></header><article><div><span><div class="banner-crna-ejected">
|
||
<h3>Project with Native Code Required</h3>
|
||
<p>
|
||
This API only works in projects made with <code>react-native init</code>
|
||
or in those made with Create React Native App which have since ejected. For
|
||
more information about ejecting, please see
|
||
the <a href="https://github.com/react-community/create-react-native-app/blob/master/EJECTING.md" target="_blank">guide</a> on
|
||
the Create React Native App repository.
|
||
</p>
|
||
</div>
|
||
<p><code>PermissionsAndroid</code> provides access to Android M's new permissions model. The so-called "normal" permissions are granted by default when the application is installed as long as they appear in <code>AndroidManifest.xml</code>. However, "dangerous" permissions require a dialog prompt. You should use this module for those permissions.</p>
|
||
<p>On devices before SDK version 23, the permissions are automatically granted if they appear in the manifest, so <code>check</code> and <code>request</code> should always resolve to <code>PermissionsAndroid.RESULTS.GRANTED</code>.</p>
|
||
<p>If a user has previously turned off a permission that you prompt for, the OS will advise your app to show a rationale for needing the permission. The optional <code>rationale</code> argument will show a dialog prompt only if necessary - otherwise the normal permission prompt will appear.</p>
|
||
<h3><a class="anchor" aria-hidden="true" id="example"></a><a href="#example" aria-hidden="true" class="hash-link"><svg class="hash-link-icon" aria-hidden="true" height="16" version="1.1" viewBox="0 0 16 16" width="16"><path fill-rule="evenodd" d="M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z"></path></svg></a>Example</h3>
|
||
<pre><code class="hljs"><span class="hljs-keyword">import</span> { PermissionsAndroid } <span class="hljs-keyword">from</span> <span class="hljs-string">'react-native'</span>;
|
||
|
||
<span class="hljs-keyword">async</span> <span class="hljs-function"><span class="hljs-keyword">function</span> <span class="hljs-title">requestCameraPermission</span>(<span class="hljs-params"></span>) </span>{
|
||
<span class="hljs-keyword">try</span> {
|
||
<span class="hljs-keyword">const</span> granted = <span class="hljs-keyword">await</span> PermissionsAndroid.request(
|
||
PermissionsAndroid.PERMISSIONS.CAMERA,
|
||
{
|
||
<span class="hljs-string">'title'</span>: <span class="hljs-string">'Cool Photo App Camera Permission'</span>,
|
||
<span class="hljs-string">'message'</span>: <span class="hljs-string">'Cool Photo App needs access to your camera '</span> +
|
||
<span class="hljs-string">'so you can take awesome pictures.'</span>
|
||
}
|
||
)
|
||
<span class="hljs-keyword">if</span> (granted === PermissionsAndroid.RESULTS.GRANTED) {
|
||
<span class="hljs-built_in">console</span>.log(<span class="hljs-string">"You can use the camera"</span>)
|
||
} <span class="hljs-keyword">else</span> {
|
||
<span class="hljs-built_in">console</span>.log(<span class="hljs-string">"Camera permission denied"</span>)
|
||
}
|
||
} <span class="hljs-keyword">catch</span> (err) {
|
||
<span class="hljs-built_in">console</span>.warn(err)
|
||
}
|
||
}
|
||
</code></pre>
|
||
<h3><a class="anchor" aria-hidden="true" id="permissions-that-require-prompting-the-user"></a><a href="#permissions-that-require-prompting-the-user" aria-hidden="true" class="hash-link"><svg class="hash-link-icon" aria-hidden="true" height="16" version="1.1" viewBox="0 0 16 16" width="16"><path fill-rule="evenodd" d="M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z"></path></svg></a>Permissions that require prompting the user</h3>
|
||
<p>Available as constants under <code>PermissionsAndroid.PERMISSIONS</code>:</p>
|
||
<ul>
|
||
<li><code>READ_CALENDAR</code>: 'android.permission.READ_CALENDAR'</li>
|
||
<li><code>WRITE_CALENDAR</code>: 'android.permission.WRITE_CALENDAR'</li>
|
||
<li><code>CAMERA</code>: 'android.permission.CAMERA'</li>
|
||
<li><code>READ_CONTACTS</code>: 'android.permission.READ_CONTACTS'</li>
|
||
<li><code>WRITE_CONTACTS</code>: 'android.permission.WRITE_CONTACTS'</li>
|
||
<li><code>GET_ACCOUNTS</code>: 'android.permission.GET_ACCOUNTS'</li>
|
||
<li><code>ACCESS_FINE_LOCATION</code>: 'android.permission.ACCESS_FINE_LOCATION'</li>
|
||
<li><code>ACCESS_COARSE_LOCATION</code>: 'android.permission.ACCESS_COARSE_LOCATION'</li>
|
||
<li><code>RECORD_AUDIO</code>: 'android.permission.RECORD_AUDIO'</li>
|
||
<li><code>READ_PHONE_STATE</code>: 'android.permission.READ_PHONE_STATE'</li>
|
||
<li><code>CALL_PHONE</code>: 'android.permission.CALL_PHONE'</li>
|
||
<li><code>READ_CALL_LOG</code>: 'android.permission.READ_CALL_LOG'</li>
|
||
<li><code>WRITE_CALL_LOG</code>: 'android.permission.WRITE_CALL_LOG'</li>
|
||
<li><code>ADD_VOICEMAIL</code>: 'com.android.voicemail.permission.ADD_VOICEMAIL'</li>
|
||
<li><code>USE_SIP</code>: 'android.permission.USE_SIP'</li>
|
||
<li><code>PROCESS_OUTGOING_CALLS</code>: 'android.permission.PROCESS_OUTGOING_CALLS'</li>
|
||
<li><code>BODY_SENSORS</code>: 'android.permission.BODY_SENSORS'</li>
|
||
<li><code>SEND_SMS</code>: 'android.permission.SEND_SMS'</li>
|
||
<li><code>RECEIVE_SMS</code>: 'android.permission.RECEIVE_SMS'</li>
|
||
<li><code>READ_SMS</code>: 'android.permission.READ_SMS'</li>
|
||
<li><code>RECEIVE_WAP_PUSH</code>: 'android.permission.RECEIVE_WAP_PUSH'</li>
|
||
<li><code>RECEIVE_MMS</code>: 'android.permission.RECEIVE_MMS'</li>
|
||
<li><code>READ_EXTERNAL_STORAGE</code>: 'android.permission.READ_EXTERNAL_STORAGE'</li>
|
||
<li><code>WRITE_EXTERNAL_STORAGE</code>: 'android.permission.WRITE_EXTERNAL_STORAGE'</li>
|
||
</ul>
|
||
<h3><a class="anchor" aria-hidden="true" id="result-strings-for-requesting-permissions"></a><a href="#result-strings-for-requesting-permissions" aria-hidden="true" class="hash-link"><svg class="hash-link-icon" aria-hidden="true" height="16" version="1.1" viewBox="0 0 16 16" width="16"><path fill-rule="evenodd" d="M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z"></path></svg></a>Result strings for requesting permissions</h3>
|
||
<p>Available as constants under <code>PermissionsAndroid.RESULTS</code>:</p>
|
||
<ul>
|
||
<li><code>GRANTED</code>: 'granted'</li>
|
||
<li><code>DENIED</code>: 'denied'</li>
|
||
<li><code>NEVER_ASK_AGAIN</code>: 'never_ask_again'</li>
|
||
</ul>
|
||
<h3><a class="anchor" aria-hidden="true" id="methods"></a><a href="#methods" aria-hidden="true" class="hash-link"><svg class="hash-link-icon" aria-hidden="true" height="16" version="1.1" viewBox="0 0 16 16" width="16"><path fill-rule="evenodd" d="M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z"></path></svg></a>Methods</h3>
|
||
<ul>
|
||
<li><a href="/docs/0.56/permissionsandroid#constructor"><code>constructor</code></a></li>
|
||
<li><a href="/docs/0.56/permissionsandroid#check"><code>check</code></a></li>
|
||
<li><a href="/docs/0.56/permissionsandroid#request"><code>request</code></a></li>
|
||
<li><a href="/docs/0.56/permissionsandroid#requestmultiple"><code>requestMultiple</code></a></li>
|
||
</ul>
|
||
<hr>
|
||
<h1><a class="anchor" aria-hidden="true" id="reference"></a><a href="#reference" aria-hidden="true" class="hash-link"><svg class="hash-link-icon" aria-hidden="true" height="16" version="1.1" viewBox="0 0 16 16" width="16"><path fill-rule="evenodd" d="M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z"></path></svg></a>Reference</h1>
|
||
<h2><a class="anchor" aria-hidden="true" id="methods-1"></a><a href="#methods-1" aria-hidden="true" class="hash-link"><svg class="hash-link-icon" aria-hidden="true" height="16" version="1.1" viewBox="0 0 16 16" width="16"><path fill-rule="evenodd" d="M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z"></path></svg></a>Methods</h2>
|
||
<h3><a class="anchor" aria-hidden="true" id="constructor"></a><a href="#constructor" aria-hidden="true" class="hash-link"><svg class="hash-link-icon" aria-hidden="true" height="16" version="1.1" viewBox="0 0 16 16" width="16"><path fill-rule="evenodd" d="M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z"></path></svg></a><code>constructor()</code></h3>
|
||
<pre><code class="hljs css language-jsx"><span class="token function">constructor</span><span class="token punctuation">(</span><span class="token punctuation">)</span><span class="token punctuation">;</span>
|
||
</code></pre>
|
||
<hr>
|
||
<h3><a class="anchor" aria-hidden="true" id="check"></a><a href="#check" aria-hidden="true" class="hash-link"><svg class="hash-link-icon" aria-hidden="true" height="16" version="1.1" viewBox="0 0 16 16" width="16"><path fill-rule="evenodd" d="M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z"></path></svg></a><code>check()</code></h3>
|
||
<pre><code class="hljs css language-jsx"><span class="token function">check</span><span class="token punctuation">(</span>permission<span class="token punctuation">)</span><span class="token punctuation">;</span>
|
||
</code></pre>
|
||
<p>Returns a promise resolving to a boolean value as to whether the specified permissions has been granted.</p>
|
||
<p><strong>Parameters:</strong></p>
|
||
<table>
|
||
<thead>
|
||
<tr><th>Name</th><th>Type</th><th>Required</th><th>Description</th></tr>
|
||
</thead>
|
||
<tbody>
|
||
<tr><td>permission</td><td>string</td><td>Yes</td><td>The permission to check for.</td></tr>
|
||
</tbody>
|
||
</table>
|
||
<hr>
|
||
<h3><a class="anchor" aria-hidden="true" id="request"></a><a href="#request" aria-hidden="true" class="hash-link"><svg class="hash-link-icon" aria-hidden="true" height="16" version="1.1" viewBox="0 0 16 16" width="16"><path fill-rule="evenodd" d="M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z"></path></svg></a><code>request()</code></h3>
|
||
<pre><code class="hljs css language-jsx"><span class="token function">request</span><span class="token punctuation">(</span>permission<span class="token punctuation">,</span> <span class="token punctuation">[</span>rationale<span class="token punctuation">]</span><span class="token punctuation">)</span><span class="token punctuation">;</span>
|
||
</code></pre>
|
||
<p>Prompts the user to enable a permission and returns a promise resolving to a string value (see result strings above) indicating whether the user allowed or denied the request or does not want to be asked again.</p>
|
||
<p>If <code>rationale</code> is provided, this function checks with the OS whether it is necessary to show a dialog explaining why the permission is needed (<a href="https://developer.android.com/training/permissions/requesting.html#explain">https://developer.android.com/training/permissions/requesting.html#explain</a>) and then shows the system permission dialog.</p>
|
||
<p><strong>Parameters:</strong></p>
|
||
<table>
|
||
<thead>
|
||
<tr><th>Name</th><th>Type</th><th>Required</th><th>Description</th></tr>
|
||
</thead>
|
||
<tbody>
|
||
<tr><td>permission</td><td>string</td><td>Yes</td><td>The permission to request.</td></tr>
|
||
<tr><td>rationale</td><td>object</td><td>No</td><td>Object with a <code>title</code> and <code>message</code>.</td></tr>
|
||
</tbody>
|
||
</table>
|
||
<hr>
|
||
<h3><a class="anchor" aria-hidden="true" id="requestmultiple"></a><a href="#requestmultiple" aria-hidden="true" class="hash-link"><svg class="hash-link-icon" aria-hidden="true" height="16" version="1.1" viewBox="0 0 16 16" width="16"><path fill-rule="evenodd" d="M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z"></path></svg></a><code>requestMultiple()</code></h3>
|
||
<pre><code class="hljs css language-jsx"><span class="token function">requestMultiple</span><span class="token punctuation">(</span>permissions<span class="token punctuation">)</span><span class="token punctuation">;</span>
|
||
</code></pre>
|
||
<p>Prompts the user to enable multiple permissions in the same dialog and returns an object with the permissions as keys and strings as values (see result strings above) indicating whether the user allowed or denied the request or does not want to be asked again.</p>
|
||
<p><strong>Parameters:</strong></p>
|
||
<table>
|
||
<thead>
|
||
<tr><th>Name</th><th>Type</th><th>Required</th><th>Description</th></tr>
|
||
</thead>
|
||
<tbody>
|
||
<tr><td>permissions</td><td>array</td><td>Yes</td><td>Array of permission to request.</td></tr>
|
||
</tbody>
|
||
</table>
|
||
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/0.56/panresponder"><span class="arrow-prev">← </span><span class="function-name-prevnext">PanResponder</span></a><a class="docs-next button" href="/docs/0.56/pixelratio"><span class="function-name-prevnext">PixelRatio</span><span class="arrow-next"> →</span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#methods-1">Methods</a><ul class="toc-headings"><li><a href="#constructor"><code>constructor()</code></a></li><li><a href="#check"><code>check()</code></a></li><li><a href="#request"><code>request()</code></a></li><li><a href="#requestmultiple"><code>requestMultiple()</code></a></li></ul></li></ul></nav></div><footer class="nav-footer" id="footer"><section class="sitemap"><div><h5>Docs</h5><a href="/docs/getting-started">Getting Started</a><a href="/docs/tutorial">Tutorial</a><a href="/docs/components-and-apis">Components and APIs</a><a href="/docs/more-resources">More Resources</a></div><div><h5>Community</h5><a href="/help">The React Native Community</a><a href="/showcase">Who's using React Native?</a><a href="https://stackoverflow.com/questions/tagged/react-native" target="_blank">Ask Questions on Stack Overflow</a><a href="https://github.com/facebook/react-native/blob/master/CONTRIBUTING.md">Contributor Guide</a><a href="https://dev.to/t/reactnative" target="_blank">DEV Community</a></div><div><h5>More Resources</h5><a href="/blog">Blog</a><a href="https://twitter.com/reactnative" target="_blank">Twitter</a><a href="https://github.com/facebook/react-native" target="_blank">GitHub</a><a href="https://reactjs.org" target="_blank">React</a></div></section><a href="https://code.facebook.com/projects/" target="_blank" class="fbOpenSource"><img src="/img/oss_logo.png" alt="Facebook Open Source" width="170" height="45"/></a><section class="copyright">Copyright © 2020 Facebook Inc.</section></footer></div><script type="text/javascript" src="https://cdn.jsdelivr.net/docsearch.js/1/docsearch.min.js"></script><script>window.fbAsyncInit = function() {FB.init({appId:'1677033832619985',xfbml:true,version:'v2.7'});};(function(d, s, id){var js, fjs = d.getElementsByTagName(s)[0];if (d.getElementById(id)) {return;}js = d.createElement(s); js.id = id;js.src = '//connect.facebook.net/en_US/sdk.js';fjs.parentNode.insertBefore(js, fjs);}(document, 'script','facebook-jssdk'));
|
||
</script><script>window.twttr=(function(d,s, id){var js,fjs=d.getElementsByTagName(s)[0],t=window.twttr||{};if(d.getElementById(id))return t;js=d.createElement(s);js.id=id;js.src='https://platform.twitter.com/widgets.js';fjs.parentNode.insertBefore(js, fjs);t._e = [];t.ready = function(f) {t._e.push(f);};return t;}(document, 'script', 'twitter-wjs'));</script><script>
|
||
document.addEventListener('keyup', function(e) {
|
||
if (e.target !== document.body) {
|
||
return;
|
||
}
|
||
// keyCode for '/' (slash)
|
||
if (e.keyCode === 191) {
|
||
const search = document.getElementById('search_input_react');
|
||
search && search.focus();
|
||
}
|
||
});
|
||
</script><script>
|
||
var search = docsearch({
|
||
|
||
apiKey: '2c98749b4a1e588efec53b2acec13025',
|
||
indexName: 'react-native-versions',
|
||
inputSelector: '#search_input_react',
|
||
algoliaOptions: {"facetFilters":["tags:0.56"],"hitsPerPage":5}
|
||
});
|
||
</script></body></html> |