expo-ads-admob

expo-ads-admob

Provides support for the Google AdMob SDK (https://www.google.com/admob/) for mobile advertising. This module is largely based of the react-native-admob (https://github.com/sbugert/react-native-admob) module, as the documentation and questions surrounding that module may prove helpful. A simple example implementing AdMob SDK can be found at https://github.com/deadcoder0904/expo-google-admob.

API documentation

• Documentation for the master branch
• Documentation for the latest stable release

Installation in managed Expo projects

For managed managed Expo projects, please follow the installation instructions in the API documentation for the latest stable release. If you follow the link and there is no documentation available then this library is not yet usable within managed projects — it is likely to be included in an upcoming Expo SDK release.

Installation in bare React Native projects

For bare React Native projects, you must ensure that you have installed and configured the react-native-unimodules package before continuing.

Add the package to your npm dependencies

expo install expo-ads-admob

Configure for iOS

Run pod install in the ios directory after installing the npm package.

In your app's Info.plist file, add a GADApplicationIdentifier key with a string value of your AdMob app ID, as shown in Google's Mobile Ads SDK iOS docs.

<key>GADApplicationIdentifier</key>
<string>ca-app-pub-3940256099942544~1458002511</string>

Configure for Android

No additional set up necessary.

Contributing

Contributions are very welcome! Please refer to guidelines described in the contributing guide.

Changelog

48.0.0 — 2023-02-09

📚 3rd party library updates

• Updated @stripe/stripe-react-native from 0.19.0 to 0.23.3. (#20964 by @aleqsio, #21117 by @kudo)
• Updated react-native-webview from 11.23.1 to 11.26.0. (#20933 by @aleqsio)
• Updated react-native-gesture-handler from 2.8.0 to 2.9.0. (#20930 by @tsapeta)
• Updated react-native-shared-element from 0.8.4 to 0.8.7. (#20593 by @ijzerenhein)
• Updated @react-native-async-storage/async-storage from 1.17.3 to 1.17.11. (#20780 by @kudo)
• Updated react-native-reanimated from 2.12.0 to 2.14.4. (#20798 by @kudo, #20990 by @tsapeta)
• Updated @shopify/react-native-skia from 0.1.157 to 0.1.172. (#20857, #21014 by @kudo)
• Updated react-native-safe-area-context from 4.4.1 to 4.5.0. (#20899 by @gabrieldonadel)
• Updated react-native-screens from 3.18.0 to 3.20.0. (#20938 by @lukmccall, #21186 by @tsapeta)
• Updated react-native-pager-view from 6.0.1 to 6.1.2. (#20932 by @gabrieldonadel)
• Updated @react-native-community/slider from 4.2.4 to 4.4.2. (#20903 by @gabrieldonadel, #21055 by @kudo)
• Updated react-native-shared-element from 0.8.7 to 0.8.8. (#20929 by @byCedric)
• Updated @react-native-community/datetimepicker from 6.5.2 to 6.7.3. (#20926 by @byCedric)
• Updated @shopify/flash-list from 1.3.1 to 1.4.0. (#20927 by @lukmccall)

🛠 Breaking changes

• expo-contacts
  • Remove deprecated and legacy contact fields constants. (#20269 by @Simek)
• expo-keep-awake
  • KeepAwake.activateKeepAwake has been deprecated in favor of KeepAwake.activateKeepAwakeAsync. (#15826 by @EvanBacon)
• expo-linking
  • Removed the deprecated Linking.removeEventListener. (#20832 by @kudo)

🎉 New features

• expo-apple-authentication
  • Migrated to Expo Modules API and Swift. (#20600 by @tsapeta)
  • Added support for Fabric. (#20600 by @tsapeta)
• expo-av
  • Added PosterComponent prop to Video component. (#19625 by @youedd
• expo-barcode-scanner
  • Native module for barcode scanner view is now written in Swift and Kotlin using the new API. (#20441 and (#20668 by @alanjhughes) (#20441, #20668 by @alanjhughes)
• expo-blur
  • Migrated iOS codebase to Swift and the new Expo modules API. (#19786 by @tsapeta)
• expo-brightness
  • Migrated iOS codebase to use the new Expo modules API. (#20316 by @alanhughes) (#20316 by @alanjhughes)
• expo-constants
  • Migrated Android implementation to Expo Modules API. (#19974 by @alanhughes) (#19974 by @alanjhughes)
• expo-crypto
  • Added a randomUUID method to get a random UUIDv4 string. (#20274 by @aleqsio)
  • Added a getRandomValues method to fill typed arrays. (#20257 by @aleqsio)
  • Ported over getRandomBytes, getRandomBytesAsync methods from expo-random. (#20217 by @aleqsio)
  • Added a digest method to get a cryptographic digest of a typed array. (#20886 by @aleqsio)
• expo-device
  • Migrated Android codebase to use the new Expo modules API. (#20118 by @alanhughes) (#20118 by @alanjhughes)
  • Native module on iOS is now written in Swift using the Sweet API. (#19526 by @fobos531)
• expo-document-picker
  • Migrated to Expo Modules API. (#20336 by @alanhughes) (#20336 by @alanjhughes)
• expo-gl
  • Migrated the view manager to the new Expo modules API and thus added support for Fabric. (#19859 by @tsapeta)
  • Migrated the view manager to the new Expo modules API and thus added support for Fabric on Android. (#20749 by @lukmccall)
• expo-haptics
  • Migrated Android codebase to use the new Expo modules API. (#20016 by @alanhughes) (#20016 by @alanjhughes)
• expo-keep-awake
  • Added web support. (#15826 by @EvanBacon)
  • Added KeepAwake.isAvailableAsync which returns false on certain web browsers. (#15826 by @EvanBacon)
  • Added KeepAwake.addListener to observe state changes on web. (#15826 by @EvanBacon)
• expo-intent-launcher
  • Migrated to Expo Modules API. (#20327 by @alanhughes) (#20327 by @alanjhughes)
• expo-local-authentication
  • Native module on iOS is now written in Swift using the Sweet API. (#19980 by @fobos531)
• expo-image-picker
  • Add support for granular permissions on Android 13. (#20908 by @alanhughes) (#20908 by @alanjhughes)
• expo-media-library
  • Migrated Android codebase to use the new Expo modules API. (#20232 by @alanhughes) (#20232 by @alanjhughes)
  • Add support for granular permissions on Android 13. (#20907 by @alanhughes) (#20907 by @alanjhughes)
• expo-modules-core
  • Added TS definitions for TypedArray and additional union types for Int, Uint and Float TypedArrays. (#20257 by @aleqsio)
  • Added a new executeOnJavaScriptThread method to appContext to allow for running code blocks on the JS thread. (#20161 by @aleqsio)
  • Added the Exceptions.MissingActivity on Android. (#20174 by @lukmccall)
  • Trailing optional arguments can be skipped when calling native functions from JavaScript on iOS. (#20234 by @tsapeta)
  • Events component can now be initialized with an array of event names (not only variadic arguments). (#20590 by @tsapeta)
  • Property component can now take the native shared object instance as the first argument. (#20608 by @tsapeta)
  • Added support for referencing to Property's owner properties using Swift key paths. (#20610 by @tsapeta)
  • Added support for concurrent (async/await) functions in Swift. (#20645 by @tsapeta)
  • [iOS] Added experimental support for building the function result from the object definition. (#20623 by @tsapeta)
  • View-related DSL functions do not require providing the view's type in function parameters on Android. (#20751 by @lukmccall)
  • Add support for the Long type as function parameters on Android. (#20787 by @lukmccall)
  • [Android] Added experimental support for building the function result from the object definition. (#20864 by @lukmccall)
  • Removed boost dependency which needs extra downloading on Android. (#21000 by @kudo)
• expo-network
  • Migrated to Expo Modules API. (#20083 and #20303 by @alanhughes) (#20083, #20303 by @alanjhughes)
• expo-sharing
  • Migrated Android implementation to Expo Modules API. (#20112 by @alanhughes) (#20112 by @alanjhughes)
• expo-sms
  • Migrated to Expo Modules API. (#19996 and (#19967 by @alanhughes) (#19996, #19967 by @alanjhughes)
• expo-store-review
  • Migrated Android implementation to Expo Modules API. (#19898 by @alanhughes) (#19898 by @alanjhughes)
• expo-speech
  • Added utterance word tracking support for iOS and Android. This allows the ability to highlight each word in an utterance. (#20726 by @gabrieljoelc)
• expo-video-thumbnails
  • Native module on iOS is now written in Swift using the Sweet API. (#19561 by @fobos531)
  • Migrated Android codebase to use the new Expo modules API. (#20541 by @alanhughes) (#20541 by @alanjhughes)

🐛 Bug fixes

• expo-asset
  • Fix loading Metro web assets from origins other than /. (#20258 by @EvanBacon)
• expo-av
  • Fixed error for duplicated META-INF files when building on Android. (#20251 by @kudo)
  • Fixed build errors when testing on React Native nightly builds. (#19805 by @kudo)
  • Fixed crashes when ProGuard or R8 is enabled on Android. (#20197 by @lukmccall)
  • Added React Native 0.71 support. (#20470 by @kudo)
  • Fixed HTMLMediaElement.play and HTMLMediaElement.pause calls on the Web aren't properly awaited. (#20439) by @zhigang1992 (#20439 by @zhigang1992)
  • Added support for React Native 0.71.x. (#20799 #20832 by @kudo) (#20799, #20832 by @kudo)
  • Fixed JSI audio sampling buffer issues when using SimpleExoPlayer implementation on Android. (#21055 by @kudo)
• expo-barcode-scanner
  • Fix import issue on case-sensitive file systems (#20141 by @hirbod)
• expo-blur
  • Add -webkit-backdrop-filter to support blurring on Safari. (#21003 by @EvanBacon)
• expo-clipboard
  • Fixed clipboard listener is called twice on Android. (#19723 by @lukmccall)
  • Fixed clipboard listener can crash the application during initialization on Android. (#19723 by @lukmccall)
  • Fixed the ImageFormat or the StringFormat not working in the release builds on Android. (#20155 by @lukmccall)
• expo-constants
  • Fix the list of platform keys in expo-module.config.json (#20017 by @alanjhughes)
• expo-camera
  • Fix import issue on case-sensitive file systems (#20141 by @hirbod)
  • Fix path where simulator saves photos (#20872 by @pettomartino)
  • Fixed Cannot set prop 'barCodeScannerSettings' on view 'class expo.modules.camera.ExpoCameraView' on Android. (#21033 by @lukmccall)
• expo-file-system
  • Add utf-8 uri support on iOS. (#21098 by @gabrieldonadel)
• expo-gl
  • Fixed build errors when testing on React Native nightly builds. (#19805 by @kudo)
  • Fixed error for duplicated META-INF files when building on Android. (#20251 by @kudo)
  • Added React Native 0.71 support. (#20470 by @kudo)
• expo-haptics
  • Fixed rare crash on iOS when using Feedback Generator's API not on the main thread. (#19819 by @AntonGolikov)
• expo-image-picker
  • Fix incorrect asset type for videos on iOS. (#19932 by @tsapeta)
  • Fix support for animated GIFs on iOS. (#20034 by @barthap)
• expo-mail-composer
  • Fix composeAsync not resolving promise after sending/ discarding email. (#20869 by @keith-kurak)
• expo-media-library
  • Renamed the module on iOS to match the name used on Android. (#20283 by @alanhughes) (#20283 by @alanjhughes)
• expo-modules-core
  • Added a list of the acceptable enum values to the conversion error on Android. (#19895 by @lukmccall)
  • Fixed new NativeEventEmitter() was called with a non-null argument without the required addListener method. warnings on Android with JSC. (#19920 by @kudo)
  • Fixed views are not correctly initialized after reloading on Android. (#20063 by @lukmccall)
  • Fixed threading crash issue when running with Hermes on iOS. (#20506 by @kudo)
  • Fixed build errors when testing on React Native nightly builds. (#19805 by @kudo)
  • Fixed failed resolution of 'java.nio.file.Path' on Android. (#20037 by @lukmccall)
  • Fixed libraries using the ViewDefinitionBuilder crashes when ProGuard or R8 is enabled on Android. (#20197 by @lukmccall)
  • Fixed Either types not supporting non-primitive types on iOS. (#20247 by @tsapeta)
  • Fixed Function not supporting certain arities on Android. (#20419 by @motiz88)
  • Added React Native 0.71 support. (#20470 by @kudo)
  • Fixed the SharedObject initializer being inaccessible due to internal protection level. (#20588 by @tsapeta)
  • Fixed boost build error on Android. (#20719 by @kudo)
  • Fix view prop setter not being called when its new value is null or undefined. (#20755 & #20766 by @tsapeta & @lukmccall) (#20755, #20766 by @tsapeta, @lukmccall)
  • Fixed "Tried to register two views with the same name" error on fast refresh. (#20788 by @tsapeta)
  • Fix crash when reloading app while expo-av video is playing. (#21118 by @janicduplessis)
• expo-location
  • Removed strict null checks for expo location and avoid crash on android. (#20792 by @jayshah123 and @forki) (#20792 by @jayshah123, @forki)
  • Export types with type-only annotation to fix build when using isolatedModules flag. (#20239 by @zakharchenkoAndrii)
• expo-print
  • Fix printAsync not reflecting custom width/ height, useMarkupFormatter option preventing custom width/ height/ margin from being reflected. (#18873 by @keith-kurak) (#20046 by)
• expo-sensors
  • Export types with type-only annotation to fix build when using isolatedModules flag. (#20239 by @zakharchenkoAndrii)
• expo-web-browser
  • Add missing peer dependency on url for web. (#20708 by @EvanBacon)

💡 Others

• expo-asset
  • Remove unused web features. (#20258 by @EvanBacon)
• expo-application
  • On Android bump compileSdkVersion and targetSdkVersion to 33. (#20721 by @lukmccall)
• expo-auth-session
  • Removed usage of the deprecated expo-random package. (#21063 by @lukmccall)
• expo-background-fetch
  • On Android bump compileSdkVersion and targetSdkVersion to 33. (#20721 by @lukmccall)
• expo-av
  • On Android bump compileSdkVersion and targetSdkVersion to 33. (#20721 by @lukmccall)
• expo-barcode-scanner
  • On Android bump compileSdkVersion and targetSdkVersion to 33. (#20721 by @lukmccall)
• expo-branch
  • On Android bump compileSdkVersion and targetSdkVersion to 33. (#20721 by @lukmccall)
• expo-brightness
  • Deprecate useSystemBrightnessAsync and add it as renamed restoreSystemBrightnessAsync method to avoid violating Rules of Hooks. (#19701 by @Simek)
  • On Android bump compileSdkVersion and targetSdkVersion to 33. (#20721 by @lukmccall)
• expo-cellular
  • On Android bump compileSdkVersion and targetSdkVersion to 33. (#20721 by @lukmccall)
• expo-calendar
  • On Android bump compileSdkVersion and targetSdkVersion to 33. (#20721 by @lukmccall)
• expo-clipboard
  • On Android bump compileSdkVersion and targetSdkVersion to 33. (#20721 by @lukmccall)
• expo-constants
  • On Android bump compileSdkVersion and targetSdkVersion to 33. (#20721 by @lukmccall)
• expo-contacts
  • Simplify exported types. (#20269 by @Simek)
  • On Android bump compileSdkVersion and targetSdkVersion to 33. (#20721 by @lukmccall)
• expo-crypto
  • On Android bump compileSdkVersion and targetSdkVersion to 33. (#20721 by @lukmccall)
• expo-battery
  • On Android bump compileSdkVersion and targetSdkVersion to 33. (#20721 by @lukmccall)
• expo-device
  • On Android bump compileSdkVersion and targetSdkVersion to 33. (#20721 by @lukmccall)
• expo-document-picker
  • Avoid dependency on uuid. (#20477 by @LinusU)
  • On Android bump compileSdkVersion and targetSdkVersion to 33. (#20721 by @lukmccall)
• expo-camera
  • Use correct type for videoStabilizationMode option. (#20130 by @simek)
  • On Android bump compileSdkVersion and targetSdkVersion to 33. (#20721 by @lukmccall)
• expo-error-recovery
  • On Android bump compileSdkVersion and targetSdkVersion to 33. (#20721 by @lukmccall)
• expo-file-system
  • Extract nested object definitions to the separate types, which adds: DeletingOptions, InfoOptions, RelocatingOptions and MakeDirectoryOptions types. (#20103 by @Simek)
  • Simplify the way in which types are exported from the package. (#20103 by @Simek)
  • Rename UploadProgressData totalByteSent field to totalBytesSent. (#20804 by @gabrieldonadel)
  • On Android bump compileSdkVersion and targetSdkVersion to 33. (#20721 by @lukmccall)
• expo-font
  • On Android bump compileSdkVersion and targetSdkVersion to 33. (#20721 by @lukmccall)
• expo-face-detector
  • On Android bump compileSdkVersion and targetSdkVersion to 33. (#20721 by @lukmccall)
• expo-gl
  • On Android bump compileSdkVersion and targetSdkVersion to 33. (#20721 by @lukmccall)
• expo-haptics
  • On Android bump compileSdkVersion and targetSdkVersion to 33. (#20721 by @lukmccall)
• expo-image-manipulator
  • On Android bump compileSdkVersion and targetSdkVersion to 33. (#20721 by @lukmccall)
• expo-image-loader
  • On Android bump compileSdkVersion and targetSdkVersion to 33. (#20721 by @lukmccall)
• expo-keep-awake
  • Define KeepAwakeOptions type, update the doc comments. (#20489 by @Simek)
  • On Android bump compileSdkVersion and targetSdkVersion to 33. (#20721 by @lukmccall)
• expo-linear-gradient
  • On Android bump compileSdkVersion and targetSdkVersion to 33. (#20721 by @lukmccall)
• expo-intent-launcher
  • On Android bump compileSdkVersion and targetSdkVersion to 33. (#20721 by @lukmccall)
• expo-local-authentication
  • On Android bump compileSdkVersion and targetSdkVersion to 33. (#20721 by @lukmccall)
• expo-linking
  • Fix link in README that was incorrectly pointing to to expo-asset. (#20616 by @stereoplegic)
• expo-image-picker
  • Avoid dependency on uuid. (#20476 by @LinusU)
  • On Android bump compileSdkVersion and targetSdkVersion to 33. (#20721 by @lukmccall)
• expo-localization
  • On Android bump compileSdkVersion and targetSdkVersion to 33. (#20721 by @lukmccall)
• expo-mail-composer
  • On Android bump compileSdkVersion and targetSdkVersion to 33. (#20721 by @lukmccall)
• expo-media-library
  • On Android bump compileSdkVersion and targetSdkVersion to 33. (#20721 by @lukmccall)
• expo-modules-core
  • Exposed coroutines related packages on Android. (#19896 by @lukmccall)
  • Rephrased the message of ArgumentCastException to use ordinal numbers. (#19912 by @tsapeta)
  • [iOS] Make Enumerable protocol implement CaseIterable to get rid of operating on unsafe pointers. (#20640 by @tsapeta)
  • On Android bump compileSdkVersion and targetSdkVersion to 33. (#20721 by @lukmccall)
• expo-location
  • On Android bump compileSdkVersion and targetSdkVersion to 33. (#20721 by @lukmccall)
• expo-network
  • On Android bump compileSdkVersion and targetSdkVersion to 33. (#20721 by @lukmccall)
• expo-print
  • On Android bump compileSdkVersion and targetSdkVersion to 33. (#20721 by @lukmccall)
• expo-random
  • On Android bump compileSdkVersion and targetSdkVersion to 33. (#20721 by @lukmccall)
• expo-permissions
  • On Android bump compileSdkVersion and targetSdkVersion to 33. (#20721 by @lukmccall)
• expo-screen-capture
  • On Android bump compileSdkVersion and targetSdkVersion to 33. (#20721 by @lukmccall)
• expo-notifications
  • Update getExpoPushTokenAsync to make projectId required. (#20833 by @gabrieldonadel)
  • On Android bump compileSdkVersion and targetSdkVersion to 33. (#20721 by @lukmccall)
  • Add JSDoc comments, perform type changes related to documentation autogeneration. (#21002 by @Simek)
  • Export getExpoPushTokenAsync parameter type. (#21104 by @Simek)
• expo-sharing
  • On Android bump compileSdkVersion and targetSdkVersion to 33. (#20721 by @lukmccall)
• expo-screen-orientation
  • On Android bump compileSdkVersion and targetSdkVersion to 33. (#20721 by @lukmccall)
• expo-sms
  • On Android bump compileSdkVersion and targetSdkVersion to 33. (#20721 by @lukmccall)
• expo-sensors
  • On Android bump compileSdkVersion and targetSdkVersion to 33. (#20721 by @lukmccall)
• expo-store-review
  • On Android bump compileSdkVersion and targetSdkVersion to 33. (#20721 by @lukmccall)
• expo-secure-store
  • On Android bump compileSdkVersion and targetSdkVersion to 33. (#20721 by @lukmccall)
• expo-speech
  • On Android bump compileSdkVersion and targetSdkVersion to 33. (#20721 by @lukmccall)
• expo-sqlite
  • On Android bump compileSdkVersion and targetSdkVersion to 33. (#20721 by @lukmccall)
• expo-task-manager
  • On Android bump compileSdkVersion and targetSdkVersion to 33. (#20721 by @lukmccall)
• expo-video-thumbnails
  • On Android bump compileSdkVersion and targetSdkVersion to 33. (#20721 by @lukmccall)
• expo-web-browser
  • On Android bump compileSdkVersion and targetSdkVersion to 33. (#20721 by @lukmccall)
• unimodules-app-loader
  • On Android bump compileSdkVersion and targetSdkVersion to 33. (#20721 by @lukmccall)

⚠️ Notices

• expo-image-picker
  • Removed deprecated fields from pick result type and deprecated UIImagePickerPresentationStyle enum values. (#21078 by @Simek)
• expo-random
  • Deprecate the library in favor of expo-crypto. (#20217 by @aleqsio)