feat: add vuplex webview for android (#3956)

Author: ImmutableJeffrey

src/Packages/Passport/Runtime/Scripts/Private/Immutable.Passport.Runtime.Private.asmdef

@@ -6,7 +6,8 @@
         "UniTask",
         "Immutable.Browser.Core",
         "Immutable.Browser.Gree",
-        "Immutable.Passport.Core.Logging"
+        "Immutable.Passport.Core.Logging",
+        "Vuplex.WebView"
     ],
     "includePlatforms": [
         "Android",

src/Packages/Passport/Runtime/Scripts/Private/UI/AndroidPassportWebView.cs

@@ -248,7 +248,7 @@ private void CreateWebViewObject()
             UnityEngine.Object.DontDestroyOnLoad(webViewGameObject);
 
             // Add WebViewObject component
-            webViewObject = webViewGameObject.AddComponent<WebViewObject>();
+            webViewObject = new WebViewObject();
 
             PassportLogger.Info($"{TAG} Gree WebViewObject created successfully");
         }

src/Packages/Passport/Runtime/Scripts/Private/UI/AndroidVuplexWebView.cs

@@ -0,0 +1,171 @@
+using System;
+using System.Collections.Generic;
+using Cysharp.Threading.Tasks;
+using UnityEngine;
+using UnityEngine.UI;
+using Immutable.Passport.Core.Logging;
+using Vuplex.WebView;
+
+namespace Immutable.Passport
+{
+    public class AndroidVuplexWebView : IPassportWebView
+    {
+        private const string TAG = "[AndroidWebView]";
+        private CanvasWebViewPrefab _webViewPrefab;
+        private readonly Dictionary<string, Action<string>> _jsHandlers = new Dictionary<string, Action<string>>();
+        private readonly RawImage _canvasReference;
+        private bool _isInitialized = false;
+
+        public event Action<string> OnJavaScriptMessage;
+        public event Action OnLoadFinished;
+        public event Action OnLoadStarted;
+
+        // Safe access - check initialization
+        public bool IsVisible => _webViewPrefab?.Visible ?? false;
+        public string CurrentUrl => _webViewPrefab?.WebView?.Url ?? "";
+
+        public AndroidVuplexWebView(RawImage canvasReference)
+        {
+            _canvasReference = canvasReference ?? throw new ArgumentNullException(nameof(canvasReference));
+        }
+
+        public void Initialize(PassportWebViewConfig config)
+        {
+            if (_isInitialized)
+            {
+                PassportLogger.Warn($"{TAG} Already initialized, skipping");
+                return;
+            }
+
+            try
+            {
+                PassportLogger.Info($"{TAG} Initializing Vuplex WebView...");
+
+                // Start async initialization but don't wait
+                InitializeAsync(config).Forget();
+            }
+            catch (Exception ex)
+            {
+                PassportLogger.Error($"{TAG} Failed to initialize: {ex.Message}");
+                throw;
+            }
+        }
+
+        private async UniTaskVoid InitializeAsync(PassportWebViewConfig config)
+        {
+            try
+            {
+                // Create WebView prefab and parent to Canvas
+                _webViewPrefab = CanvasWebViewPrefab.Instantiate();
+                _webViewPrefab.Native2DModeEnabled = true;
+
+                // Must be child of Canvas for Vuplex to work
+                _webViewPrefab.transform.SetParent(_canvasReference.canvas.transform, false);
+
+                // Set up full-screen layout for Native 2D Mode
+                var rect = _webViewPrefab.GetComponent<RectTransform>();
+                rect.anchorMin = Vector2.zero;
+                rect.anchorMax = Vector2.one;
+                rect.offsetMin = rect.offsetMax = Vector2.zero;
+
+                // Wait for WebView initialization
+                await _webViewPrefab.WaitUntilInitialized();
+
+                // Setup event handlers
+                _webViewPrefab.WebView.LoadProgressChanged += (s, e) =>
+                {
+                    if (e.Type == ProgressChangeType.Started)
+                    {
+                        OnLoadStarted?.Invoke();
+                    }
+                    else if (e.Type == ProgressChangeType.Finished)
+                    {
+                        OnLoadFinished?.Invoke();
+                    }
+                };
+                _webViewPrefab.WebView.MessageEmitted += (s, e) =>
+                {
+                    foreach (var h in _jsHandlers)
+                    {
+                        if (e.Value.StartsWith($"{h.Key}:"))
+                        {
+                            h.Value?.Invoke(e.Value.Substring(h.Key.Length + 1));
+                            return;
+                        }
+                    }
+
+                    OnJavaScriptMessage?.Invoke(e.Value);
+                };
+                _webViewPrefab.WebView.LoadFailed += (s, e) => PassportLogger.Warn($"{TAG} Load failed: {e.NativeErrorCode} for {e.Url}");
+
+                _isInitialized = true;
+                PassportLogger.Info($"{TAG} Vuplex WebView initialized successfully");
+            }
+            catch (Exception ex)
+            {
+                PassportLogger.Error($"{TAG} Failed to initialize async: {ex.Message}");
+                throw;
+            }
+        }
+
+        public void LoadUrl(string url)
+        {
+            if (!_isInitialized || _webViewPrefab?.WebView == null)
+            {
+                PassportLogger.Error($"{TAG} Cannot load URL - WebView not initialized");
+                return;
+            }
+
+            _webViewPrefab.WebView.LoadUrl(url);
+        }
+
+        public void Show()
+        {
+            if (_webViewPrefab != null)
+            {
+                _webViewPrefab.Visible = true;
+            }
+        }
+
+        public void Hide()
+        {
+            if (_webViewPrefab != null)
+            {
+                _webViewPrefab.Visible = false;
+            }
+        }
+
+        public void ExecuteJavaScript(string js)
+        {
+            if (!_isInitialized || _webViewPrefab?.WebView == null)
+            {
+                PassportLogger.Error($"{TAG} Cannot execute JavaScript - WebView not initialized");
+                return;
+            }
+
+            _webViewPrefab.WebView.ExecuteJavaScript(js);
+        }
+
+        public void RegisterJavaScriptMethod(string methodName, Action<string> handler)
+        {
+            _jsHandlers[methodName] = handler;
+
+            if (_isInitialized && _webViewPrefab?.WebView != null)
+            {
+                ExecuteJavaScript($"window.{methodName}=d=>window.vuplex?.postMessage('{methodName}:'+(typeof d==='object'?JSON.stringify(d):d))");
+            }
+        }
+
+        public void Dispose()
+        {
+            if (_webViewPrefab != null)
+            {
+                _webViewPrefab.Destroy();
+                _webViewPrefab = null;
+            }
+
+            _jsHandlers.Clear();
+            _isInitialized = false;
+        }
+    }
+}

src/Packages/Passport/Runtime/Scripts/Private/UI/AndroidVuplexWebView.cs.meta

@@ -202,7 +202,7 @@ private IPassportWebView CreatePlatformWebView()
             return new iOSPassportWebView(rawImage, this);
 #elif UNITY_ANDROID
             PassportLogger.Info($"{TAG} Creating Android WebView");
-            return new AndroidPassportWebView(rawImage, this);
+            return new AndroidVuplexWebView(rawImage);
 #elif UNITY_STANDALONE_OSX
             PassportLogger.Info($"{TAG} Creating macOS WebView (WKWebView)");
             // TODO: Implement macOS WebView