Об этом проекте

React Native Google Mobile Ads — это библиотека от Invertase, позволяющая приложениям на React Native и Expo монетизироваться через Google AdMob или Google Ad Manager. Она оборачивает нативные SDK Google Mobile Ads для iOS и Android, а не переписывает показ рекламы на JavaScript. Ключевые характеристики, описанные в README: - Установка с приоритетом Expo через `npx expo install`, настройка через встроенный config plugin; проекты на bare React Native CLI также поддерживаются. - Охваченные рекламные форматы включают app open, баннеры (anchored adaptive, inline adaptive, collapsible и устаревшие фиксированные размеры), нативную рекламу, межстраничные объявления, rewarded и rewarded interstitial, а также Google Ad Manager, обработку согласия через User Messaging Platform (UMP) и медиацию. - Варианты API для разработчиков включают императивные классы рекламы, React hooks и пулы предзагрузки для приложений, показывающих много рекламы. - Написана на TypeScript со сгенерированным справочником API, протестирована модульными и end-to-end тестами на обеих платформах. Требования к платформам: версия 17 требует React Native 0.86.0 или новее с включённой New Architecture; Legacy Architecture больше не поддерживается. Проектам на Expo нужна development build, поскольку Expo Go не поддерживается. Минимальные операционные системы — iOS 15.1 и Android API level 24. На Android интеграторы могут выбрать классический Google Mobile Ads SDK (по умолчанию) или GMA Next-Gen SDK на этапе сборки, при этом JavaScript API остаётся одинаковым в обоих случаях. README содержит таблицу статуса нативной реализации, показывающую, какие поверхности были портированы на Turbo Modules или Fabric components на каждой платформе. На iOS методы SDK, баннеры, полноэкранная реклама, нативная реклама и User Messaging Platform отмечены как завершённые, тогда как EventEmitter всё ещё в списке задач. На Android нативная реклама завершена, баннеры частично (мультиформатный баннер портирован, стандартный баннер в списке задач), а методы SDK, полноэкранная реклама, User Messaging Platform и EventEmitter остаются в списке задач; эти поверхности всё ещё работают через слой интероперабельности React Native без изменения JavaScript API. Ссылки на документацию охватывают начало работы, установку для Expo и React Native CLI, рекламные форматы, включая hooks и Ad Manager, согласие и приватность, тестирование, распространённые причины, по которым реклама не показывается, использование с React Native Firebase, миграцию на v17 и справочник API. Пакет также поставляет руководство для интеграторов — AI coding agents — в файле AGENTS.md, устанавливаемом в node_modules, к которому предполагается обращаться перед тем, как агент напишет код рекламы. Проект принимает issues и pull requests и публикует руководство по участию и кодекс поведения. Условия лицензии указаны в файле LICENSE репозитория.