| 1 | # expo-web-browser
|
| 2 |
|
| 3 | Provides access to the system's web browser and supports handling redirects. On iOS, it uses SFSafariViewController or SFAuthenticationSession, depending on the method you call, and on Android it uses ChromeCustomTabs. As of iOS 11, SFSafariViewController no longer shares cookies with the Safari, so if you are using WebBrowser for authentication you will want to use WebBrowser.openAuthSessionAsync, and if you just want to open a webpage (such as your app privacy policy), then use WebBrowser.openBrowserAsync.
|
| 4 |
|
| 5 | # API documentation
|
| 6 |
|
| 7 | - [Documentation for the master branch](https://github.com/expo/expo/blob/master/docs/pages/versions/unversioned/sdk/webbrowser.md)
|
| 8 | - [Documentation for the latest stable release](https://docs.expo.io/versions/latest/sdk/webbrowser/)
|
| 9 |
|
| 10 | # Installation in managed Expo projects
|
| 11 |
|
| 12 | For managed [managed](https://docs.expo.io/versions/latest/introduction/managed-vs-bare/) Expo projects, please follow the installation instructions in the [API documentation for the latest stable release](#api-documentation). If you follow the link and there is no documentation available then this library is not yet usable within managed projects — it is likely to be included in an upcoming Expo SDK release.
|
| 13 |
|
| 14 | # Installation in bare React Native projects
|
| 15 |
|
| 16 | For bare React Native projects, you must ensure that you have [installed and configured the `react-native-unimodules` package](https://github.com/unimodules/react-native-unimodules) before continuing.
|
| 17 |
|
| 18 | ### Add the package to your npm dependencies
|
| 19 |
|
| 20 | ```
|
| 21 | expo install expo-web-browser
|
| 22 | ```
|
| 23 |
|
| 24 | ### Configure for iOS
|
| 25 |
|
| 26 | Run `pod install` in the ios directory after installing the npm package.
|
| 27 |
|
| 28 | ### Configure for Android
|
| 29 |
|
| 30 | No additional set up necessary.
|
| 31 |
|
| 32 | # Contributing
|
| 33 |
|
| 34 | Contributions are very welcome! Please refer to guidelines described in the [contributing guide]( https://github.com/expo/expo#contributing).
|