adwhale-sdk-react-native 2.7.203 → 2.7.300

package/AdwhaleSdkReactNative.podspec

@@ -16,5 +16,27 @@ Pod::Spec.new do |s|
   s.source_files = "ios/**/*.{h,m,mm,swift,cpp}"
   s.private_header_files = "ios/**/*.h"
 
+  # adwhale_sdk_flutter/ios/adwhale_sdk_flutter.podspec 과 동일: static framework + AdWhaleSDK
+  s.static_framework = true
+  s.swift_version = "5.0"
+
+  # ios/AdwhaleSdkReactNative.mm 에서 AdWhale iOS SDK(AdWhaleAds 등)를 사용
+  # 앱 Podfile 에는 AdWhaleSDK_iOS 소스가 있어야 함:
+  #   source 'https://github.com/dev-adwhale/AdWhaleSDK_iOS.git'
+  s.dependency "AdWhaleSDK", "1.0.4"
+  # AdWhaleSDK-Swift.h 가 GAD* 프로토콜/클래스를 참조하므로 컴파일 단위에 GMA 헤더가 필요함 (AdWhaleSDK/Core 와 동일 버전)
+  s.dependency "Google-Mobile-Ads-SDK", "13.0.0"
+
+  # Flutter 플러그인과 동일: UMP(UserMessagingPlatform) 검색 경로 + RN install_modules_dependencies 가 HEADER_SEARCH_PATHS 병합
+  # AdWhaleSDK-Swift.h 는 Pods 내 xcframework Headers 경로를 직접 넣음 (인덱싱/빌드 안정화)
+  s.pod_target_xcconfig = {
+    "DEFINES_MODULE" => "YES",
+    "EXCLUDED_ARCHS[sdk=iphonesimulator*]" => "i386",
+    "FRAMEWORK_SEARCH_PATHS" => "$(inherited) \"${PODS_CONFIGURATION_BUILD_DIR}/GoogleUserMessagingPlatform\" \"${PODS_ROOT}/GoogleUserMessagingPlatform/Frameworks/Release/UserMessagingPlatform.xcframework/ios-arm64\" \"${PODS_ROOT}/GoogleUserMessagingPlatform/Frameworks/Release/UserMessagingPlatform.xcframework/ios-arm64_x86_64-simulator\"",
+    # Swift → ObjC 생성 헤더(…-Swift.h). .mm 가 Swift보다 먼저 스캔될 때도 찾을 수 있게 함.
+    "HEADER_SEARCH_PATHS" => "$(inherited) \"$(DERIVED_SOURCES_DIR)\" \"${PODS_CONFIGURATION_BUILD_DIR}/AdwhaleSdkReactNative/AdwhaleSdkReactNative.framework/Headers\" \"${PODS_ROOT}/AdWhaleSDK/AdWhaleSDK.xcframework/ios-arm64/AdWhaleSDK.framework/Headers\" \"${PODS_ROOT}/AdWhaleSDK/AdWhaleSDK.xcframework/ios-arm64_x86_64-simulator/AdWhaleSDK.framework/Headers\"",
+    "OTHER_LDFLAGS" => "$(inherited) -framework \"UserMessagingPlatform\"",
+  }
+
   install_modules_dependencies(s)
 end

package/README.md

@@ -1,14 +1,18 @@
+# 최신 버전: 2.7.300
+
 # adwhale-sdk-react-native
-AdWhale Android 네이티브 광고 미디에이션 SDK를
+ADwhale Android/iOS 네이티브 광고 미디에이션 SDK를
 React Native 환경에서 사용할 수 있도록 제공하는 공식 SDK입니다.
 
 - Android 네이티브 SDK 기반
 - React Native Bridge / TurboModule 지원
-- 배너, 전면, 보상형, 네이티브 광고 지원
+- SDK 초기화, 배너, 전면, 보상형, 네이티브 광고(템플릿, 커스텀), 앱오프닝 광고, 앱 종료 팝업 광고, Android 전용 전환 팝업 광고 지원
+- 광고 이벤트 콜백 리스너 제공
 - Expo Bare Workflow / Custom Dev Client 지원
 
 > ⚠️ Expo Go (Managed Workflow)에서는 네이티브 모듈 특성상 사용할 수 없습니다.
 
+자세한 가이드는 https://adwhale.gitbook.io/adwhale-mediation-sdk/react-native/sdk 를 참고하세요.
 ---
 
 ## Installation
@@ -22,18 +26,19 @@ npm install adwhale-sdk-react-native
 
 
 ## Version Policy
-본 SDK는 Android 네이티브 SDK 버전과의 대응 관계를 명확히 유지하기 위해
+본 SDK는 Android 네이티브 및 iOS 네이티브 SDK 버전과의 대응 관계를 명확히 유지하기 위해
 다음과 같은 버전 규칙을 사용합니다.
 - 앞 세 자릿수(Major.Minor.Patch) 는 Android SDK 버전과 동일
 - React Native 전용 수정 사항은 Patch 값을 확장하여 관리
 
 ### Version Mapping Example
-  | Android SDK | React Native SDK | Description |
-  |------------|------------------|-------------|
-  | 2.7.1 | 2.7.100 | Android 2.7.1 기반 RN SDK 최초 릴리스 |
-  | 2.7.1 | 2.7.101 | RN 레이어 핫픽스 |
-  | 2.7.1 | 2.7.102 | RN 버그 수정 |
-  | 2.7.2 | 2.7.200 | Android SDK 2.7.2 반영 |
+  | Android SDK | React Native SDK | Description                    |
+  |-------------|------------------|--------------------------------|
+  | 2.7.1       | 2.7.100          | Android 2.7.1 기반 RN SDK 최초 릴리스 |
+  | 2.7.1       | 2.7.101          | RN 레이어 핫픽스                     |
+  | 2.7.1       | 2.7.102          | RN 버그 수정                       |
+  | 2.7.2       | 2.7.200          | Android SDK 2.7.2 반영           |
+  | 2.7.3       | 2.7.300          | Android SDK 2.7.3 반영           |
 
 
 ## Version Usage Guide
@@ -43,42 +48,29 @@ npm install adwhale-sdk-react-native
 운영 안정성을 중시하는 경우
 ```json
 {
-  "adwhale-sdk-react-native": "~2.7.203"
+  "adwhale-sdk-react-native": "~2.7.300"
 }
 ```
-- Android SDK 2.7.2 기반 유지
+- Android SDK 2.7.3 기반 유지
 - RN 핫픽스만 자동 반영
-
-### 동일한 Android SDK 기반의 최신 RN 수정만 사용
-```json
-{
-  "adwhale-sdk-react-native": "^2.7.203"
-}
-```
-- Android SDK 2.7.x 범위 내 최신 RN 수정 자동 반영
-- Android SDK 상위 메이저/마이너 버전은 반영되지 않음
-
+- >=2.7.3+0 <2.8.0 범위
 
 ### 특정 버전을 완전히 고정하여 사용하는 경우
 ```json
 {
-  "adwhale-sdk-react-native": "2.7.203"
-}
-```
-
-
-### 항상 최신 버전을 사용하는 경우
-```json
-{
-  "adwhale-sdk-react-native": "latest"
+  "adwhale-sdk-react-native": "2.7.300"
 }
 ```
-- 최신 Android SDK 및 RN SDK 포함
-- 개발 및 검증 환경에 적합
-
+- 버전 변경 없음
+- 재현성, 장애 분석에 최적
+- QA / 장애 재현 환경
+- 장기 유지 브랜치
 
 ## Example Project
-SDK 동작을 바로 확인할 수 있는 example 프로젝트가 포함되어 있습니다.
+SDK 동작을 바로 확인할 수 있는 example 프로젝트를 제공합니다.
+- [React Native 샘플](https://github.com/dev-adwhale/ADwhaleMediationSDK-ReactNative/tree/main/ReactNativeSample)
+- [Expo 샘플](https://github.com/dev-adwhale/ADwhaleMediationSDK-ReactNative/tree/main/ExpoSample)
+yarn 사용시
 ```sh
 yarn install
 yarn prepare
@@ -86,6 +78,13 @@ cd example
 yarn android
 ```
 
+npm 사용시
+```sh
+npm install
+cd example
+npm run android
+```
+
 ## Expo Support
 다음 환경에서 사용 가능합니다.
 - Expo Bare Workflow
@@ -98,24 +97,91 @@ Expo Go 환경에서는 사용할 수 없습니다.
 - 배너 광고
 - 전면 광고
 - 보상형 광고
-- 네이티브 광고 (Template / Custom)
-- 광고 이벤트 리스너 제공
+- 네이티브 템플릿 광고
+- 네이티브 커스텀 광고
+- 앱 오프닝 광고
+- 앱 종료 팝업 광고
+- Android 전용 전환 팝업 광고
+- 광고 이벤트 콜백 리스너 제공
 
+---
 
 ## Troubleshooting
-Android 빌드 오류 발생 시:
+
+### Android 빌드 오류
 ```sh
 cd example/android
 ./gradlew clean
 ```
 
-환경 점검:
+### iOS: "PhaseScriptExecution failed with a nonzero exit code"
+Xcode 빌드 시 **Run Script** 단계 중 하나가 실패할 때 나옵니다. 어떤 스크립트에서 실패했는지부터 확인하세요.
+
+**1) 실패한 스크립트 확인**
+- Xcode에서 **Product → Build** 후 왼쪽 **Report navigator** (⌘9) → 최근 빌드 선택
+- 빌드 로그에서 **PhaseScriptExecution** 또는 **Run Script** 근처의 **빨간 에러 메시지** 확인
+- 실패한 스크립트 이름(예: "Bundle React Native code and images", "Embed Pods Frameworks")과 그 아래 출력 내용 확인
+
+**2) 자주 쓰는 해결 방법**
+```sh
+# example 기준 (저장소 루트에서)
+cd example
+yarn install   # 또는 npm install
+cd ios
+rm -rf build Pods Podfile.lock
+pod install
+cd ..
+yarn ios       # 또는 npx react-native run-ios
+# CLI로만 빌드해 볼 때:
+# yarn build:ios   # example/package.json의 react-native build-ios
+```
+- **Podfile.lock 불일치**라면: `example/ios`에서 `pod install`을 다시 실행합니다.
+- **"Bundle React Native code and images"** 등 Node를 쓰는 스크립트 실패: Xcode가 터미널과 다른 `PATH`로 `node`를 못 찾는 경우가 많습니다. 터미널에서 `which node`로 경로를 확인한 뒤, `example/ios/.xcode.env` 또는 `example/ios/.xcode.env.local`에 `export NODE_BINARY=...`로 지정하거나, Xcode **Build Phases**의 해당 Run Script 상단에 동일하게 넣어 보세요.
+- **Hermes / 번들 관련 스크립트** 실패: 위 정리 후 터미널에서 `yarn build:ios`(또는 `npx react-native build-ios`)로 한 번 빌드해 로그를 확인합니다.
+- **실기기/서명** 관련이라면: Development team·신뢰 설정을 확인합니다.
+
+### iOS 실기기에서 "Development team" 오류가 나는 이유
+- **시뮬레이터**: 코드 서명이 필요 없어 Development team 없이 실행됩니다.
+- **실제 기기(USB)**: iOS는 기기 설치 시 **Apple 개발자 팀(Development team)** 서명을 요구합니다.
+
+**해결**: Xcode에서 `example/ios/AdwhaleSdkReactNativeExample.xcworkspace` 열기 → **AdwhaleSdkReactNativeExample** 타깃 → **Signing & Capabilities** → **Team**에서 본인 Apple ID(팀) 선택. (무료 Apple ID로도 실기기 테스트 가능)
+자신의 앱이라면 해당 앱의 `.xcworkspace`와 앱 타깃 이름에 맞춰 동일하게 설정하면 됩니다.
+
+### iOS 실기기에서 "신뢰하지 않는 개발자" / 앱이 실행되지 않을 때
+무료 Apple ID로 서명한 앱을 **처음** 실기기에 설치한 경우, iOS가 개발자를 "신뢰하지 않음"으로 두어 앱 실행을 막습니다.
+이때 Xcode에서는 *"failed to launch"*, *"exited before the debugger could attach"* 같은 메시지가 나올 수 있습니다.
+
+**해결 (iPhone에서 한 번만 하면 됨)**
+1. iPhone **설정** → **일반** → **VPN 및 기기 관리** (또는 **기기 관리** / **프로필 및 기기 관리**)
+2. **개발자 앱** 아래에서 본인 Apple ID(예: `xxxxx@gmail.com`) 항목 선택
+3. **"[Apple ID]을(를) 신뢰"** 탭 → **신뢰** 확인
+4. 이후부터는 해당 기기에서 같은 Apple ID로 서명한 앱이 정상 실행됩니다.
+
+### iOS App Store 배포
+이 SDK를 사용한 앱을 App Store에 제출·배포하는 데 문제 없습니다.
+실기기 테스트·스토어 제출 시에는 위와 같이 서명(Development team, 프로비저닝 프로필)을 설정하고, [ADwhale React Native 가이드](https://adwhale.gitbook.io/adwhale-mediation-sdk/react-native/sdk)에 안내된 iOS 설정(Info.plist, App Transport Security, AdMob(Google) App ID 등)을 준수하면 됩니다.
+
+### 환경 점검:
 ```sh
 npx react-native doctor
 ```
 
+## Changelog
+| 배포버전    | 내용                                                                                                                                            | 배포날짜       |
+  |---------|-----------------------------------------------------------------------------------------------------------------------------------------------|------------|
+| 2.7.300 | 애드웨일 Android 2.7.3 업데이트 및 ios 1.0.4 추가                                                                                                     | 2026.04.11 |
+| 2.7.204 | 버그 및 샘플 수정                                                                                                                                    | 2026.01.22 |
+| 2.7.203 | 버그 및 샘플 수정                                                                                                                                    | 2026.01.19 |
+| 2.7.202 | 버그 및 샘플 수정                                                                                                                                    | 2026.01.19 |
+| 2.7.201 | 버그 및 샘플 수정                                                                                                                                    | 2026.01.12 |
+| 2.7.200 | 앱오프닝 광고 추가 (ADwhale Android SDK v2.7.2에서 추가됨)                                                                                                 | 2026.01.09 |
+| 2.7.102 | gcoder 및 placement name 추가                                                                                                                    | 2025.12.29 |
+| 2.7.101 | 버그 및 샘플 수정                                                                                                                                    | 2025.12.23 |
+| 2.7.100 | 네이티브 광고 추가 (ADwhale Android SDK v2.7.0) | 2025.12.15 |
+|         | GDPR 기능 추가 (ADwhale Android SDK v2.7.0) |            |
+|         | 적응형 배너 추가 (ADwhale Android SDK v2.7.1) |            |
 
 ## Learn More
+- [ADwhale ReactNative 가이드](https://adwhale.gitbook.io/adwhale-mediation-sdk/react-native/sdk)
 - [React Native Documentation](https://reactnative.dev/docs/getting-started)
 - [Expo Documentation](https://docs.expo.dev)
-- [AdWhale SDK Guide](https://adwhale.gitbook.io/adwhale-mediation-sdk/react-native/sdk)

package/android/build.gradle

@@ -2,6 +2,21 @@ plugins {
   id "com.android.library"
   id "com.facebook.react"
 }
+Properties properties = new Properties()
+// local.properties 경로 탐색 (라이브러리 단독 빌드 vs example 앱 빌드)
+def localPropertiesCandidates = [
+  project.file('../local.properties'),           // 라이브러리 단독 빌드: android/ → adwhale-sdk-react-native/
+  project.rootProject.file('../../local.properties')  // example 앱 빌드: example/android/ → adwhale-sdk-react-native/
+]
+def lp = localPropertiesCandidates.find { it.exists() }
+if (lp != null) {
+  properties.load(lp.newDataInputStream())
+}
+ext.sdkVersionMajor = (properties["sdkVersionMajor"] ?: "1")
+ext.sdkVersionMinor = (properties["sdkVersionMinor"] ?: "0")
+ext.sdkVersionPatch = (properties["sdkVersionPatch"] ?: "0")
+ext.sdkVersionCode = Integer.valueOf((Integer.parseInt(sdkVersionMajor)*10000) + (Integer.parseInt(sdkVersionMinor)*100) + Integer.parseInt(sdkVersionPatch))
+ext.sdkVersion = "${sdkVersionMajor}.${sdkVersionMinor}.${sdkVersionPatch}"
 
 def resolveNodeBinary() {
   def candidateSources = [
@@ -120,19 +135,4 @@ dependencies {
   // 기본 디펜던시: ADwhale Mediation SDK Repository
   implementation "net.adwhale.sdk.mediation:adwhale-mediation-sdk:2.7.2"
 
-  // 옵션 디펜던시(제외가능): Cauly Adapter SDK Repository
-  implementation "net.adwhale.sdk.cauly.adapter:cauly-sdk:3.5.41.0"
-
-  // 옵션 디펜던시(제외가능): Admize Adapter SDK Repository
-  implementation "net.adwhale.sdk.admize.adapter:admize-sdk:1.0.8.0"
-
-  // 옵션 디펜던시(제외가능): AdFit Adapter SDK Repository
-  implementation "net.adwhale.sdk.adfit.adapter:adfit-sdk:3.17.2.5"
-
-  // 옵션 디펜던시(제외가능): Admob Adapter SDK Repository
-  implementation "net.adwhale.sdk.admob.adapter:admob-sdk:24.3.0.2"
-
-  // 옵션 디펜던시(제외가능): Levelplay Adapter SDK Repository
-  implementation "net.adwhale.sdk.levelplay.adapter:levelplay-sdk:8.7.0.6"
-
 }

package/android/proguard-rules.pro

@@ -22,6 +22,14 @@
 #================== AdWhale Mediation SDK Proguard for Release 적용 코드 시작 ==================
 
 -keepclasseswithmembers class net.adwhale.sdk.mediation.ads.AdWhaleMediationAds {
+    public static final int TAG_FOR_UNDER_AGE_OF_CONSENT_UNSPECIFIED;
+    public static final int TAG_FOR_UNDER_AGE_OF_CONSENT_FALSE;
+    public static final int TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE;
+    public static final java.lang.String MAX_AD_CONTENT_RATING_G;
+    public static final java.lang.String MAX_AD_CONTENT_RATING_PG;
+    public static final java.lang.String MAX_AD_CONTENT_RATING_T;
+    public static final java.lang.String MAX_AD_CONTENT_RATING_MA;
+
     public static *** init(***);
     public static *** init(***, ***);
     public static *** setCoppa(***);
@@ -32,24 +40,40 @@
     public static *** getGdprConsentStatus(***);
     public static *** resetGdprConsentStatus(***);
     public static *** getAdwhaleGDPR(***);
+    public static *** setAppVolume(***);
+    public static *** setAppMuted(***);
+    public static *** setTagForUnderAgeOfConsent(***);
+    public static *** setMaxAdContentRating(***);
+    public static *** setTestDeviceIdentifiers(***);
+    public static *** openAdInspector(***, ***);
 }
 
+-keep interface net.adwhale.sdk.mediation.ads.AdWhaleGdprConsentListener {*;}
+-keep interface net.adwhale.sdk.mediation.ads.AdWhaleMediationAdInspectorCloseListener {*;}
 -keep interface net.adwhale.sdk.mediation.ads.AdWhaleMediationOnInitCompleteListener {*;}
 
 -keepclasseswithmembers class net.adwhale.sdk.utils.AdWhaleLog {
     public static *** setLogLevel(***);
     public static *** getLogLevel();
+    public static *** d(***);
+    public static *** i(***);
+    public static *** w(***);
+    public static *** e(java.lang.String);
+    public static *** e(java.lang.String, java.lang.Exception);
+    public static *** e(java.lang.String, java.lang.Throwable);
 }
 
 -keep class net.adwhale.sdk.mediation.ads.ADWHALE_AD_SIZE {*;}
 -keep class net.adwhale.sdk.mediation.ads.ADWHALE_RESULT_CODE {*;}
 -keep class net.adwhale.sdk.mediation.ads.ADWHALE_NATIVE_TEMPLATE {*;}
+-keep class net.adwhale.sdk.mediation.ads.ADWHALE_POPUP_AD_CLOSE_REASON {*;}
 -keep class net.adwhale.sdk.mediation.ads.GdprConsentStatus {*;}
 
 -keep class net.adwhale.sdk.utils.AdWhaleLog$LogLevel{*;}
 -keep class net.adwhale.sdk.impl.mediation.ReqMediationAdConfig {*;}
 -keep class net.adwhale.sdk.impl.mediation.ResMediationAdConfig {*;}
 -keep class net.adwhale.sdk.impl.mediation.ResMediation {*;}
+-keep class net.adwhale.sdk.impl.mediation.ResExtension {*;}
 
 -keepclasseswithmembers class net.adwhale.sdk.mediation.ads.AdWhaleMediationInterstitialAd {
     public <init>(...);
@@ -150,115 +174,36 @@
 
 -keep interface net.adwhale.sdk.mediation.ads.AdWhaleMediationAppOpenAdListener {*;}
 
-#================== AdWhale Mediation SDK Proguard for Release 적용 코드 끝 ==================
-
-#================== AdWhale Cauly Adapter SDK Proguard for Release 적용 코드 시작 ==================
-
--keep class net.adwhale.sdk.cauly.adapter.CaulyAdBannerLoader {*;}
-
--keep class net.adwhale.sdk.cauly.adapter.CaulyAdBannerPreLoader {*;}
-
--keep class net.adwhale.sdk.cauly.adapter.CaulyAdInterstitialLoader {*;}
-
--keep class net.adwhale.sdk.cauly.adapter.CaulyAdRewardLoader {*;}
-
--keep class net.adwhale.sdk.cauly.adapter.CaulyCustomEventInterstitialLoader {*;}
-
--keep class net.adwhale.sdk.cauly.adapter.CaulyCustomEventBannerLoader {*;}
-
--keep class net.adwhale.sdk.cauly.adapter.CaulyCustomEventRewardLoader {*;}
-
-#================== AdWhale Cauly Adapter SDK Proguard for Release 적용 코드 끝 ==================
-
-#================== AdWhale Admize Adapter SDK Proguard for Release 적용 코드 시작 ==================
-
--keep class net.adwhale.sdk.admize.adapter.AdmizeAdBannerLoader {*;}
-
--keep class net.adwhale.sdk.admize.adapter.AdmizeAdBannerPreLoader {*;}
-
--keep class net.adwhale.sdk.admize.adapter.AdmizeAdInterstitialLoader {*;}
-
--keep class net.adwhale.sdk.admize.adapter.AdmizeAdRewardLoader {*;}
-
-#================== AdWhale Admize Adapter SDK Proguard for Release 적용 코드 끝 ==================
-
-#================== AdWhale AdFit Adapter SDK Proguard for Release 적용 코드 시작 ==================
-
--keep class net.adwhale.sdk.adfit.adapter.AdFitAdBannerLoader {*;}
-
--keep class net.adwhale.sdk.adfit.adapter.AdFitAdBannerPreLoader {*;}
-
-#================== AdWhale AdFit Adapter SDK Proguard for Release 적용 코드 끝 ==================
-
-#================== AdWhale AdManager Adapter SDK Proguard for Release 적용 코드 시작 ==================
-
--keep class net.adwhale.sdk.admob.adapter.AdManagerAdBannerLoader {*;}
-
--keep class net.adwhale.sdk.admob.adapter.AdManagerAdBannerPreLoader {*;}
-
--keep class net.adwhale.sdk.admob.adapter.AdManagerAdInterstitialLoader {*;}
-
--keep class net.adwhale.sdk.admob.adapter.AdManagerAdNativeTemplateLoader {*;}
-
--keep class net.adwhale.sdk.admob.adapter.AdManagerAdNativeCustomBindingLoader {*;}
-
--keep class net.adwhale.sdk.admob.adapter.AdManagerAdRewardLoader {*;}
-
--keep class net.adwhale.sdk.admob.adapter.AdManagerAdRewardedInterstitialLoader {*;}
--keep class net.adwhale.sdk.admob.adapter.AdManagerAdAppOpeningLoader {*;}
-
-#================== AdWhale AdManager Adapter SDK Proguard for Release 적용 코드 끝 ==================
-
-#================== AdWhale Admob Adapter SDK Proguard for Release 적용 코드 시작 ==================
-
--keep class net.adwhale.sdk.admob.adapter.AdmobAdBannerLoader {*;}
-
--keep class net.adwhale.sdk.admob.adapter.AdmobAdBannerPreLoader {*;}
-
--keep class net.adwhale.sdk.admob.adapter.AdmobAdInterstitialLoader {*;}
-
--keep class net.adwhale.sdk.admob.adapter.AdmobAdNativeTemplateLoader {*;}
-
--keep class net.adwhale.sdk.admob.adapter.AdmobAdNativeCustomBindingLoader {*;}
-
--keep class net.adwhale.sdk.admob.adapter.AdmobAdRewardLoader {*;}
-
--keep class net.adwhale.sdk.admob.adapter.AdmobAdRewardedInterstitialLoader {*;}
-
--keep class net.adwhale.sdk.admob.adapter.AdmobAdAppOpeningLoader {*;}
-
--keep class net.adwhale.sdk.admob.adapter.custom.cauly.AdMobCaulyEvent {*;}
-
--keep class net.adwhale.sdk.admob.adapter.custom.cauly.CaulyMediationBannerAd {*;}
-
--keep class net.adwhale.sdk.admob.adapter.custom.cauly.CaulyMediationInterstitialAd {*;}
-
--keep class net.adwhale.sdk.admob.adapter.custom.cauly.CaulyMediationRewardAd {*;}
-
-# AdWhale AdMob Adapter - Keep the public entry points for reflection
--keep public class net.adwhale.sdk.admob.adapter.AdMobPrivacyAdapter {
-    public static net.adwhale.sdk.admob.adapter.AdMobPrivacyAdapter getInstance();
+-keepclasseswithmembers class net.adwhale.sdk.mediation.ads.AdWhaleMediationExitPopupAd {
+    public <init>(...);
+    public *** loadAd();
+    public *** showAd(***, ***);
+    public *** setRegion(***);
+    public *** setGcoder(***, ***);
+    public *** setPlacementUid(***);
+    public *** setPlacementName(***);
+    public *** setCustomizeButtonText(***, ***);
+    public *** setCustomDescription(***);
+    public *** destroy();
+    public *** resume(***);
+    public *** setAdWhaleMediationExitPopupAdListener(***);
 }
 
-#================== AdWhale Admob Adapter SDK Proguard for Release 적용 코드 끝 ==================
+-keep interface net.adwhale.sdk.mediation.ads.AdWhaleMediationExitPopupAdListener {*;}
 
-#================== AdWhale LevelPlay Adapter SDK Proguard for Release 적용 코드 시작 ==================
-
--keep class net.adwhale.sdk.levelplay.adapter.LevelPlayAdBannerLoader {*;}
-
--keep class net.adwhale.sdk.levelplay.adapter.LevelPlayAdBannerPreLoader {*;}
-
--keep class net.adwhale.sdk.levelplay.adapter.LevelPlayAdInterstitialLoader {*;}
-
--keep class net.adwhale.sdk.levelplay.adapter.LevelPlayAdRewardLoader {*;}
-
--keep class net.adwhale.sdk.levelplay.adapter.LevelPlayAdNativeCustomBindingLoader {*;}
-
--keep class net.adwhale.sdk.levelplay.adapter.LevelPlayAdNativeTemplateLoader {*;}
-
-# AdWhale LevelPlay Adapter - Keep the public entry points for reflection
--keep public class net.adwhale.sdk.levelplay.adapter.LevelPlayPrivacyAdapter {
-    public static net.adwhale.sdk.levelplay.adapter.LevelPlayPrivacyAdapter getInstance();
+-keepclasseswithmembers class net.adwhale.sdk.mediation.ads.AdWhaleMediationTransitionPopupAd {
+    public <init>(...);
+    public *** loadAd();
+    public *** showAd(***, ***);
+    public *** setRegion(***);
+    public *** setGcoder(***, ***);
+    public *** setPlacementUid(***);
+    public *** setPlacementName(***);
+    public *** destroy();
+    public *** resume(***);
+    public *** setAdWhaleMediationTransitionPopupAdListener(***);
 }
 
-#================== AdWhale LevelPlay Adapter SDK Proguard for Release 적용 코드 끝 ==================
+-keep interface net.adwhale.sdk.mediation.ads.AdWhaleMediationTransitionPopupAdListener {*;}
+
+#================== AdWhale Mediation SDK Proguard for Release 적용 코드 끝 ==================

package/android/src/main/java/com/adwhalesdkreactnative/AdWhaleCustomNativeBinderFactory.java

@@ -0,0 +1,18 @@
+package com.adwhalesdkreactnative;
+
+/**
+ * Flutter Android 편의 클래스명과 동일한 구현.
+ * 내부 동작은 기존 SimpleBinderFactory와 동일합니다.
+ */
+public class AdWhaleCustomNativeBinderFactory extends SimpleBinderFactory implements BinderFactory {
+    public AdWhaleCustomNativeBinderFactory(
+            int layoutId,
+            int iconViewId,
+            int titleViewId,
+            int bodyTextViewId,
+            int callToActionViewId,
+            int mediaViewGroupId) {
+        super(layoutId, iconViewId, titleViewId, bodyTextViewId, callToActionViewId, mediaViewGroupId);
+    }
+}
+

package/android/src/main/java/com/adwhalesdkreactnative/AdwhaleSdkReactNativePackage.java

@@ -43,6 +43,13 @@ public class AdwhaleSdkReactNativePackage extends BaseReactPackage {
     binderFactoryMap.put(factoryId, factory);
   }
 
+  /**
+   * Flutter와 동일 타입명(BinderFactory) 오버로드.
+   */
+  public static void registerBinderFactory(@NonNull String factoryId, @NonNull BinderFactory factory) {
+    registerBinderFactory(factoryId, (NativeAdBinderFactory) factory);
+  }
+
   /**
    * 등록된 BinderFactory를 가져옵니다.
    *
@@ -79,11 +86,21 @@ public class AdwhaleSdkReactNativePackage extends BaseReactPackage {
       return new RNAdWhaleMediationRewardAd(reactContext);
     }
 
-    // 엡오프닝 Old Architecture를 따르지만 등록은 TurboModule로 등록
+    // 앱오프닝 Old Architecture를 따르지만 등록은 TurboModule로 등록
     if(RNAdWhaleMediationAppOpenAd.REACT_CLASS_NAME.equals(name)) {
       return new RNAdWhaleMediationAppOpenAd(reactContext);
     }
 
+    // 앱종료 Old Architecture를 따르지만 등록은 TurboModule로 등록
+    if (RNAdWhaleMediationExitPopupAd.REACT_CLASS_NAME.equals(name)) {
+      return new RNAdWhaleMediationExitPopupAd(reactContext);
+    }
+
+    // 앱전환 Old Architecture를 따르지만 등록은 TurboModule로 등록
+    if (RNAdWhaleMediationTransitionPopupAd.REACT_CLASS_NAME.equals(name)) {
+      return new RNAdWhaleMediationTransitionPopupAd(reactContext);
+    }
+
     return null;
   }
 
@@ -96,7 +113,9 @@ public class AdwhaleSdkReactNativePackage extends BaseReactPackage {
       new RNAdWhaleMediationLoggerModule(reactContext),
       new RNAdWhaleMediationInterstitialAd(reactContext),
       new RNAdWhaleMediationRewardAd(reactContext),
-      new RNAdWhaleMediationAppOpenAd(reactContext)
+      new RNAdWhaleMediationAppOpenAd(reactContext),
+      new RNAdWhaleMediationExitPopupAd(reactContext),
+      new RNAdWhaleMediationTransitionPopupAd(reactContext)
       // RNAdWhaleMediationAdSettingModule는 TurboModule로 등록되므로 여기서 굳이 추가 안 해도 됨
     );
   }
@@ -129,7 +148,7 @@ public class AdwhaleSdkReactNativePackage extends BaseReactPackage {
         )
       );
 
-      // 로거/전면/보상형/앱오프닝은 legacy 모듈로 사용 (isTurboModule = false)
+      // 로거/전면/보상형/앱오프닝/앱종료/앱전환은 legacy 모듈로 사용 (isTurboModule = false)
       moduleInfos.put(
         RNAdWhaleMediationLoggerModule.REACT_CLASS_NAME,
         new ReactModuleInfo(
@@ -142,7 +161,7 @@ public class AdwhaleSdkReactNativePackage extends BaseReactPackage {
         )
       );
 
-      // 로거/전면/보상형/앱오프닝은 legacy 모듈로 사용 (isTurboModule = false)
+      // 로거/전면/보상형/앱오프닝/앱종료/앱전환은 legacy 모듈로 사용 (isTurboModule = false)
       moduleInfos.put(
         RNAdWhaleMediationInterstitialAd.REACT_CLASS_NAME,
         new ReactModuleInfo(
@@ -155,7 +174,7 @@ public class AdwhaleSdkReactNativePackage extends BaseReactPackage {
         )
       );
 
-      // 로거/전면/보상형/앱오프닝은 legacy 모듈로 사용 (isTurboModule = false)
+      // 로거/전면/보상형/앱오프닝/앱종료/앱전환은 legacy 모듈로 사용 (isTurboModule = false)
       moduleInfos.put(
         RNAdWhaleMediationRewardAd.REACT_CLASS_NAME,
         new ReactModuleInfo(
@@ -168,7 +187,7 @@ public class AdwhaleSdkReactNativePackage extends BaseReactPackage {
         )
       );
 
-      // 로거/전면/보상형/앱오프닝은 legacy 모듈로 사용 (isTurboModule = false)
+      // 로거/전면/보상형/앱오프닝/앱종료/앱전환은 legacy 모듈로 사용 (isTurboModule = false)
       moduleInfos.put(
         RNAdWhaleMediationAppOpenAd.REACT_CLASS_NAME,
         new ReactModuleInfo(
@@ -181,6 +200,32 @@ public class AdwhaleSdkReactNativePackage extends BaseReactPackage {
         )
       );
 
+      // 로거/전면/보상형/앱오프닝/앱종료/앱전환은 legacy 모듈로 사용 (isTurboModule = false)
+      moduleInfos.put(
+        RNAdWhaleMediationExitPopupAd.REACT_CLASS_NAME,
+        new ReactModuleInfo(
+          RNAdWhaleMediationExitPopupAd.REACT_CLASS_NAME,
+          RNAdWhaleMediationExitPopupAd.REACT_CLASS_NAME,
+          false,
+          false,
+          false,
+          false
+        )
+      );
+
+      // 로거/전면/보상형/앱오프닝/앱종료/앱전환은 legacy 모듈로 사용 (isTurboModule = false)
+      moduleInfos.put(
+        RNAdWhaleMediationTransitionPopupAd.REACT_CLASS_NAME,
+        new ReactModuleInfo(
+          RNAdWhaleMediationTransitionPopupAd.REACT_CLASS_NAME,
+          RNAdWhaleMediationTransitionPopupAd.REACT_CLASS_NAME,
+          false,
+          false,
+          false,
+          false
+        )
+      );
+
       return moduleInfos;
     };
   }

package/android/src/main/java/com/adwhalesdkreactnative/BinderFactory.java

@@ -0,0 +1,9 @@
+package com.adwhalesdkreactnative;
+
+/**
+ * Flutter Android 인터페이스명과 동일하게 맞춘 alias.
+ * 기존 RN 구현의 NativeAdBinderFactory와 동일 역할입니다.
+ */
+public interface BinderFactory extends NativeAdBinderFactory {
+}
+