adwhale-sdk-react-native 2.7.202 → 2.7.204

package/README.md

@@ -1,5 +1,5 @@
 # adwhale-sdk-react-native
-AdWhale Android 네이티브 광고 미디에이션 SDK를
+ADwhale Android 네이티브 광고 미디에이션 SDK를
 React Native 환경에서 사용할 수 있도록 제공하는 공식 SDK입니다.
 
 - Android 네이티브 SDK 기반
@@ -43,7 +43,7 @@ npm install adwhale-sdk-react-native
 운영 안정성을 중시하는 경우
 ```json
 {
-  "adwhale-sdk-react-native": "~2.7.202"
+  "adwhale-sdk-react-native": "~2.7.204"
 }
 ```
 - Android SDK 2.7.2 기반 유지
@@ -52,7 +52,7 @@ npm install adwhale-sdk-react-native
 ### 동일한 Android SDK 기반의 최신 RN 수정만 사용
 ```json
 {
-  "adwhale-sdk-react-native": "^2.7.202"
+  "adwhale-sdk-react-native": "^2.7.204"
 }
 ```
 - Android SDK 2.7.x 범위 내 최신 RN 수정 자동 반영
@@ -62,7 +62,7 @@ npm install adwhale-sdk-react-native
 ### 특정 버전을 완전히 고정하여 사용하는 경우
 ```json
 {
-  "adwhale-sdk-react-native": "2.7.202"
+  "adwhale-sdk-react-native": "2.7.204"
 }
 ```
 
@@ -78,7 +78,10 @@ npm install adwhale-sdk-react-native
 
 
 ## 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 +89,13 @@ cd example
 yarn android
 ```
 
+npm 사용시
+```sh
+npm install
+cd example
+npm run android
+```
+
 ## Expo Support
 다음 환경에서 사용 가능합니다.
 - Expo Bare Workflow
@@ -114,8 +124,21 @@ cd example/android
 npx react-native doctor
 ```
 
+## Changelog
+| 배포버전    | 내용                                                                                                                                            | 배포날짜       |
+  |---------|-----------------------------------------------------------------------------------------------------------------------------------------------|------------|
+| 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

@@ -151,114 +151,3 @@
 -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();
-}
-
-#================== AdWhale Admob Adapter SDK Proguard for Release 적용 코드 끝 ==================
-
-#================== 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();
-}
-
-#================== AdWhale LevelPlay Adapter SDK Proguard for Release 적용 코드 끝 ==================

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

@@ -1,6 +1,7 @@
 package com.adwhalesdkreactnative;
 
 import androidx.annotation.NonNull;
+import androidx.annotation.Nullable;
 
 import com.facebook.react.BaseReactPackage;
 import com.facebook.react.bridge.NativeModule;
@@ -13,12 +14,48 @@ import java.util.Arrays;
 import java.util.HashMap;
 import java.util.List;
 import java.util.Map;
+import java.util.concurrent.ConcurrentHashMap;
 
 /**
  * React Native New Architecture 적용
  * TurboModule(code gen 모듈) + 기존 NativeModule(전면/보상형) + ViewManager 혼용 구조
  */
 public class AdwhaleSdkReactNativePackage extends BaseReactPackage {
+  /**
+   * factoryId를 키로 하는 BinderFactory 저장소
+   */
+  private static final Map<String, NativeAdBinderFactory> binderFactoryMap = new ConcurrentHashMap<>();
+
+  /**
+   * 사용자 지정 커스텀 네이티브 레이아웃을 등록합니다.
+   * Flutter의 AdWhaleSdkFlutterPlugin.registerBinderFactory와 동일한 기능을 제공합니다.
+   *
+   * @param factoryId 팩토리 ID (예: "app_custom")
+   * @param factory BinderFactory 인스턴스
+   */
+  public static void registerBinderFactory(@NonNull String factoryId, @NonNull NativeAdBinderFactory factory) {
+    if (factoryId == null || factoryId.isEmpty()) {
+      throw new IllegalArgumentException("factoryId cannot be null or empty");
+    }
+    if (factory == null) {
+      throw new IllegalArgumentException("factory cannot be null");
+    }
+    binderFactoryMap.put(factoryId, factory);
+  }
+
+  /**
+   * 등록된 BinderFactory를 가져옵니다.
+   *
+   * @param factoryId 팩토리 ID
+   * @return 등록된 BinderFactory 또는 null
+   */
+  @Nullable
+  public static NativeAdBinderFactory getBinderFactory(@Nullable String factoryId) {
+    if (factoryId == null || factoryId.isEmpty()) {
+      return null;
+    }
+    return binderFactoryMap.get(factoryId);
+  }
 
   @Override
   public NativeModule getModule(String name, ReactApplicationContext reactContext) {

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

@@ -0,0 +1,19 @@
+package com.adwhalesdkreactnative;
+
+import android.app.Activity;
+import androidx.annotation.NonNull;
+import net.adwhale.sdk.mediation.ads.AdWhaleNativeAdBinder;
+
+/**
+ * 네이티브 광고 바인더를 생성하는 팩토리 인터페이스
+ */
+public interface NativeAdBinderFactory {
+    /**
+     * AdWhaleNativeAdBinder를 생성합니다.
+     *
+     * @param activity 현재 Activity
+     * @return AdWhaleNativeAdBinder 인스턴스
+     */
+    @NonNull
+    AdWhaleNativeAdBinder createBinder(@NonNull Activity activity);
+}

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

@@ -100,7 +100,11 @@ public class RNAdWhaleMediationAdSettingModule extends NativeAdwhaleSdkReactNati
     Log.i(REACT_CLASS_NAME, ".initialize()");
     Activity currentActivity = getCurrentActivity();
     if (currentActivity == null) {
-      promise.reject("NO_ACTIVITY", "Unable to initialize AdWhale SDK: No activity available");
+      WritableMap errorResult = Arguments.createMap();
+      errorResult.putInt("statusCode", -1);
+      errorResult.putString("message", "Unable to initialize AdWhale SDK: No activity available");
+      errorResult.putBoolean("isSuccess", false);
+      promise.resolve(errorResult);
       return;
     }
 
@@ -110,7 +114,11 @@ public class RNAdWhaleMediationAdSettingModule extends NativeAdwhaleSdkReactNati
       @Override
       public void onInitComplete(int statusCode, String message) {
         Log.i(REACT_CLASS_NAME, ".onInitComplete(" + statusCode + ", " + message + ")");
-        promise.resolve(statusCode);
+        WritableMap result = Arguments.createMap();
+        result.putInt("statusCode", statusCode);
+        result.putString("message", message);
+        result.putBoolean("isSuccess", statusCode == 100);
+        promise.resolve(result);
       }
     });
   }

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

@@ -108,21 +108,32 @@ public class RNAdWhaleMediationAdView extends ViewGroupManager<RNWrapperView> {
       if (adView == null) return;
 
       ADWHALE_AD_SIZE adSize = ADWHALE_AD_SIZE.DEFAULT;
-      if ("320x50".equals(adSizeName)) {
+
+      if ("BANNER320x50".equals(adSizeName)) {
         adSize = ADWHALE_AD_SIZE.BANNER320x50;
-      } else if ("320x100".equals(adSizeName)) {
+      } else if ("BANNER320x100".equals(adSizeName)) {
         adSize = ADWHALE_AD_SIZE.BANNER320x100;
-      } else if ("300x250".equals(adSizeName)) {
+      } else if ("BANNER300x250".equals(adSizeName)) {
         adSize = ADWHALE_AD_SIZE.BANNER300x250;
-      } else if ("250x250".equals(adSizeName)) {
+      } else if ("BANNER250x250".equals(adSizeName)) {
         adSize = ADWHALE_AD_SIZE.BANNER250x250;
       } else if ("ADAPTIVE_ANCHOR".equals(adSizeName)) {
         adSize = ADWHALE_AD_SIZE.ADAPTIVE_ANCHOR;
       }
+
       adView.setAdwhaleAdSize(adSize);
       Log.d(REACT_CLASS_NAME, "Ad size set to: " + adSize.name());
     }
 
+    @ReactProp(name = "adaptiveAnchorWidth", defaultInt = 0)
+    public void setAdaptiveAnchorWidth(RNWrapperView view, int width) {
+      AdWhaleMediationAdView adView = getAdWhaleMediationAdView(view);
+      if (adView != null) {
+        adView.setAdaptiveAnchorWidth(width);
+        Log.d(REACT_CLASS_NAME, "Adaptive anchor width set to: " + width);
+      }
+    }
+
     @ReactProp(name = "loadAd")
     public void setLoadAd(RNWrapperView view, boolean loadAd) {
       if (loadAd) {