react-native-google-mobile-ads 14.4.1 → 14.4.3

package/README.md

@@ -31,19 +31,24 @@ React Native Google Mobile Ads is built with three key principals in mind;
   - full reference & installation documentation alongside detailed guides and FAQs
 
 ## Migrating to the New Architecture Status (backwards compatible)
+
 This package can be used in both The Old and [The New Architecture](https://reactnative.dev/docs/the-new-architecture/landing-page).
 When using The New Architecture, some legacy code will still be used though. See status below:
 
-- **iOS**
-  - Mobile Ads SDK Methods (Turbo Native Module) 🟢🟢🟢🟢
-  - Banners (Fabric Native Component) 🟢🟢🟢🟢
-  - Full Screen Ads (Turbo Native Module) ⚪⚪⚪⚪
-  - User Messaging Platform (Turbo Native Module) ⚪⚪⚪⚪
-- **Android**
-  - Mobile Ads SDK Methods (Turbo Native Module) ⚪⚪⚪⚪
-  - Banners (Fabric Native Component) ⚪⚪⚪⚪
-  - Full Screen Ads (Turbo Native Module) ⚪⚪⚪⚪
-  - User Messaging Platform (Turbo Native Module) ⚪⚪⚪⚪
+| Platform | Feature                                           | Status      |
+| -------- | ------------------------------------------------- | ----------- |
+| iOS      | Mobile Ads SDK Methods (Turbo Native Module)      | ✅ Complete |
+| iOS      | Banners (Fabric Native Component)                 | ✅ Complete |
+| iOS      | Full Screen Ads (Turbo Native Module)             | ⏳ To-Do    |
+| iOS      | User Messaging Platform (Turbo Native Module)     | ⏳ To-Do    |
+| iOS      | EventEmitter (Turbo Native Module)                | ⏳ To-Do    |
+| iOS      | Revenue Precision Constants (Turbo Native Module) | ⏳ To-Do    |
+| Android  | Mobile Ads SDK Methods (Turbo Native Module)      | ⏳ To-Do    |
+| Android  | Banners (Fabric Native Component)                 | ⏳ To-Do    |
+| Android  | Full Screen Ads (Turbo Native Module)             | ⏳ To-Do    |
+| Android  | User Messaging Platform (Turbo Native Module)     | ⏳ To-Do    |
+| Android  | EventEmitter (Turbo Native Module)                | ⏳ To-Do    |
+| Android  | Revenue Precision Constants (Turbo Native Module) | ⏳ To-Do    |
 
 ## Documentation
 

package/android/src/main/AndroidManifest.xml

@@ -1,5 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:tools="http://schemas.android.com/tools"
     package="io.invertase.googlemobileads">
 
     <uses-permission android:name="android.permission.INTERNET" />
@@ -19,5 +20,26 @@
       <meta-data
         android:name="com.google.android.gms.ads.flag.OPTIMIZE_AD_LOADING"
         android:value="${appJSONGoogleMobileAdsOptimizeAdLoading}"/>
+
+      <!-- This may generate a warning during your build:
+
+           > property#android.adservices.AD_SERVICES_CONFIG@android:resource
+           > was tagged at AndroidManifest.xml:23 to replace other declarations
+           > but no other declaration present
+
+           You may safely ignore this warning.
+
+           We must include this in case you also use Firebase Analytics in some
+           of its configurations, as it may also include this file, and the two
+           will collide and cause a build error if we don't set this one to take
+           priority via replacement.
+
+           https://github.com/invertase/react-native-google-mobile-ads/issues/657
+
+      -->
+      <property
+        android:name="android.adservices.AD_SERVICES_CONFIG"
+        android:resource="@xml/gma_ad_services_config"
+        tools:replace="android:resource" />
     </application>
 </manifest>

package/android/src/main/java/io/invertase/googlemobileads/ReactNativeGoogleMobileAdsModule.kt

@@ -95,7 +95,12 @@ class ReactNativeGoogleMobileAdsModule(
   @ReactMethod
   fun initialize(promise: Promise) {
     MobileAds.initialize(
-      reactApplicationContext,
+      // in react-native, the Activity instance *may* go away, becoming null after initialize
+      // it is not clear if that can happen here without an initialize necessarily following the Activity lifecycle
+      // it is not clear if that will cause problems even if it happens, but users that have widely deployed this
+      // with the use of currentActivity have not seen problems
+      // reference if it needs attention: https://github.com/invertase/react-native-google-mobile-ads/pull/664
+      currentActivity ?: reactApplicationContext,
       OnInitializationCompleteListener { initializationStatus ->
         val result = Arguments.createArray()
         for ((key, value) in initializationStatus.adapterStatusMap) {

package/docs/displaying-ads.mdx

@@ -91,7 +91,7 @@ To listen to events, such as when the advert from the network has loaded or when
 
 ```jsx
 import React, { useEffect, useState } from 'react';
-import { Button } from 'react-native';
+import { Button, Platform, StatusBar } from 'react-native';
 import { InterstitialAd, AdEventType, TestIds } from 'react-native-google-mobile-ads';
 
 const adUnitId = __DEV__ ? TestIds.INTERSTITIAL : 'ca-app-pub-xxxxxxxxxxxxx/yyyyyyyyyyyyyy';
@@ -104,15 +104,32 @@ function App() {
   const [loaded, setLoaded] = useState(false);
 
   useEffect(() => {
-    const unsubscribe = interstitial.addAdEventListener(AdEventType.LOADED, () => {
+    const unsubscribeLoaded = interstitial.addAdEventListener(AdEventType.LOADED, () => {
       setLoaded(true);
     });
 
+    const unsubscribeOpened = interstitial.addAdEventListener(AdEventType.OPENED, () => {
+      if (Platform.OS === 'ios') {
+        // Prevent the close button from being unreachable by hiding the status bar on iOS
+        StatusBar.setHidden(true)
+      }
+    });
+
+    const unsubscribeClosed = interstitial.addAdEventListener(AdEventType.CLOSED, () => {
+      if (Platform.OS === 'ios') {
+        StatusBar.setHidden(false)
+      }
+    });
+
     // Start loading the interstitial straight away
     interstitial.load();
 
     // Unsubscribe from events on unmount
-    return unsubscribe;
+    return () => {
+      unsubscribeLoaded();
+      unsubscribeOpened();
+      unsubscribeClosed();
+    };
   }, []);
 
   // No advert ready to show yet

package/lib/commonjs/version.js

@@ -5,5 +5,5 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.version = void 0;
 // Generated by genversion.
-const version = exports.version = '14.4.1';
+const version = exports.version = '14.4.3';
 //# sourceMappingURL=version.js.map

package/lib/module/version.js

@@ -1,3 +1,3 @@
 // Generated by genversion.
-export const version = '14.4.1';
+export const version = '14.4.3';
 //# sourceMappingURL=version.js.map

package/lib/typescript/index.d.ts

@@ -1,4 +1,4 @@
-export declare const SDK_VERSION = "14.4.1";
+export declare const SDK_VERSION = "14.4.3";
 export { default, MobileAds } from './MobileAds';
 export { AdsConsentDebugGeography } from './AdsConsentDebugGeography';
 export { AdsConsentPurposes } from './AdsConsentPurposes';

package/lib/typescript/version.d.ts

@@ -1,2 +1,2 @@
-export declare const version = "14.4.1";
+export declare const version = "14.4.3";
 //# sourceMappingURL=version.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-google-mobile-ads",
-  "version": "14.4.1",
+  "version": "14.4.3",
   "author": "Invertase <oss@invertase.io> (http://invertase.io)",
   "description": "React Native Google Mobile Ads is an easy way to monetize mobile apps with targeted, in-app advertising.",
   "main": "lib/commonjs/index.js",

package/src/version.ts

@@ -1,2 +1,2 @@
 // Generated by genversion.
-export const version = '14.4.1';
+export const version = '14.4.3';