@exodus/react-native-webview 11.26.1-exodus.9 → 13.16.0-exodus.1

package/android/src/main/java/com/reactnativecommunity/webview/RNCWebViewMessagingModule.kt

@@ -0,0 +1,9 @@
+package com.reactnativecommunity.webview
+
+import com.facebook.react.bridge.JavaScriptModule
+import com.facebook.react.bridge.WritableMap
+
+internal interface RNCWebViewMessagingModule : JavaScriptModule {
+  fun onShouldStartLoadWithRequest(event: WritableMap)
+  fun onMessage(event: WritableMap)
+}

package/android/src/main/java/com/reactnativecommunity/webview/RNCWebViewModuleImpl.java

@@ -0,0 +1,554 @@
+package com.reactnativecommunity.webview;
+
+import android.Manifest;
+import android.app.Activity;
+import android.app.DownloadManager;
+import android.content.Context;
+import android.content.Intent;
+import android.content.pm.PackageManager;
+import android.net.Uri;
+import android.os.Build;
+import android.os.Environment;
+import android.os.Parcelable;
+import android.provider.MediaStore;
+
+import androidx.annotation.Nullable;
+import androidx.annotation.RequiresApi;
+import androidx.core.content.ContextCompat;
+import androidx.core.content.FileProvider;
+import androidx.core.util.Pair;
+
+import android.util.Log;
+import android.webkit.MimeTypeMap;
+import android.webkit.ValueCallback;
+import android.webkit.WebChromeClient;
+import android.widget.Toast;
+
+import com.facebook.common.activitylistener.ActivityListenerManager;
+import com.facebook.react.bridge.ActivityEventListener;
+import com.facebook.react.bridge.Promise;
+import com.facebook.react.bridge.ReactApplicationContext;
+import com.facebook.react.bridge.ReactContextBaseJavaModule;
+import com.facebook.react.bridge.ReactMethod;
+import com.facebook.react.module.annotations.ReactModule;
+import com.facebook.react.modules.core.PermissionAwareActivity;
+import com.facebook.react.modules.core.PermissionListener;
+
+import java.io.File;
+import java.io.IOException;
+import java.lang.SecurityException;
+import java.util.ArrayList;
+import java.util.Arrays;
+import java.util.HashMap;
+import java.util.concurrent.atomic.AtomicReference;
+
+import static android.app.Activity.RESULT_OK;
+
+public class RNCWebViewModuleImpl implements ActivityEventListener {
+    public static final String NAME = "RNCWebViewModule";
+
+    public static final int PICKER = 1;
+    public static final int PICKER_LEGACY = 3;
+    public static final int FILE_DOWNLOAD_PERMISSION_REQUEST = 1;
+
+    final private ReactApplicationContext mContext;
+
+    private DownloadManager.Request mDownloadRequest;
+
+    private ValueCallback<Uri> mFilePathCallbackLegacy;
+    private ValueCallback<Uri[]> mFilePathCallback;
+    private File mOutputImage;
+    private File mOutputVideo;
+
+    public RNCWebViewModuleImpl(ReactApplicationContext context) {
+        mContext = context;
+        context.addActivityEventListener(this);
+    }
+
+    @Override
+    public void onActivityResult(Activity activity, int requestCode, int resultCode, Intent data) {
+        if (mFilePathCallback == null && mFilePathCallbackLegacy == null) {
+            return;
+        }
+
+        boolean imageTaken = false;
+        boolean videoTaken = false;
+
+        if (mOutputImage != null && mOutputImage.length() > 0) {
+            imageTaken = true;
+        }
+        if (mOutputVideo != null && mOutputVideo.length() > 0) {
+            videoTaken = true;
+        }
+
+        // based off of which button was pressed, we get an activity result and a file
+        // the camera activity doesn't properly return the filename* (I think?) so we use
+        // this filename instead
+        switch (requestCode) {
+            case RNCWebViewModuleImpl.PICKER:
+                if (resultCode != RESULT_OK) {
+                    if (mFilePathCallback != null) {
+                        mFilePathCallback.onReceiveValue(null);
+                    }
+                } else {
+                    if (imageTaken) {
+                        mFilePathCallback.onReceiveValue(new Uri[]{getOutputUri(mOutputImage)});
+                    } else if (videoTaken) {
+                        mFilePathCallback.onReceiveValue(new Uri[]{getOutputUri(mOutputVideo)});
+                    } else {
+                        mFilePathCallback.onReceiveValue(getSelectedFiles(data, resultCode));
+                    }
+                }
+                break;
+            case RNCWebViewModuleImpl.PICKER_LEGACY:
+                if (resultCode != RESULT_OK) {
+                    mFilePathCallbackLegacy.onReceiveValue(null);
+                } else {
+                    if (imageTaken) {
+                        mFilePathCallbackLegacy.onReceiveValue(getOutputUri(mOutputImage));
+                    } else if (videoTaken) {
+                        mFilePathCallbackLegacy.onReceiveValue(getOutputUri(mOutputVideo));
+                    } else {
+                        mFilePathCallbackLegacy.onReceiveValue(data.getData());
+                    }
+                }
+                break;
+
+        }
+
+        if (mOutputImage != null && !imageTaken) {
+            mOutputImage.delete();
+        }
+        if (mOutputVideo != null && !videoTaken) {
+            mOutputVideo.delete();
+        }
+
+        mFilePathCallback = null;
+        mFilePathCallbackLegacy = null;
+        mOutputImage = null;
+        mOutputVideo = null;
+    }
+
+    @Override
+    public void onNewIntent(Intent intent) {
+
+    }
+
+    protected static class ShouldOverrideUrlLoadingLock {
+        protected enum ShouldOverrideCallbackState {
+            UNDECIDED,
+            SHOULD_OVERRIDE,
+            DO_NOT_OVERRIDE,
+        }
+
+        private double nextLockIdentifier = 1;
+        private final HashMap<Double, AtomicReference<ShouldOverrideCallbackState>> shouldOverrideLocks = new HashMap<>();
+
+        public synchronized Pair<Double, AtomicReference<ShouldOverrideCallbackState>> getNewLock() {
+            final double lockIdentifier = nextLockIdentifier++;
+            final AtomicReference<ShouldOverrideCallbackState> shouldOverride = new AtomicReference<>(ShouldOverrideCallbackState.UNDECIDED);
+            shouldOverrideLocks.put(lockIdentifier, shouldOverride);
+            return new Pair<>(lockIdentifier, shouldOverride);
+        }
+
+        @Nullable
+        public synchronized AtomicReference<ShouldOverrideCallbackState> getLock(Double lockIdentifier) {
+            return shouldOverrideLocks.get(lockIdentifier);
+        }
+
+        public synchronized void removeLock(Double lockIdentifier) {
+            shouldOverrideLocks.remove(lockIdentifier);
+        }
+    }
+
+    protected static final ShouldOverrideUrlLoadingLock shouldOverrideUrlLoadingLock = new ShouldOverrideUrlLoadingLock();
+
+    private enum MimeType {
+        DEFAULT("*/*"),
+        IMAGE("image"),
+        VIDEO("video");
+
+        private final String value;
+
+        MimeType(String value) {
+            this.value = value;
+        }
+    }
+
+    private PermissionListener getWebviewFileDownloaderPermissionListener(String downloadingMessage, String lackPermissionToDownloadMessage) {
+        return new PermissionListener() {
+            @Override
+            public boolean onRequestPermissionsResult(int requestCode, String[] permissions, int[] grantResults) {
+                switch (requestCode) {
+                    case FILE_DOWNLOAD_PERMISSION_REQUEST: {
+                        // If request is cancelled, the result arrays are empty.
+                        if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
+                            if (mDownloadRequest != null) {
+                                downloadFile(downloadingMessage);
+                            }
+                        } else {
+                            Toast.makeText(mContext, lackPermissionToDownloadMessage, Toast.LENGTH_LONG).show();
+                        }
+                        return true;
+                    }
+                }
+                return false;
+            }
+        };
+    }
+
+    public boolean isFileUploadSupported() {
+        return true;
+    }
+
+    public void shouldStartLoadWithLockIdentifier(boolean shouldStart, double lockIdentifier) {
+        final AtomicReference<ShouldOverrideUrlLoadingLock.ShouldOverrideCallbackState> lockObject = shouldOverrideUrlLoadingLock.getLock(lockIdentifier);
+        if (lockObject != null) {
+            synchronized (lockObject) {
+                lockObject.set(shouldStart ? ShouldOverrideUrlLoadingLock.ShouldOverrideCallbackState.DO_NOT_OVERRIDE : ShouldOverrideUrlLoadingLock.ShouldOverrideCallbackState.SHOULD_OVERRIDE);
+                lockObject.notify();
+            }
+        }
+    }
+
+    public Uri[] getSelectedFiles(Intent data, int resultCode) {
+        if (data == null) {
+            return null;
+        }
+
+        // we have multiple files selected
+        if (data.getClipData() != null) {
+            final int numSelectedFiles = data.getClipData().getItemCount();
+            Uri[] result = new Uri[numSelectedFiles];
+            for (int i = 0; i < numSelectedFiles; i++) {
+                result[i] = data.getClipData().getItemAt(i).getUri();
+            }
+            return result;
+        }
+
+        // we have one file selected
+        if (data.getData() != null && resultCode == RESULT_OK && Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {
+            return WebChromeClient.FileChooserParams.parseResult(resultCode, data);
+        }
+
+        return null;
+    }
+
+    public void startPhotoPickerIntent(String acceptType, ValueCallback<Uri> callback) {
+        mFilePathCallbackLegacy = callback;
+        Activity activity = mContext.getCurrentActivity();
+        Intent fileChooserIntent = getFileChooserIntent(acceptType);
+        Intent chooserIntent = Intent.createChooser(fileChooserIntent, "");
+
+        ArrayList<Parcelable> extraIntents = new ArrayList<>();
+        if (acceptsImages(acceptType)) {
+            Intent photoIntent = getPhotoIntent();
+            if (photoIntent != null) {
+                extraIntents.add(photoIntent);
+            }
+        }
+        if (acceptsVideo(acceptType)) {
+            Intent videoIntent = getVideoIntent();
+            if (videoIntent != null) {
+                extraIntents.add(videoIntent);
+            }
+        }
+        chooserIntent.putExtra(Intent.EXTRA_INITIAL_INTENTS, extraIntents.toArray(new Parcelable[]{}));
+
+        if (chooserIntent.resolveActivity(activity.getPackageManager()) != null) {
+            activity.startActivityForResult(chooserIntent, PICKER_LEGACY);
+        } else {
+            Log.w("RNCWebViewModule", "there is no Activity to handle this Intent");
+        }
+    }
+
+    public boolean startPhotoPickerIntent(final String[] acceptTypes, final boolean allowMultiple, final ValueCallback<Uri[]> callback, final boolean isCaptureEnabled) {
+        mFilePathCallback = callback;
+        Activity activity = mContext.getCurrentActivity();
+
+        ArrayList<Parcelable> extraIntents = new ArrayList<>();
+        Intent photoIntent = null;
+        if (!needsCameraPermission()) {
+            if (acceptsImages(acceptTypes)) {
+                photoIntent = getPhotoIntent();
+                if (photoIntent != null) {
+                    extraIntents.add(photoIntent);
+                }
+            }
+            if (acceptsVideo(acceptTypes)) {
+                Intent videoIntent = getVideoIntent();
+                if (videoIntent != null) {
+                    extraIntents.add(videoIntent);
+                }
+            }
+        }
+
+        Intent chooserIntent = new Intent(Intent.ACTION_CHOOSER);
+        if (isCaptureEnabled) {
+            chooserIntent = photoIntent;
+        } else {
+            Intent fileSelectionIntent = getFileChooserIntent(acceptTypes, allowMultiple);
+
+            chooserIntent.putExtra(Intent.EXTRA_INTENT, fileSelectionIntent);
+            chooserIntent.putExtra(Intent.EXTRA_INITIAL_INTENTS, extraIntents.toArray(new Parcelable[]{}));
+        }
+
+        if (chooserIntent != null) {
+            if (chooserIntent.resolveActivity(activity.getPackageManager()) != null) {
+                activity.startActivityForResult(chooserIntent, PICKER);
+            } else {
+                Log.w("RNCWebViewModule", "there is no Activity to handle this Intent");
+            }
+        } else {
+            Log.w("RNCWebViewModule", "there is no Camera permission");
+        }
+
+        return true;
+    }
+
+    public void setDownloadRequest(DownloadManager.Request request) {
+        mDownloadRequest = request;
+    }
+
+    public void downloadFile(String downloadingMessage) {
+        DownloadManager dm = (DownloadManager) mContext.getSystemService(Context.DOWNLOAD_SERVICE);
+
+        try {
+            dm.enqueue(mDownloadRequest);
+        } catch (IllegalArgumentException | SecurityException e) {
+            Log.w("RNCWebViewModule", "Unsupported URI, aborting download", e);
+            return;
+        }
+
+        Toast.makeText(mContext, downloadingMessage, Toast.LENGTH_LONG).show();
+    }
+
+    public boolean grantFileDownloaderPermissions(String downloadingMessage, String lackPermissionToDownloadMessage) {
+        Activity activity = mContext.getCurrentActivity();
+        // Permission not required for Android Q and above
+        if (Build.VERSION.SDK_INT > Build.VERSION_CODES.P) {
+            return true;
+        }
+
+        boolean result = ContextCompat.checkSelfPermission(activity, Manifest.permission.WRITE_EXTERNAL_STORAGE) == PackageManager.PERMISSION_GRANTED;
+        if (!result && Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
+            PermissionAwareActivity PAactivity = getPermissionAwareActivity();
+            PAactivity.requestPermissions(new String[]{Manifest.permission.WRITE_EXTERNAL_STORAGE}, FILE_DOWNLOAD_PERMISSION_REQUEST, getWebviewFileDownloaderPermissionListener(downloadingMessage, lackPermissionToDownloadMessage));
+        }
+
+        return result;
+    }
+
+    protected boolean needsCameraPermission() {
+        Activity activity = mContext.getCurrentActivity();
+        boolean needed = false;
+
+        PackageManager packageManager = activity.getPackageManager();
+        try {
+            String[] requestedPermissions = packageManager.getPackageInfo(activity.getApplicationContext().getPackageName(), PackageManager.GET_PERMISSIONS).requestedPermissions;
+            if (Arrays.asList(requestedPermissions).contains(Manifest.permission.CAMERA)
+                    && ContextCompat.checkSelfPermission(activity, Manifest.permission.CAMERA) != PackageManager.PERMISSION_GRANTED) {
+                needed = true;
+            }
+        } catch (PackageManager.NameNotFoundException e) {
+            needed = true;
+        }
+
+        return needed;
+    }
+
+    public Intent getPhotoIntent() {
+        Intent intent = null;
+
+        try {
+            mOutputImage = getCapturedFile(MimeType.IMAGE);
+            Uri outputImageUri = getOutputUri(mOutputImage);
+            intent = new Intent(MediaStore.ACTION_IMAGE_CAPTURE);
+            intent.putExtra(MediaStore.EXTRA_OUTPUT, outputImageUri);
+        } catch (IOException | IllegalArgumentException e) {
+            Log.e("CREATE FILE", "Error occurred while creating the File", e);
+            e.printStackTrace();
+        }
+
+        return intent;
+    }
+
+    public Intent getVideoIntent() {
+        Intent intent = null;
+
+        try {
+            mOutputVideo = getCapturedFile(MimeType.VIDEO);
+            Uri outputVideoUri = getOutputUri(mOutputVideo);
+            intent = new Intent(MediaStore.ACTION_VIDEO_CAPTURE);
+            intent.putExtra(MediaStore.EXTRA_OUTPUT, outputVideoUri);
+        } catch (IOException | IllegalArgumentException e) {
+            Log.e("CREATE FILE", "Error occurred while creating the File", e);
+            e.printStackTrace();
+        }
+
+        return intent;
+    }
+
+    private Intent getFileChooserIntent(String acceptTypes) {
+        String _acceptTypes = acceptTypes;
+        if (acceptTypes.isEmpty()) {
+            _acceptTypes = MimeType.DEFAULT.value;
+        }
+        if (acceptTypes.matches("\\.\\w+")) {
+            _acceptTypes = getMimeTypeFromExtension(acceptTypes.replace(".", ""));
+        }
+        Intent intent = new Intent(Intent.ACTION_GET_CONTENT);
+        intent.addCategory(Intent.CATEGORY_OPENABLE);
+        intent.setType(_acceptTypes);
+        return intent;
+    }
+
+    private Intent getFileChooserIntent(String[] acceptTypes, boolean allowMultiple) {
+        Intent intent = new Intent(Intent.ACTION_GET_CONTENT);
+        intent.addCategory(Intent.CATEGORY_OPENABLE);
+        intent.setType(MimeType.DEFAULT.value);
+        intent.putExtra(Intent.EXTRA_MIME_TYPES, getAcceptedMimeType(acceptTypes));
+        intent.putExtra(Intent.EXTRA_ALLOW_MULTIPLE, allowMultiple);
+        return intent;
+    }
+
+    private Boolean acceptsImages(String types) {
+        String mimeType = types;
+        if (types.matches("\\.\\w+")) {
+            mimeType = getMimeTypeFromExtension(types.replace(".", ""));
+        }
+        return mimeType.isEmpty() || mimeType.toLowerCase().contains(MimeType.IMAGE.value);
+    }
+
+    private Boolean acceptsImages(String[] types) {
+        String[] mimeTypes = getAcceptedMimeType(types);
+        return arrayContainsString(mimeTypes, MimeType.DEFAULT.value) || arrayContainsString(mimeTypes, MimeType.IMAGE.value);
+    }
+
+    private Boolean acceptsVideo(String types) {
+        if (Build.VERSION.SDK_INT < Build.VERSION_CODES.M) {
+            return false;
+        }
+
+        String mimeType = types;
+        if (types.matches("\\.\\w+")) {
+            mimeType = getMimeTypeFromExtension(types.replace(".", ""));
+        }
+        return mimeType.isEmpty() || mimeType.toLowerCase().contains(MimeType.VIDEO.value);
+    }
+
+    private Boolean acceptsVideo(String[] types) {
+        if (Build.VERSION.SDK_INT < Build.VERSION_CODES.M) {
+            return false;
+        }
+
+        String[] mimeTypes = getAcceptedMimeType(types);
+        return arrayContainsString(mimeTypes, MimeType.DEFAULT.value) || arrayContainsString(mimeTypes, MimeType.VIDEO.value);
+    }
+
+    private Boolean arrayContainsString(String[] array, String pattern) {
+        for (String content : array) {
+            if (content.contains(pattern)) {
+                return true;
+            }
+        }
+        return false;
+    }
+
+    private String[] getAcceptedMimeType(String[] types) {
+        if (noAcceptTypesSet(types)) {
+            return new String[]{MimeType.DEFAULT.value};
+        }
+        String[] mimeTypes = new String[types.length];
+        for (int i = 0; i < types.length; i++) {
+            String t = types[i];
+            // convert file extensions to mime types
+            if (t.matches("\\.\\w+")) {
+                String mimeType = getMimeTypeFromExtension(t.replace(".", ""));
+                if(mimeType != null) {
+                    mimeTypes[i] = mimeType;
+                } else {
+                    mimeTypes[i] = t;
+                }
+            } else {
+                mimeTypes[i] = t;
+            }
+        }
+        return mimeTypes;
+    }
+
+    private String getMimeTypeFromExtension(String extension) {
+        String type = null;
+        if (extension != null) {
+            type = MimeTypeMap.getSingleton().getMimeTypeFromExtension(extension);
+        }
+        return type;
+    }
+
+    public Uri getOutputUri(File capturedFile) {
+        // for versions below 6.0 (23) we use the old File creation & permissions model
+        if (Build.VERSION.SDK_INT < Build.VERSION_CODES.M) {
+            return Uri.fromFile(capturedFile);
+        }
+
+        // for versions 6.0+ (23) we use the FileProvider to avoid runtime permissions
+        String packageName = mContext.getPackageName();
+        return FileProvider.getUriForFile(mContext, packageName + ".fileprovider", capturedFile);
+    }
+
+    public File getCapturedFile(MimeType mimeType) throws IOException {
+        String prefix = "";
+        String suffix = "";
+        String dir = "";
+
+        switch (mimeType) {
+            case IMAGE:
+                prefix = "image-";
+                suffix = ".jpg";
+                dir = Environment.DIRECTORY_PICTURES;
+                break;
+            case VIDEO:
+                prefix = "video-";
+                suffix = ".mp4";
+                dir = Environment.DIRECTORY_MOVIES;
+                break;
+
+            default:
+                break;
+        }
+
+        String filename = prefix + String.valueOf(System.currentTimeMillis()) + suffix;
+        File outputFile = null;
+
+        // for versions below 6.0 (23) we use the old File creation & permissions model
+        if (Build.VERSION.SDK_INT < Build.VERSION_CODES.M) {
+            // only this Directory works on all tested Android versions
+            // ctx.getExternalFilesDir(dir) was failing on Android 5.0 (sdk 21)
+            File storageDir = Environment.getExternalStoragePublicDirectory(dir);
+            outputFile = new File(storageDir, filename);
+        } else {
+            File storageDir = mContext.getExternalFilesDir(null);
+            outputFile = File.createTempFile(prefix, suffix, storageDir);
+        }
+
+        return outputFile;
+    }
+
+    private Boolean noAcceptTypesSet(String[] types) {
+        // when our array returned from getAcceptTypes() has no values set from the webview
+        // i.e. <input type="file" />, without any "accept" attr
+        // will be an array with one empty string element, afaik
+
+        return types.length == 0 || (types.length == 1 && types[0] != null && types[0].length() == 0);
+    }
+
+    private PermissionAwareActivity getPermissionAwareActivity() {
+        Activity activity = mContext.getCurrentActivity();
+        if (activity == null) {
+            throw new IllegalStateException("Tried to use permissions API while not attached to an Activity.");
+        } else if (!(activity instanceof PermissionAwareActivity)) {
+            throw new IllegalStateException("Tried to use permissions API but the host Activity doesn't implement PermissionAwareActivity.");
+        }
+        return (PermissionAwareActivity) activity;
+    }
+}

package/android/src/main/java/com/reactnativecommunity/webview/RNCWebViewPackage.java

@@ -1,25 +1,70 @@
 package com.reactnativecommunity.webview;
 
-import java.util.Arrays;
-import java.util.Collections;
-import java.util.List;
+import androidx.annotation.Nullable;
 
-import com.facebook.react.ReactPackage;
+import com.facebook.react.TurboReactPackage;
 import com.facebook.react.bridge.NativeModule;
 import com.facebook.react.bridge.ReactApplicationContext;
+import com.facebook.react.module.model.ReactModuleInfo;
+import com.facebook.react.module.model.ReactModuleInfoProvider;
 import com.facebook.react.uimanager.ViewManager;
 
-public class RNCWebViewPackage implements ReactPackage {
+import java.util.ArrayList;
+import java.util.HashMap;
+import java.util.List;
+import java.util.Map;
+
+public class RNCWebViewPackage extends TurboReactPackage {
+
+    @Override
+    public List<ViewManager> createViewManagers(ReactApplicationContext reactContext) {
+        List<ViewManager> viewManagers = new ArrayList<>();
+        viewManagers.add(new RNCWebViewManager());
+        return viewManagers;
+    }
+
     @Override
-    public List<NativeModule> createNativeModules(ReactApplicationContext reactContext) {
-        return Arrays.<NativeModule>asList(
-          new RNCWebViewModule(reactContext),
-          new RNCWebViewUtils(reactContext)
-        );
+    public ReactModuleInfoProvider getReactModuleInfoProvider() {
+        return () -> {
+            final Map<String, ReactModuleInfo> moduleInfos = new HashMap<>();
+            boolean isTurboModule = BuildConfig.IS_NEW_ARCHITECTURE_ENABLED;
+            moduleInfos.put(
+                    RNCWebViewModuleImpl.NAME,
+                    new ReactModuleInfo(
+                            RNCWebViewModuleImpl.NAME,
+                            RNCWebViewModuleImpl.NAME,
+                            false, // canOverrideExistingModule
+                            false, // needsEagerInit
+                            true, // hasConstants
+                            false, // isCxxModule
+                            isTurboModule // isTurboModule
+                    ));
+            // Exodus custom module for getting default user agent
+            moduleInfos.put(
+                    RNCWebViewUtils.NAME,
+                    new ReactModuleInfo(
+                            RNCWebViewUtils.NAME,
+                            RNCWebViewUtils.NAME,
+                            false, // canOverrideExistingModule
+                            false, // needsEagerInit
+                            false, // hasConstants
+                            false, // isCxxModule
+                            false // isTurboModule - not a turbo module
+                    ));
+            return moduleInfos;
+        };
     }
 
+    @Nullable
     @Override
-    public List<ViewManager> createViewManagers(ReactApplicationContext reactContext) {
-        return Arrays.<ViewManager>asList(new RNCWebViewManager());
+    public NativeModule getModule(String name, ReactApplicationContext reactContext) {
+        if (name.equals(RNCWebViewModuleImpl.NAME)) {
+            return new RNCWebViewModule(reactContext);
+        } else if (name.equals(RNCWebViewUtils.NAME)) {
+            return new RNCWebViewUtils(reactContext);
+        } else {
+            return null;
+        }
     }
+
 }

package/android/src/main/java/com/reactnativecommunity/webview/RNCWebViewWrapper.kt

@@ -0,0 +1,39 @@
+package com.reactnativecommunity.webview
+
+import android.content.Context
+import android.graphics.Color
+import android.view.View
+import android.webkit.WebView
+import android.widget.FrameLayout
+
+/**
+ * A [FrameLayout] container to hold the [RNCWebView].
+ * We need this to prevent WebView crash when the WebView is out of viewport and
+ * [com.facebook.react.views.view.ReactViewGroup] clips the canvas.
+ * The WebView will then create an empty offscreen surface and NPE.
+ */
+class RNCWebViewWrapper(context: Context, webView: RNCWebView) : FrameLayout(context) {
+  init {
+    // We make the WebView as transparent on top of the container,
+    // and let React Native sets background color for the container.
+    webView.setBackgroundColor(Color.TRANSPARENT)
+    addView(webView)
+  }
+
+  val webView: RNCWebView = getChildAt(0) as RNCWebView
+
+  companion object {
+    /**
+     * A helper to get react tag id by given WebView
+     */
+    @JvmStatic
+    fun getReactTagFromWebView(webView: WebView): Int {
+      // It is expected that the webView is enclosed by [RNCWebViewWrapper] as the first child.
+      // Therefore, it must have a parent, and the parent ID is the reactTag.
+      // In exceptional cases, such as receiving WebView messaging after the view has been unmounted,
+      // the WebView will not have a parent.
+      // In this case, we simply return -1 to indicate that it was not found.
+      return (webView.parent as? View)?.id ?: -1
+    }
+  }
+}