Updated documentation for macOS.

docs/Contributing.md

@@ -8,6 +8,44 @@ Secondly, we'd like the contribution experience to be as good as possible. While
 
 After you fork the repo, clone it to your machine, and make your changes, you'll want to test them in an app.
 
+There are two methods of testing:
+1) Testing within a clone of react-native-webview
+2) Testing in a new `react-native init` project
+
+### Testing within react-native-webview
+
+#### For all platforms:
+```
+$ yarn install
+```
+
+#### For Android:
+```
+$ yarn start:android
+```
+
+The Android example app will built, the Metro Bundler will launch, and the example app will be installed and started in the Android emulator.
+
+#### For iOS:
+```
+$ cd example/ios
+$ pod install
+$ cd ../..
+$ yarn start:ios
+```
+
+The iOS example app will be built, the Metro bundler will launch, and the example app will be install and started in the Simulator.
+
+#### for macOS:
+```
+$ open example/macos/example.xcodeproj
+$ yarn start:macos
+```
+
+The Metro Bundler will now be running in the Terminal for react-native-macos.  In XCode select the `example-macos` target and Run.
+
+### Testing in a new `react-native init` project
+
 In a new `react-native init` project, do this:
 
 ```

docs/Getting-Started.md

@@ -2,7 +2,7 @@
 
 Here's how to get started quickly with the React Native WebView.
 
-#### 1. Add react-native-webview to your dependencies
+## 1. Add react-native-webview to your dependencies
 
 ```
 $ yarn add react-native-webview
@@ -14,7 +14,7 @@ $ yarn add react-native-webview
 $ npm install --save react-native-webview
 ```
 
-#### 2. Link native dependencies
+## 2. Link native dependencies
 
 From react-native 0.60 autolinking will take care of the link step but don't forget to run `pod install`
 
@@ -24,13 +24,20 @@ React Native modules that include native Objective-C, Swift, Java, or Kotlin cod
 $ react-native link react-native-webview
 ```
 
-iOS:
+_NOTE: If you ever need to uninstall React Native WebView, run `react-native unlink react-native-webview` to unlink it._
+
+### iOS:
 
 If using cocoapods in the `ios/` directory run
 ```
 $ pod install
 ```
 
+For iOS, while you can manually link the old way using [react-native own tutorial](https://facebook.github.io/react-native/docs/linking-libraries-ios), we find it easier to use cocoapods.
+If you wish to use cocoapods and haven't set it up yet, please instead refer to [that article](https://engineering.brigad.co/demystifying-react-native-modules-linking-ae6c017a6b4a).
+
+### Android:
+
 Android - react-native-webview version <6:
 This module does not require any extra step after running the link command 🎉
 
@@ -44,12 +51,13 @@ android.enableJetifier=true
 
 For Android manual installation, please refer to [this article](https://engineering.brigad.co/demystifying-react-native-modules-linking-964399ec731b) where you can find detailed step on how to link any react-native project.
 
-For iOS, while you can manually link the old way using [react-native own tutorial](https://facebook.github.io/react-native/docs/linking-libraries-ios), we find it easier to use cocoapods.
-If you wish to use cocoapods and haven't set it up yet, please instead refer to [that article](https://engineering.brigad.co/demystifying-react-native-modules-linking-ae6c017a6b4a).
+### macOS:
 
-_NOTE: If you ever need to uninstall React Native WebView, run `react-native unlink react-native-webview` to unlink it._
+Cocoapod and autolinking is not yet support for react-native macOS but is coming soon.  In the meantime you must manually link.
+
+The method is nearly identical to the [manual linking method for iOS](https://facebook.github.io/react-native/docs/linking-libraries-ios#manual-linking) except that you will include the `node_modules/react-native-webview/macos/RNCWebView.xcodeproj` project in your main project and link the `RNCWebView-macOS.a` library. 
 
-#### 3. Import the webview into your component
+## 3. Import the webview into your component
 
 ```js
 import React, { Component } from 'react';

docs/Reference.md

@@ -474,9 +474,9 @@ Note that this method will not be invoked on hash URL changes (e.g. from `https:
 
 Function that is invoked when the `WebView` content process is terminated.
 
-| Type     | Required | Platform      |
-| -------- | -------- | ------------- |
-| function | No       | iOS WKWebView |
+| Type     | Required | Platform                |
+| -------- | -------- | ----------------------- |
+| function | No       | iOS and macOS WKWebView |
 
 Example:
 
@@ -863,9 +863,9 @@ Possible values for `dataDetectorTypes` are:
 
 Boolean value that determines whether scrolling is enabled in the `WebView`. The default value is `true`. Setting this to `false` will prevent the webview from moving the document body when the keyboard appears over an input.
 
-| Type | Required | Platform |
-| ---- | -------- | -------- |
-| bool | No       | iOS      |
+| Type | Required | Platform      |
+| ---- | -------- | ------------- |
+| bool | No       | iOS and macOS |
 
 ---
 
@@ -934,9 +934,9 @@ Boolean that sets whether JavaScript running in the context of a file scheme URL
 
 A String value that indicates which URLs the WebView's file can then reference in scripts, AJAX requests, and CSS imports. This is only used in for WebViews that are loaded with a source.uri set to a `'file://'` URL. If not provided, the default is to only allow read access to the URL provided in source.uri itself.
 
-| Type   | Required | Platform |
-| ------ | -------- | -------- |
-| string | No       | iOS      |
+| Type   | Required | Platform      |
+| ------ | -------- | ------------- |
+| string | No       | iOS and macOS |
 
 ---
 
@@ -984,9 +984,9 @@ If true, this will hide the keyboard accessory view (< > and Done).
 
 If true, this will be able horizontal swipe gestures. The default value is `false`.
 
-| Type    | Required | Platform |
-| ------- | -------- | -------- |
-| boolean | No       | iOS      |
+| Type    | Required | Platform          |
+| ------- | -------- | ----------------- |
+| boolean | No       | iOS and macOS     |
 
 ---
 
@@ -1061,9 +1061,9 @@ If the value of this property is true, the scroll view stops on multiples of the
 
 A Boolean value that determines whether pressing on a link displays a preview of the destination for the link. In iOS this property is available on devices that support 3D Touch. In iOS 10 and later, the default value is true; before that, the default value is false.
 
-| Type    | Required | Platform |
-| ------- | -------- | -------- |
-| boolean | No       | iOS      |
+| Type    | Required | Platform          |
+| ------- | -------- | ----------------- |
+| boolean | No       | iOS and macOS     |
 
 ---
 
@@ -1071,9 +1071,9 @@ A Boolean value that determines whether pressing on a link displays a preview of
 
 Set `true` if shared cookies from `[NSHTTPCookieStorage sharedHTTPCookieStorage]` should used for every load request in the WebView. The default value is `false`. For more on cookies, read the [Guide](Guide.md#Managing-Cookies)
 
-| Type    | Required | Platform |
-| ------- | -------- | -------- |
-| boolean | No       | iOS      |
+| Type    | Required | Platform          |
+| ------- | -------- | ----------------- |
+| boolean | No       | iOS and macOS     |
 
 ---
 

example/ios/Podfile.lock

@@ -182,7 +182,7 @@ PODS:
     - React-cxxreact (= 0.61.5)
     - React-jsi (= 0.61.5)
   - React-jsinspector (0.61.5)
-  - react-native-webview (8.0.4):
+  - react-native-webview (8.0.6):
     - React
   - React-RCTActionSheet (0.61.5):
     - React-Core/RCTActionSheetHeaders (= 0.61.5)
@@ -326,7 +326,7 @@ SPEC CHECKSUMS:
   React-jsi: cb2cd74d7ccf4cffb071a46833613edc79cdf8f7
   React-jsiexecutor: d5525f9ed5f782fdbacb64b9b01a43a9323d2386
   React-jsinspector: fa0ecc501688c3c4c34f28834a76302233e29dc0
-  react-native-webview: 3f5aa91c3cb083ea4762e006b9653291a96a777a
+  react-native-webview: 222d83c9c489e09b5d3541519110a637490ad4fa
   React-RCTActionSheet: 600b4d10e3aea0913b5a92256d2719c0cdd26d76
   React-RCTAnimation: 791a87558389c80908ed06cc5dfc5e7920dfa360
   React-RCTBlob: d89293cc0236d9cb0933d85e430b0bbe81ad1d72

ios/RNCWebView.m

@@ -548,28 +548,22 @@ static NSDictionary* customCertificatesForHost;
   }
 }
 
+#if !TARGET_OS_OSX
 - (void)setContentInset:(UIEdgeInsets)contentInset
 {
   _contentInset = contentInset;
   [RCTView autoAdjustInsetsForView:self
-#if !TARGET_OS_OSX
                     withScrollView:_webView.scrollView
-#else
-                    withScrollView:nil
-#endif // !TARGET_OS_OSX
                       updateOffset:NO];
 }
 
 - (void)refreshContentInset
 {
   [RCTView autoAdjustInsetsForView:self
-#if !TARGET_OS_OSX
                     withScrollView:_webView.scrollView
-#else
-                    withScrollView:nil
-#endif // !TARGET_OS_OSX
                       updateOffset:YES];
 }
+#endif // !TARGET_OS_OSX
 
 - (void)visitSource
 {
@@ -711,9 +705,7 @@ static NSDictionary* customCertificatesForHost;
 
     object_setClass(subview, newClass);
 }
-#endif // !TARGET_OS_OSX
 
-#if !TARGET_OS_OSX
 // UIScrollViewDelegate method
 - (void)scrollViewWillBeginDragging:(UIScrollView *)scrollView
 {
@@ -762,31 +754,25 @@ static NSDictionary* customCertificatesForHost;
     _onScroll(event);
   }
 }
-#endif // !TARGET_OS_OSX
 
 - (void)setDirectionalLockEnabled:(BOOL)directionalLockEnabled
 {
     _directionalLockEnabled = directionalLockEnabled;
-#if !TARGET_OS_OSX
     _webView.scrollView.directionalLockEnabled = directionalLockEnabled;
-#endif // !TARGET_OS_OSX
 }
 
 - (void)setShowsHorizontalScrollIndicator:(BOOL)showsHorizontalScrollIndicator
 {
     _showsHorizontalScrollIndicator = showsHorizontalScrollIndicator;
-#if !TARGET_OS_OSX
     _webView.scrollView.showsHorizontalScrollIndicator = showsHorizontalScrollIndicator;
-#endif // !TARGET_OS_OSX
 }
 
 - (void)setShowsVerticalScrollIndicator:(BOOL)showsVerticalScrollIndicator
 {
     _showsVerticalScrollIndicator = showsVerticalScrollIndicator;
-#if !TARGET_OS_OSX
     _webView.scrollView.showsVerticalScrollIndicator = showsVerticalScrollIndicator;
-#endif // !TARGET_OS_OSX
 }
+#endif // !TARGET_OS_OSX
 
 - (void)postMessage:(NSString *)message
 {