react-native-applovin-max 8.0.5 → 8.1.1

package/react-native-applovin-max.podspec

@@ -1,7 +1,6 @@
 require "json"
 
 package = JSON.parse(File.read(File.join(__dir__, "package.json")))
-folly_compiler_flags = '-DFOLLY_NO_CONFIG -DFOLLY_MOBILE=1 -DFOLLY_USE_LIBCPP=1 -Wno-comma -Wno-shorten-64-to-32'
 
 Pod::Spec.new do |s|
   s.name         = "react-native-applovin-max"
@@ -12,7 +11,7 @@ Pod::Spec.new do |s|
   s.authors      = package["author"]
 
   s.platforms    = { :ios => min_ios_version_supported }
-  s.source       = { :git => "https://github.com/AppLovin/AppLovin-MAX-React-Native.git", :tag => "release_8_0_5" }
+  s.source       = { :git => "https://github.com/AppLovin/AppLovin-MAX-React-Native.git", :tag => "release_8_1_1" }
 
   s.source_files = "ios/AppLovinMAX*.{h,m}"
 
@@ -23,10 +22,12 @@ Pod::Spec.new do |s|
   if respond_to?(:install_modules_dependencies, true)
     install_modules_dependencies(s)
   else
-  s.dependency "React-Core"
+    s.dependency "React-Core"
 
   # Don't install the dependencies when we run `pod install` in the old architecture.
   if ENV['RCT_NEW_ARCH_ENABLED'] == '1' then
+    folly_compiler_flags = '-DFOLLY_NO_CONFIG -DFOLLY_MOBILE=1 -DFOLLY_USE_LIBCPP=1 -Wno-comma -Wno-shorten-64-to-32'
+
     s.compiler_flags = folly_compiler_flags + " -DRCT_NEW_ARCH_ENABLED=1"
     s.pod_target_xcconfig    = {
         "HEADER_SEARCH_PATHS" => "\"$(PODS_ROOT)/boost\"",

package/src/AdView.tsx

@@ -4,7 +4,7 @@ import { NativeModules, requireNativeComponent, StyleSheet, UIManager, findNodeH
 import type { ViewProps, ViewStyle, StyleProp, NativeMethods, DimensionValue } from 'react-native';
 import type { AdDisplayFailedInfo, AdInfo, AdLoadFailedInfo, AdRevenueInfo } from './types/AdInfo';
 import type { AdNativeEvent } from './types/AdEvent';
-import type { AdViewProps, AdViewHandler, NativeUIComponentAdViewOptions } from './types/AdViewProps';
+import type { AdViewProps, AdViewHandler, NativeUIComponentAdViewOptions, AdViewId } from './types/AdViewProps';
 import { addEventListener, removeEventListener } from './EventEmitter';
 
 const { AppLovinMAX } = NativeModules;
@@ -109,11 +109,16 @@ const sizeBannerDimensions = async (sizeProps: SizeRecord, adaptiveBannerEnabled
 };
 
 /**
- * The {@link AdView} component that you use for building a banner or an MREC. Phones
- * size banners to 320x50 and MRECs to 300x250. Tablets size banners to 728x90 and MRECs to
- * 300x250. You may use the utility method {@link AppLovinMAX.isTablet()} to help with view sizing
- * adjustments. For adaptive banners, call {@link BannerAd.getAdaptiveHeightForWidth()} to get
- * the banner height, and then adjust your content accordingly.
+ * The {@link AdView} component renders banner or MREC ads with responsive sizing.
+ * - **Banners**: 320x50 on phones, 728x90 on tablets.
+ * - **MRECs**: 300x250 on all devices.
+ *
+ * Use {@link AppLovinMAX.isTablet()} to determine device type for layout adjustments.
+ * For adaptive banners, use {@link BannerAd.getAdaptiveHeightForWidth()} for precise sizing.
+ *
+ * **Preloading**:
+ * When preloading an {@link AdView} using {@link preloadNativeUIComponentAdView},
+ * the returned {@link AdViewId} must be passed to identify the preloaded instance.
  *
  * ### Example:
  * ```js
@@ -135,6 +140,7 @@ export const AdView = forwardRef<AdViewHandler, AdViewProps & ViewProps>(functio
     {
         adUnitId,
         adFormat,
+        adViewId,
         placement,
         customData,
         adaptiveBannerEnabled = true,
@@ -282,6 +288,7 @@ export const AdView = forwardRef<AdViewHandler, AdViewProps & ViewProps>(functio
             ref={saveElement}
             adUnitId={adUnitId}
             adFormat={adFormat}
+            adViewId={adViewId || 0}
             placement={placement}
             customData={customData}
             adaptiveBannerEnabled={adaptiveBannerEnabled}
@@ -303,38 +310,33 @@ export const AdView = forwardRef<AdViewHandler, AdViewProps & ViewProps>(functio
 });
 
 /**
- * Preloads a native UI component for {@link AdView}. When you mount {@link AdView} with the Ad Unit
- * ID you preloaded, it will be constructed with the preloaded native UI component, allowing the ads
- * to be displayed quickly. When you unmount {@link AdView}, the preloaded native UI component won't
- * be destroyed. Instead, it will be reused for the next mount. You must manually destroy it when it
- * is no longer needed.
+ * Preloads a native UI component for {@link AdView}, enabling faster ad display on first mount.
  *
- * You can preload only one native UI component for a single Ad Unit ID. If you mount two of
- * {@link AdView} with the same Ad Unit ID, the first {@link AdView} will be constructed with the
- * preloaded native UI component, but the second {@link AdView} will create its own native UI
- * component and destroy it when unmounting.
+ * - When you mount {@link AdView} with the preloaded Ad Unit ID, it uses the preloaded native UI component.
+ * - Unmounting {@link AdView} does not destroy the preloaded component—it will be reused on the next mount.
+ * - You must manually destroy the preloaded component when it is no longer needed using {@link destroyNativeUIComponentAdView}.
  *
- * @param adUnitId The Ad Unit ID to load ads for.
- * @param adFormat An enum value representing the ad format to load ads for. Should be either
- * {@link AdFormat.BANNER} or {@link AdFormat.MREC}.
- * @param options Optional props used to construct a native UI component.
- * @returns A promise that resolves when preload starts. The resolved object contains void.
- * @throws Throws an error if the request fails.
+ * @param adUnitId - The Ad Unit ID for which the ads should be preloaded.
+ * @param adFormat - The ad format to preload. Must be either {@link AdFormat.BANNER} or {@link AdFormat.MREC}.
+ * @param options - Optional properties to configure the native UI component (e.g., placement, custom data).
+ * @returns A promise resolving to an {@link AdViewId}, which uniquely identifies the preloaded component.
+ * @throws An error if the preload request fails.
  */
-export const preloadNativeUIComponentAdView = async (adUnitId: string, adFormat: AdFormat, options?: NativeUIComponentAdViewOptions): Promise<void> => {
+export const preloadNativeUIComponentAdView = async (adUnitId: string, adFormat: AdFormat, options?: NativeUIComponentAdViewOptions): Promise<AdViewId> => {
     return AppLovinMAX.preloadNativeUIComponentAdView(adUnitId, adFormat, options?.placement, options?.customData, options?.extraParameters, options?.localExtraParameters);
 };
 
 /**
- * Destroys the native UI component.
+ * Destroys a preloaded native UI component identified by its {@link AdViewId}.
+ *
+ * - This method should be called when the preloaded component is no longer needed to free resources.
  *
- * @param adUnitId The ad unit ID of the native UI component to destroy.
- * @returns A promise that resolves upon the destruction of the native UI component. The resolved
- * object contains void.
- * @throws Throws an error if the request fails.
+ * @param adViewId - The {@link AdViewId} of the native UI component to be destroyed.
+ * @returns A promise that resolves when the native UI component is successfully destroyed.
+ * @throws An error if the destruction process fails.
  */
-export const destroyNativeUIComponentAdView = async (adUnitId: string): Promise<void> => {
-    return AppLovinMAX.destroyNativeUIComponentAdView(adUnitId);
+export const destroyNativeUIComponentAdView = async (adViewId: AdViewId): Promise<void> => {
+    return AppLovinMAX.destroyNativeUIComponentAdView(adViewId);
 };
 
 /**

package/src/AppLovinMAX.ts

@@ -4,7 +4,7 @@ import type { Configuration } from './types/Configuration';
 
 const NativeAppLovinMAX = NativeModules.AppLovinMAX;
 
-const VERSION = '8.0.5';
+const VERSION = '8.1.1';
 
 /**
  * This enum represents the user's geography used to determine the type of consent flow shown to the
@@ -115,10 +115,15 @@ type NativeAppLovinMAXType = Omit<AppLovinMAXType, 'initialize' | 'getSegments'>
 
 const nativeMethods: NativeAppLovinMAXType = NativeAppLovinMAX;
 
-export const AppLovinMAX: AppLovinMAXType = {
-    ...nativeMethods,
-    initialize,
-    getSegments,
-};
+export const AppLovinMAX: AppLovinMAXType = Object.create(nativeMethods, {
+    initialize: {
+        value: initialize,
+        enumerable: true,
+    },
+    getSegments: {
+        value: getSegments,
+        enumerable: true,
+    },
+});
 
 export default AppLovinMAX;

package/src/ErrorCode.ts

@@ -13,8 +13,6 @@ const {
     MAX_ERROR_CODE_FULLSCREEN_AD_ALREADY_SHOWING,
     MAX_ERROR_CODE_FULLSCREEN_AD_NOT_READY,
     MAX_ERROR_CODE_FULLSCREEN_AD_INVALID_VIEW_CONTROLLER,
-    MAX_ERROR_CODE_FULLSCREEN_AD_ALREADY_LOADING,
-    MAX_ERROR_CODE_FULLSCREEN_AD_LOAD_WHILE_SHOWING,
     MAX_ERROR_CODE_DONT_KEEP_ACTIVITIES_ENABLED,
     MAX_ERROR_CODE_INVALID_AD_UNIT_ID,
 } = AppLovinMAX.getConstants();
@@ -83,18 +81,6 @@ export enum ErrorCode {
      */
     FULLSCREEN_AD_INVALID_VIEW_CONTROLLER = MAX_ERROR_CODE_FULLSCREEN_AD_INVALID_VIEW_CONTROLLER,
 
-    /**
-     * This error code indicates you are attempting to load a fullscreen ad while another
-     * fullscreen ad is already loading.
-     */
-    FULLSCREEN_AD_ALREADY_LOADING = MAX_ERROR_CODE_FULLSCREEN_AD_ALREADY_LOADING,
-
-    /**
-     * This error code indicates you are attempting to load a fullscreen ad while another fullscreen ad
-     * is still showing.
-     */
-    FULLSCREEN_AD_LOAD_WHILE_SHOWING = MAX_ERROR_CODE_FULLSCREEN_AD_LOAD_WHILE_SHOWING,
-
     /**
      * This error code indicates that the SDK failed to display an ad because the user has the
      * "Don't Keep Activities" developer setting enabled.

package/src/nativeAd/NativeAdView.tsx

@@ -95,13 +95,12 @@ const NativeAdViewImpl = forwardRef<NativeAdViewHandler, NativeAdViewProps & Vie
 
     // Load a new ad
     const loadAd = useCallback(() => {
-        if (nativeAdViewRef.current) {
-            UIManager.dispatchViewManagerCommand(
-                findNodeHandle(nativeAdViewRef.current),
-                // @ts-ignore: Issue in RN ts defs
-                UIManager.getViewManagerConfig('AppLovinMAXNativeAdView').Commands.loadAd,
-                undefined
-            );
+        const nativeAdView = nativeAdViewRef.current;
+        if (nativeAdView) {
+            const viewManagerConfig = UIManager.getViewManagerConfig('AppLovinMAXNativeAdView');
+            if (viewManagerConfig?.Commands && typeof viewManagerConfig.Commands.loadAd === 'number') {
+                UIManager.dispatchViewManagerCommand(findNodeHandle(nativeAdView), viewManagerConfig.Commands.loadAd, []);
+            }
         }
     }, []);
 

package/src/types/AdInfo.ts

@@ -1,4 +1,5 @@
 import type { ErrorCode } from '../ErrorCode';
+import type { AdViewId } from './AdViewProps';
 
 /**
  * Represents an ad that has been served by AppLovin MAX.
@@ -9,6 +10,11 @@ export type AdInfo = {
      */
     adUnitId: string;
 
+    /**
+     * The unique ID of the native UI component AdView.
+     */
+    adViewId?: AdViewId;
+
     /**
      * The creative ID tied to the ad, if any. You can report creative issues to the corresponding
      * ad network using this ID.
@@ -69,6 +75,11 @@ export type AdLoadFailedInfo = {
      */
     adUnitId: string;
 
+    /**
+     * The unique ID of the native UI component AdView.
+     */
+    adViewId?: AdViewId;
+
     /**
      * The error code for the error.
      */

package/src/types/AdViewProps.ts

@@ -12,40 +12,58 @@ export type AdViewHandler = {
     loadAd(): void;
 };
 
+/**
+ * A unique identifier for referencing a specific AdView instance.
+ *
+ * - If the value is a number, it represents the ID of a preloaded or assigned AdView.
+ * - A value of `undefined` indicates that the AdView has not been preloaded or assigned an ID yet.
+ */
+export type AdViewId = number | undefined;
+
 /**
  * Represents an {@link AdView} - Banner / MREC.
  */
 export type AdViewProps = AdProps & {
     /**
-     * An enum value representing the ad format to load ads for. Should be either
+     * An enum value representing the ad format to load ads for. Must be either
      * {@link AdFormat.BANNER} or {@link AdFormat.MREC}.
      */
     adFormat: AdFormat;
 
     /**
-     * A boolean value representing whether or not to enable adaptive banners.
+     * A unique identifier representing the AdView instance.
+     * Used to manage and track the specific AdView.
+     */
+    adViewId?: AdViewId;
+
+    /**
+     * A boolean indicating whether adaptive banners are enabled.
      */
     adaptiveBannerEnabled?: boolean;
 
     /**
-     * A boolean value representing whether or not to enable auto-refresh. Note that auto-refresh is
-     * enabled by default.
+     * A boolean indicating whether auto-refresh is enabled.
+     * Auto-refresh is enabled by default.
      */
     autoRefresh?: boolean;
 
     /**
-     * A boolean value representing whether or not to load an ad as soon as {@link AdView} is
-     * mounted. Note that the default value is true.
+     * A boolean indicating whether an ad should load automatically
+     * when the {@link AdView} is mounted. Defaults to `true`.
      */
     loadOnMount?: boolean;
 
     /**
-     * A callback fuction that {@link AdView} fires when it expands the ad.
+     * A callback function triggered when the {@link AdView} expands the ad.
+     *
+     * @param adInfo - Information about the ad that was expanded.
      */
     onAdExpanded?: (adInfo: AdInfo) => void;
 
     /**
-     * A callback fuction that {@link AdView} fires when it collapses the ad.
+     * A callback function triggered when the {@link AdView} collapses the ad.
+     *
+     * @param adInfo - Information about the ad that was collapsed.
      */
     onAdCollapsed?: (adInfo: AdInfo) => void;
 };