react-native-webview-bootpay 13.13.47 → 13.13.49

package/README.md

@@ -80,3 +80,40 @@ This readme is available in:
 - [Brazilian portuguese](docs/README.portuguese.md)
 - [French](docs/README.french.md)
 - [Italian](docs/README.italian.md)
+
+---
+
+## Bootpay WebView 프리워밍 (iOS)
+
+iOS의 WKWebView는 첫 로딩 시 GPU, Networking, WebContent 프로세스 초기화로 4-6초 지연이 발생할 수 있습니다.
+
+**Bootpay React Native WebView는 모듈 로드 시 자동으로 프리워밍이 시작됩니다.** 별도의 설정 없이도 첫 결제 화면 로딩 속도가 개선됩니다.
+
+### 수동 호출 (선택사항)
+
+특별한 타이밍에 프리워밍을 시작하고 싶다면 수동으로 호출할 수 있습니다:
+
+```javascript
+import { NativeModules } from 'react-native';
+
+const { BPCWebViewModule } = NativeModules;
+
+// 기본 호출 (0.1초 딜레이)
+BPCWebViewModule.warmUp();
+
+// 커스텀 딜레이로 호출 (UI 버벅임 시)
+BPCWebViewModule.warmUpWithDelay(0.5);
+
+// 메모리 부족 시 리소스 해제
+BPCWebViewModule.releaseWarmUp();
+```
+
+### API
+
+| 메서드 | 설명 |
+|--------|------|
+| `warmUp()` | WebView 프로세스 미리 초기화 (자동 실행됨) |
+| `warmUpWithDelay(delay)` | 커스텀 딜레이(초)로 프리워밍 |
+| `releaseWarmUp()` | 프리워밍 리소스 해제 |
+
+> **참고**: Android에서는 이 기능이 no-op으로 동작합니다 (iOS 전용).

package/android/src/main/java/kr/co/bootpay/webview/BPCWebView.java

@@ -302,9 +302,17 @@ public class BPCWebView extends WebView implements LifecycleEventListener {
 
     private void injectJavascriptObject() {
       if (getSettings().getJavaScriptEnabled()) {
+        // iOS와 동일하게 postMessage 함수를 명시적으로 정의
+        // WebViewCompat.addWebMessageListener가 주입한 원본 postMessage를 보존하면서
+        // injectedObjectJson 등 추가 기능 제공
         String js = "(function(){\n" +
+          "    var existing = window." + JAVASCRIPT_INTERFACE + ";\n" +
+          "    var originalPostMessage = existing ? existing.postMessage : null;\n" +
           "    window." + JAVASCRIPT_INTERFACE + " = window." + JAVASCRIPT_INTERFACE + " || {};\n" +
           "    window." + JAVASCRIPT_INTERFACE + ".injectedObjectJson = function () { return " + (injectedJavaScriptObject == null ? null : ("`" + injectedJavaScriptObject + "`")) + "; };\n" +
+          "    if (originalPostMessage) {\n" +
+          "        window." + JAVASCRIPT_INTERFACE + ".postMessage = originalPostMessage;\n" +
+          "    }\n" +
           "})();";
         evaluateJavascriptWithFallback(js);
       }
@@ -471,9 +479,15 @@ public class BPCWebView extends WebView implements LifecycleEventListener {
          * - window[JAVASCRIPT_INTERFACE].postMessage
          */
         @JavascriptInterface
-        public void postMessage(String message) {
+        public void postMessage(final String message) {
             if (mWebView.getMessagingEnabled()) {
-                mWebView.onMessage(message, mWebView.getUrl());
+                // WebView methods must be called on the main (UI) thread
+                mWebView.post(new Runnable() {
+                    @Override
+                    public void run() {
+                        mWebView.onMessage(message, mWebView.getUrl());
+                    }
+                });
             } else {
                 FLog.w(TAG, "ReactNativeWebView.postMessage method was called but messaging is disabled. Pass an onMessage handler to the WebView.");
             }

package/android/src/main/java/kr/co/bootpay/webview/BPCWebViewModuleImpl.java

@@ -34,6 +34,11 @@ import com.facebook.react.module.annotations.ReactModule;
 import com.facebook.react.modules.core.PermissionAwareActivity;
 import com.facebook.react.modules.core.PermissionListener;
 
+import android.webkit.CookieManager;
+import android.webkit.WebView;
+import android.os.Handler;
+import android.os.Looper;
+
 import java.io.File;
 import java.io.IOException;
 import java.lang.SecurityException;
@@ -51,6 +56,10 @@ public class BPCWebViewModuleImpl implements ActivityEventListener {
     public static final int PICKER_LEGACY = 3;
     public static final int FILE_DOWNLOAD_PERMISSION_REQUEST = 1;
 
+    // WarmUp을 위한 프리워밍된 WebView
+    private static WebView sPrewarmedWebView;
+    private static boolean sIsWarmedUp = false;
+
     final private ReactApplicationContext mContext;
 
     private DownloadManager.Request mDownloadRequest;
@@ -65,6 +74,51 @@ public class BPCWebViewModuleImpl implements ActivityEventListener {
         context.addActivityEventListener(this);
     }
 
+    /**
+     * WebView 프로세스를 미리 초기화하여 첫 결제 화면 로딩 속도를 개선합니다.
+     * Application의 onCreate 또는 적절한 시점에 호출하세요.
+     *
+     * Chromium 엔진 초기화에 200-300ms가 소요되므로, 이 메서드를 미리 호출하면
+     * 실제 결제 시 즉시 WebView가 표시됩니다.
+     */
+    public void warmUp() {
+        if (sIsWarmedUp) {
+            return;
+        }
+
+        new Handler(Looper.getMainLooper()).post(() -> {
+            try {
+                // CookieManager 초기화로 Chromium 엔진 로드 (thread-safe)
+                CookieManager.getInstance();
+
+                // 프리워밍용 WebView 생성
+                if (sPrewarmedWebView == null && mContext != null) {
+                    sPrewarmedWebView = new WebView(mContext);
+                    // 빈 HTML을 로드하여 WebContent 프로세스 초기화
+                    sPrewarmedWebView.loadDataWithBaseURL(null, "", "text/html", "UTF-8", null);
+                }
+
+                sIsWarmedUp = true;
+            } catch (Exception e) {
+                Log.w("BPCWebViewModule", "Failed to warm up WebView", e);
+            }
+        });
+    }
+
+    /**
+     * 프리워밍된 WebView 리소스를 해제합니다.
+     * 메모리가 부족할 때 호출할 수 있습니다.
+     */
+    public void releaseWarmUp() {
+        new Handler(Looper.getMainLooper()).post(() -> {
+            if (sPrewarmedWebView != null) {
+                sPrewarmedWebView.destroy();
+                sPrewarmedWebView = null;
+            }
+            sIsWarmedUp = false;
+        });
+    }
+
     @Override
     public void onActivityResult(Activity activity, int requestCode, int resultCode, Intent data) {
         if (mFilePathCallback == null && mFilePathCallbackLegacy == null) {

package/android/src/newarch/kr/co/bootpay/webview/BPCWebViewModule.java

@@ -29,6 +29,16 @@ public class BPCWebViewModule extends NativeBPCWebViewModuleSpec {
         mBPCWebViewModuleImpl.shouldStartLoadWithLockIdentifier(shouldStart, lockIdentifier);
     }
 
+    @Override
+    public void warmUp() {
+        mBPCWebViewModuleImpl.warmUp();
+    }
+
+    @Override
+    public void releaseWarmUp() {
+        mBPCWebViewModuleImpl.releaseWarmUp();
+    }
+
     public void startPhotoPickerIntent(ValueCallback<Uri> filePathCallback, String acceptType) {
         mBPCWebViewModuleImpl.startPhotoPickerIntent(acceptType, filePathCallback);
     }

package/android/src/oldarch/kr/co/bootpay/webview/BPCWebViewModule.java

@@ -31,6 +31,16 @@ public class BPCWebViewModule extends ReactContextBaseJavaModule {
         mBPCWebViewModuleImpl.shouldStartLoadWithLockIdentifier(shouldStart, lockIdentifier);
     }
 
+    @ReactMethod
+    public void warmUp() {
+        mBPCWebViewModuleImpl.warmUp();
+    }
+
+    @ReactMethod
+    public void releaseWarmUp() {
+        mBPCWebViewModuleImpl.releaseWarmUp();
+    }
+
     public void startPhotoPickerIntent(ValueCallback<Uri> filePathCallback, String acceptType) {
         mBPCWebViewModuleImpl.startPhotoPickerIntent(acceptType, filePathCallback);
     }

package/apple/BPCWKProcessPoolManager.h

@@ -12,4 +12,17 @@
 + (instancetype) sharedManager;
 - (WKProcessPool *)sharedProcessPool;
 
+/// WebView 프로세스를 미리 초기화하여 첫 결제 화면 로딩 속도를 개선합니다.
+/// @param delay 프리워밍 시작 전 대기 시간 (초). 기본값 0.1초. UI가 느려지면 0.5~1.0으로 늘려보세요.
+- (void)warmUpWithDelay:(NSTimeInterval)delay;
+
+/// 기본 딜레이(0.1초)로 프리워밍을 시작합니다.
+- (void)warmUp;
+
+/// 프리워밍된 WebView 리소스를 해제합니다.
+- (void)releaseWarmUp;
+
+/// 프리워밍 완료 여부를 확인합니다.
+@property (nonatomic, readonly) BOOL isWarmedUp;
+
 @end

package/apple/BPCWKProcessPoolManager.m

@@ -10,9 +10,14 @@
 
 @interface BPCWKProcessPoolManager() {
   WKProcessPool *_sharedProcessPool;
+  WKWebView *_prewarmedWebView;
+  BOOL _isWarmUpComplete;
 }
 @end
 
+/// 프리워밍용 최소 HTML (GPU/WebContent/Networking 프로세스 초기화 트리거)
+static NSString *const kWarmUpHTML = @"<!DOCTYPE html><html><head><meta charset=\"utf-8\"><meta name=\"viewport\" content=\"width=device-width,initial-scale=1\"></head><body><canvas id=\"c\" width=\"1\" height=\"1\"></canvas><script>var c=document.getElementById('c').getContext('2d');c.fillRect(0,0,1,1);fetch('https://webview.bootpay.co.kr/health',{mode:'no-cors'}).catch(function(){});</script></body></html>";
+
 @implementation BPCWKProcessPoolManager
 
 + (id) sharedManager {
@@ -32,5 +37,43 @@
   return _sharedProcessPool;
 }
 
+- (void)warmUp {
+  [self warmUpWithDelay:0.1];
+}
+
+- (void)warmUpWithDelay:(NSTimeInterval)delay {
+  if (_prewarmedWebView != nil) return;
+
+  dispatch_after(dispatch_time(DISPATCH_TIME_NOW, (int64_t)(delay * NSEC_PER_SEC)), dispatch_get_main_queue(), ^{
+    if (self->_prewarmedWebView == nil) {
+      WKWebViewConfiguration *config = [[WKWebViewConfiguration alloc] init];
+      config.processPool = [self sharedProcessPool];
+
+      // WebView 생성 - GPU/WebContent 프로세스 시작
+      self->_prewarmedWebView = [[WKWebView alloc] initWithFrame:CGRectMake(0, 0, 1, 1) configuration:config];
+
+      // 실제 렌더링 + 네트워크 요청으로 모든 프로세스 초기화
+      [self->_prewarmedWebView loadHTMLString:kWarmUpHTML baseURL:[NSURL URLWithString:@"https://webview.bootpay.co.kr"]];
+
+      self->_isWarmUpComplete = YES;
+
+#ifdef DEBUG
+      NSLog(@"[Bootpay] warmUp started - WebView processes initializing...");
+#endif
+    }
+  });
+}
+
+- (void)releaseWarmUp {
+  dispatch_async(dispatch_get_main_queue(), ^{
+    self->_prewarmedWebView = nil;
+    self->_isWarmUpComplete = NO;
+  });
+}
+
+- (BOOL)isWarmedUp {
+  return _isWarmUpComplete && _prewarmedWebView != nil;
+}
+
 @end
 

package/apple/BPCWebViewModule.mm

@@ -1,6 +1,7 @@
 #import "BPCWebViewModule.h"
 
 #import "BPCWebViewDecisionManager.h"
+#import "BPCWKProcessPoolManager.h"
 
 #ifdef RCT_NEW_ARCH_ENABLED
 #import <React/RCTFabricComponentsPlugins.h>
@@ -10,6 +11,25 @@
 
 RCT_EXPORT_MODULE(BPCWebViewModule)
 
+// 모듈 로드 시 자동으로 WebView 프리워밍 시작
++ (void)load {
+    dispatch_async(dispatch_get_main_queue(), ^{
+        [[BPCWKProcessPoolManager sharedManager] warmUp];
+    });
+}
+
+RCT_EXPORT_METHOD(warmUp) {
+    [[BPCWKProcessPoolManager sharedManager] warmUp];
+}
+
+RCT_EXPORT_METHOD(warmUpWithDelay:(double)delay) {
+    [[BPCWKProcessPoolManager sharedManager] warmUpWithDelay:delay];
+}
+
+RCT_EXPORT_METHOD(releaseWarmUp) {
+    [[BPCWKProcessPoolManager sharedManager] releaseWarmUp];
+}
+
 RCT_EXPORT_METHOD(isFileUploadSupported:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject) {
     if (resolve) {
         resolve(@(YES));

package/lib/NativeBPCWebViewModule.d.ts

@@ -3,6 +3,16 @@ import { Double } from 'react-native/Libraries/Types/CodegenTypes';
 export interface Spec extends TurboModule {
     isFileUploadSupported(): Promise<boolean>;
     shouldStartLoadWithLockIdentifier(shouldStart: boolean, lockIdentifier: Double): void;
+    /**
+     * WebView 프로세스를 미리 초기화하여 첫 결제 화면 로딩 속도를 개선합니다.
+     * 앱 시작 시 또는 결제 화면 진입 전에 호출하세요.
+     */
+    warmUp(): void;
+    /**
+     * 프리워밍된 WebView 리소스를 해제합니다.
+     * 메모리가 부족할 때 호출할 수 있습니다.
+     */
+    releaseWarmUp(): void;
 }
 declare const _default: Spec;
 export default _default;

package/package.json

@@ -10,8 +10,8 @@
     "Thibault Malbranche <malbranche.thibault@gmail.com>"
   ],
   "license": "MIT",
-  "version": "13.13.47",
-  "homepage": "https://github.com/react-native-webview/react-native-webview#readme",
+  "version": "13.13.49",
+  "homepage": "https://github.com/bootpay/react-native-webview-bootpay#readme",
   "scripts": {
     "android": "react-native run-android",
     "ios": "react-native run-ios",
@@ -41,38 +41,38 @@
     "invariant": "2.2.4"
   },
   "devDependencies": {
-    "@babel/cli": "^7.20.0",
-    "@babel/core": "^7.20.0",
-    "@babel/runtime": "^7.20.0",
-    "@callstack/react-native-visionos": "0.73.8",
-    "@react-native/babel-preset": "0.73.21",
-    "@react-native/eslint-config": "0.73.2",
-    "@react-native/metro-config": "0.73.5",
-    "@react-native/typescript-config": "0.73.1",
-    "@rnx-kit/metro-config": "1.3.15",
-    "@semantic-release/git": "7.0.16",
-    "@types/invariant": "^2.2.30",
-    "@types/jest": "^29.5.12",
-    "@types/react": "18.2.61",
-    "@types/selenium-webdriver": "4.0.9",
-    "appium": "1.17.0",
-    "eslint": "8.57.0",
-    "jest": "^29.6.3",
-    "prettier": "2.8.8",
-    "react": "18.2.0",
-    "react-native": "0.73.5",
-    "react-native-macos": "0.73.17",
-    "react-native-test-app": "3.7.2",
-    "react-native-windows": "0.73.8",
+    "@babel/cli": "^7.26.0",
+    "@babel/core": "^7.26.0",
+    "@babel/runtime": "^7.26.0",
+    "@callstack/react-native-visionos": "0.76.7",
+    "@react-native/babel-preset": "0.76.7",
+    "@react-native/eslint-config": "0.76.7",
+    "@react-native/metro-config": "0.76.7",
+    "@react-native/typescript-config": "0.76.7",
+    "@rnx-kit/metro-config": "2.2.0",
+    "@semantic-release/git": "10.0.1",
+    "@types/invariant": "^2.2.37",
+    "@types/jest": "^29.5.14",
+    "@types/react": "18.3.18",
+    "@types/selenium-webdriver": "4.1.28",
+    "appium": "2.15.0",
+    "eslint": "8.57.1",
+    "jest": "^29.7.0",
+    "prettier": "3.4.2",
+    "react": "18.3.1",
+    "react-native": "0.76.7",
+    "react-native-macos": "0.76.7",
+    "react-native-test-app": "3.11.7",
+    "react-native-windows": "0.76.7",
     "selenium-appium": "1.0.2",
-    "selenium-webdriver": "4.0.0-alpha.7",
-    "semantic-release": "15.13.24",
-    "typescript": "5.1.3",
+    "selenium-webdriver": "4.27.0",
+    "semantic-release": "24.2.1",
+    "typescript": "5.6.3",
     "winappdriver": "^0.0.7"
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/react-native-webview/react-native-webview.git"
+    "url": "https://github.com/bootpay/react-native-webview-bootpay.git"
   },
   "files": [
     "android/src",

package/src/NativeBPCWebViewModule.ts

@@ -8,6 +8,16 @@ export interface Spec extends TurboModule {
     shouldStart: boolean,
     lockIdentifier: Double
   ): void;
+  /**
+   * WebView 프로세스를 미리 초기화하여 첫 결제 화면 로딩 속도를 개선합니다.
+   * 앱 시작 시 또는 결제 화면 진입 전에 호출하세요.
+   */
+  warmUp(): void;
+  /**
+   * 프리워밍된 WebView 리소스를 해제합니다.
+   * 메모리가 부족할 때 호출할 수 있습니다.
+   */
+  releaseWarmUp(): void;
 }
 
 export default TurboModuleRegistry.getEnforcing<Spec>('BPCWebViewModule');