| 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 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 main branch](https://github.com/expo/expo/blob/main/docs/pages/versions/unversioned/sdk/webbrowser.md)
|
| 8 | - [Documentation for the latest stable release](https://docs.expo.dev/versions/latest/sdk/webbrowser/)
|
| 9 |
|
| 10 | # Installation in managed Expo projects
|
| 11 |
|
| 12 | For [managed](https://docs.expo.dev/versions/latest/introduction/managed-vs-bare/) Expo projects, please follow the installation instructions in the [API documentation for the latest stable release](https://docs.expo.dev/versions/latest/sdk/webbrowser/).
|
| 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 `expo` package](https://docs.expo.dev/bare/installing-expo-modules/) 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 `npx pod-install` 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).
|