| 
				
			 | 
			
			
				@@ -3,9 +3,11 @@ 
			 | 
		
	
		
			
			| 
				3
			 | 
			
				3
			 | 
			
			
				  
			 | 
		
	
		
			
			| 
				4
			 | 
			
				4
			 | 
			
			
				 **React Native WebView** is a modern, well-supported, and cross-platform WebView for React Native. It is intended to be a replacement for the built-in WebView (which will be [removed from core](https://github.com/react-native-community/discussions-and-proposals/pull/3)). 
			 | 
		
	
		
			
			| 
				5
			 | 
			
				5
			 | 
			
			
				  
			 | 
		
	
		
			
			| 
				6
			 | 
			
				
			 | 
			
			
				-> We just swapped out the React Native WebView in our app with the version from React Native Community. The swap took less than a day, required almost no code modifications, and is faster and CSS works better. Props to everyone in the community (including those at Infinite Red) that helped get that component split out. 
			 | 
		
	
		
			
			| 
				
			 | 
			
				6
			 | 
			
			
				+## Core Maintainers - Sponsoring companies 
			 | 
		
	
		
			
			| 
				
			 | 
			
				7
			 | 
			
			
				+_This project is maintained for free by these people using both their free time and their company work time._ 
			 | 
		
	
		
			
			| 
				7
			 | 
			
				8
			 | 
			
			
				  
			 | 
		
	
		
			
			| 
				8
			 | 
			
				
			 | 
			
			
				-_Garrett McCullough, mobile engineer at Virta Health_ 
			 | 
		
	
		
			
			| 
				
			 | 
			
				9
			 | 
			
			
				+- [Thibault Malbranche](https://github.com/Titozzz) ([Twitter @titozzz](https://twitter.com/titozzz)) from [Brigad](https://brigad.co/about) 
			 | 
		
	
		
			
			| 
				
			 | 
			
				10
			 | 
			
			
				+- [Jamon Holmgren](https://github.com/jamonholmgren) ([Twitter @jamonholmgren](https://twitter.com/jamonholmgren)) from [Infinite Red](https://infinite.red/react-native) 
			 | 
		
	
		
			
			| 
				9
			 | 
			
				11
			 | 
			
			
				  
			 | 
		
	
		
			
			| 
				10
			 | 
			
				12
			 | 
			
			
				 ## Platforms Supported 
			 | 
		
	
		
			
			| 
				11
			 | 
			
				13
			 | 
			
			
				  
			 | 
		
	
	
		
			
			| 
				
			 | 
			
			
				@@ -14,18 +16,28 @@ _Garrett McCullough, mobile engineer at Virta Health_ 
			 | 
		
	
		
			
			| 
				14
			 | 
			
				16
			 | 
			
			
				  
			 | 
		
	
		
			
			| 
				15
			 | 
			
				17
			 | 
			
			
				 _Note: React Native WebView is not currently supported by Expo unless you "eject"._ 
			 | 
		
	
		
			
			| 
				16
			 | 
			
				18
			 | 
			
			
				  
			 | 
		
	
		
			
			| 
				
			 | 
			
				19
			 | 
			
			
				+## Getting Started 
			 | 
		
	
		
			
			| 
				
			 | 
			
				20
			 | 
			
			
				+ 
			 | 
		
	
		
			
			| 
				
			 | 
			
				21
			 | 
			
			
				+Read our [Getting Started Guide]. If any step seems unclear, please create a detailed issue. 
			 | 
		
	
		
			
			| 
				
			 | 
			
				22
			 | 
			
			
				+ 
			 | 
		
	
		
			
			| 
				17
			 | 
			
				23
			 | 
			
			
				 ## Versioning 
			 | 
		
	
		
			
			| 
				18
			 | 
			
				24
			 | 
			
			
				  
			 | 
		
	
		
			
			| 
				19
			 | 
			
				
			 | 
			
			
				-If you need the exact same WebView as the one from react-native, please use version **2.0.0**. Future versions will follow [semantic versioning](https://semver.org/). 
			 | 
		
	
		
			
			| 
				
			 | 
			
				25
			 | 
			
			
				+This project follows [semantic versioning](https://semver.org/). We do not hesitate to release breaking changes but they will be in a major version. 
			 | 
		
	
		
			
			| 
				20
			 | 
			
				26
			 | 
			
			
				  
			 | 
		
	
		
			
			| 
				21
			 | 
			
				
			 | 
			
			
				-## Getting Started 
			 | 
		
	
		
			
			| 
				
			 | 
			
				27
			 | 
			
			
				+**Breaking History:** 
			 | 
		
	
		
			
			| 
				22
			 | 
			
				28
			 | 
			
			
				  
			 | 
		
	
		
			
			| 
				23
			 | 
			
				
			 | 
			
			
				-``` 
			 | 
		
	
		
			
			| 
				24
			 | 
			
				
			 | 
			
			
				-$ yarn add react-native-webview 
			 | 
		
	
		
			
			| 
				25
			 | 
			
				
			 | 
			
			
				-$ react-native link react-native-webview 
			 | 
		
	
		
			
			| 
				26
			 | 
			
				
			 | 
			
			
				-``` 
			 | 
		
	
		
			
			| 
				
			 | 
			
				29
			 | 
			
			
				+- [2.0.0](https://github.com/react-native-community/react-native-webview/releases/tag/v2.0.0) - First release this is a replica of the core webview component 
			 | 
		
	
		
			
			| 
				
			 | 
			
				30
			 | 
			
			
				+- [3.0.0](https://github.com/react-native-community/react-native-webview/releases/tag/v3.0.0) - WKWebview: Add shared process pool so cookies and localStorage are shared across webviews in iOS (enabled by default). 
			 | 
		
	
		
			
			| 
				
			 | 
			
				31
			 | 
			
			
				+- [4.0.0](https://github.com/react-native-community/react-native-webview/releases/tag/v4.0.0) - Added cache (enabled by default). 
			 | 
		
	
		
			
			| 
				
			 | 
			
				32
			 | 
			
			
				+- [5.0.**1**](https://github.com/react-native-community/react-native-webview/releases/tag/v5.0.0) - Refactored the old postMessage implementation for communication from webview to native. 
			 | 
		
	
		
			
			| 
				27
			 | 
			
				33
			 | 
			
			
				  
			 | 
		
	
		
			
			| 
				28
			 | 
			
				
			 | 
			
			
				-Read our [Getting Started Guide](./docs/Getting-Started.md) for more. 
			 | 
		
	
		
			
			| 
				
			 | 
			
				34
			 | 
			
			
				+**Upcoming:** 
			 | 
		
	
		
			
			| 
				
			 | 
			
				35
			 | 
			
			
				+ 
			 | 
		
	
		
			
			| 
				
			 | 
			
				36
			 | 
			
			
				+- UIWebView removal 
			 | 
		
	
		
			
			| 
				
			 | 
			
				37
			 | 
			
			
				+- this.webView.postMessage() removal (never documented and less flexible than injectJavascript) 
			 | 
		
	
		
			
			| 
				
			 | 
			
				38
			 | 
			
			
				+- Typescript rewrite 
			 | 
		
	
		
			
			| 
				
			 | 
			
				39
			 | 
			
			
				+- Kotlin rewrite 
			 | 
		
	
		
			
			| 
				
			 | 
			
				40
			 | 
			
			
				+- Maybe Swift rewrite 
			 | 
		
	
		
			
			| 
				29
			 | 
			
				41
			 | 
			
			
				  
			 | 
		
	
		
			
			| 
				30
			 | 
			
				42
			 | 
			
			
				 ## Usage 
			 | 
		
	
		
			
			| 
				31
			 | 
			
				43
			 | 
			
			
				  
			 | 
		
	
	
		
			
			| 
				
			 | 
			
			
				@@ -41,8 +53,7 @@ class MyWebComponent extends Component { 
			 | 
		
	
		
			
			| 
				41
			 | 
			
				53
			 | 
			
			
				   render() { 
			 | 
		
	
		
			
			| 
				42
			 | 
			
				54
			 | 
			
			
				     return ( 
			 | 
		
	
		
			
			| 
				43
			 | 
			
				55
			 | 
			
			
				       <WebView 
			 | 
		
	
		
			
			| 
				44
			 | 
			
				
			 | 
			
			
				-        source={{ uri: "https://infinite.red/react-native" }} 
			 | 
		
	
		
			
			| 
				45
			 | 
			
				
			 | 
			
			
				-        style={{ marginTop: 20 }} 
			 | 
		
	
		
			
			| 
				
			 | 
			
				56
			 | 
			
			
				+        source={{ uri: "https://facebook.github.io/react-native/" }} 
			 | 
		
	
		
			
			| 
				46
			 | 
			
				57
			 | 
			
			
				       /> 
			 | 
		
	
		
			
			| 
				47
			 | 
			
				58
			 | 
			
			
				     ); 
			 | 
		
	
		
			
			| 
				48
			 | 
			
				59
			 | 
			
			
				   } 
			 | 
		
	
	
		
			
			| 
				
			 | 
			
			
				@@ -51,11 +62,7 @@ class MyWebComponent extends Component { 
			 | 
		
	
		
			
			| 
				51
			 | 
			
				62
			 | 
			
			
				  
			 | 
		
	
		
			
			| 
				52
			 | 
			
				63
			 | 
			
			
				 For more, read the [API Reference](./docs/Reference.md) and [Guide](./docs/Guide.md). If you're interested in contributing, check out the [Contributing Guide](./docs/Contributing.md). 
			 | 
		
	
		
			
			| 
				53
			 | 
			
				64
			 | 
			
			
				  
			 | 
		
	
		
			
			| 
				54
			 | 
			
				
			 | 
			
			
				-## Migrate from React Native core WebView to React Native WebView 
			 | 
		
	
		
			
			| 
				55
			 | 
			
				
			 | 
			
			
				- 
			 | 
		
	
		
			
			| 
				56
			 | 
			
				
			 | 
			
			
				-Simply install React Native WebView and then use it in place of the core WebView. Their APIs are currently identical, except that this package defaults `useWebKit={true}` unlike the built-in WebView. 
			 | 
		
	
		
			
			| 
				57
			 | 
			
				
			 | 
			
			
				- 
			 | 
		
	
		
			
			| 
				58
			 | 
			
				
			 | 
			
			
				-## Troubleshooting 
			 | 
		
	
		
			
			| 
				
			 | 
			
				65
			 | 
			
			
				+## Common issues 
			 | 
		
	
		
			
			| 
				59
			 | 
			
				66
			 | 
			
			
				  
			 | 
		
	
		
			
			| 
				60
			 | 
			
				67
			 | 
			
			
				 - If you're getting `Invariant Violation: Native component for "RNCWKWebView does not exist"` it likely means you forgot to run `react-native link` or there was some error with the linking process 
			 | 
		
	
		
			
			| 
				61
			 | 
			
				68
			 | 
			
			
				 - There's a [problem](https://stackoverflow.com/questions/52872045/rendering-webview-on-android-device-overlaps-previous-siblings-from-same-parent) on some Android devices where the webview could overlap previous siblings from same parent. To fix this, wrap the WebView in a View with style `overflow: hidden`. 
			 | 
		
	
	
		
			
			| 
				
			 | 
			
			
				@@ -64,12 +71,6 @@ Simply install React Native WebView and then use it in place of the core WebView 
			 | 
		
	
		
			
			| 
				64
			 | 
			
				71
			 | 
			
			
				  
			 | 
		
	
		
			
			| 
				65
			 | 
			
				72
			 | 
			
			
				 See [Contributing.md](https://github.com/react-native-community/react-native-webview/blob/master/docs/Contributing.md) 
			 | 
		
	
		
			
			| 
				66
			 | 
			
				73
			 | 
			
			
				  
			 | 
		
	
		
			
			| 
				67
			 | 
			
				
			 | 
			
			
				-## Maintainers 
			 | 
		
	
		
			
			| 
				68
			 | 
			
				
			 | 
			
			
				- 
			 | 
		
	
		
			
			| 
				69
			 | 
			
				
			 | 
			
			
				-- [Jamon Holmgren](https://github.com/jamonholmgren) ([Twitter @jamonholmgren](https://twitter.com/jamonholmgren)) from [Infinite Red](https://infinite.red/react-native) 
			 | 
		
	
		
			
			| 
				70
			 | 
			
				
			 | 
			
			
				-- [Thibault Malbranche](https://github.com/Titozzz) ([Twitter @titozzz](https://twitter.com/titozzz)) from [Brigad](https://brigad.co/about) 
			 | 
		
	
		
			
			| 
				71
			 | 
			
				
			 | 
			
			
				-- [Empyrical](https://github.com/empyrical) ([Twitter @empyrical](https://twitter.com/empyrical)) 
			 | 
		
	
		
			
			| 
				72
			 | 
			
				
			 | 
			
			
				- 
			 | 
		
	
		
			
			| 
				73
			 | 
			
				74
			 | 
			
			
				 ## Contributors 
			 | 
		
	
		
			
			| 
				74
			 | 
			
				75
			 | 
			
			
				  
			 | 
		
	
		
			
			| 
				75
			 | 
			
				76
			 | 
			
			
				 Thanks goes to these wonderful people ([emoji key](https://github.com/all-contributors/all-contributors#emoji-key-)): 
			 |