这个项目能做什么
React Native Google Mobile Ads 是 Invertase 推出的一个库,让 React Native 和 Expo 应用可以通过 Google AdMob 或 Google Ad Manager 变现。它封装了 iOS 和 Android 的原生 Google Mobile Ads SDK,而不是用 JavaScript 重新实现广告投放。
README 中描述的主要特点:
- 通过 `npx expo install` 实现 Expo 优先安装,通过内置的 config plugin 进行配置;也支持裸 React Native CLI 项目。
- 覆盖的广告形式包括应用打开、横幅(锚定自适应、内联自适应、可折叠以及旧版固定尺寸)、原生、插屏、激励和激励插屏,此外还有 Google Ad Manager、通过 User Messaging Platform (UMP) 进行的同意管理以及中介。
- 面向开发者的 API 选项包括命令式广告类、React hooks,以及适用于展示大量广告的应用的预加载池。
- 使用 TypeScript 编写,带有生成的 API 参考文档,并在两个平台上进行了单元测试和端到端测试。
平台要求:版本 17 要求 React Native 0.86.0 或更高版本,并启用新架构;不再支持旧架构。Expo 项目需要 development build,因为不支持 Expo Go。最低操作系统为 iOS 15.1 和 Android API 级别 24。在 Android 上,集成方可以在构建时选择经典 Google Mobile Ads SDK(默认)或 GMA Next-Gen SDK,两者的 JavaScript API 相同。
README 包含一个原生实现状态表,显示每个平台上哪些界面已移植到 Turbo Modules 或 Fabric 组件。在 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 编码代理的集成方指南,位于 AGENTS.md,会安装到 node_modules 中,供代理编写广告代码前查阅。
该项目接受 issue 和 pull request,并发布了贡献指南和行为准则。许可条款见仓库的 LICENSE 文件。
评论
0 评分人数达到10人后显示
登录后参与讨论。