Godot Android AdMob 插件安装与使用手册
1. 目录结构及介绍
本部分将概述Shin-NiL/Godot-Android-Admob-Plugin的目录组织,帮助您快速理解项目架构。
Godot-Android-Admob-Plugin/
├── admob-plugin/ # 这里包含了插件的核心代码与编译脚本
│ ├── godot-lib/ # 存放与AdMob相关的原生库(AAR文件)
│ │ └── release/ # 编译后的Android库存放位置
│ ├── godotadmob/ # Godot引擎的AdMob插件源码
│ │ └── src/ # 插件的主要Java源代码
│ ├── build.gradle # Gradle构建文件
│ └── ... # 其他构建相关文件
├── admob-lib/ # 包含额外资源或配置,具体用途需结合文档说明
├── config/ # 可能存放配置示例或说明
├── demo/ # 示例项目,用于展示如何在Godot项目中集成AdMob
├── images/ # 文档或示例所需的图片资源
├── ... # 其余辅助或文档文件
├── LICENSE # 许可证文件,明确项目使用的开放协议
└── README.md # 主要的项目说明文档
2. 启动文件介绍
对于此AdMob插件,核心在于其在Godot项目中的集成而非独立运行的应用。因此,并不存在传统意义上的“启动文件”。但是,在您的Godot项目中,关键的启动涉及到对插件的配置和调用。您需要在Godot编辑器内设置以下:
- 主场景(Main Scene): 在您的游戏逻辑中,通过脚本引入AdMob功能,如初始化、显示广告等。
- Project Settings > Export > Android: 配置Custom Templates并启用该插件,确保网络权限已开启。
3. 项目的配置文件介绍
3.1 build.gradle
位于admob-plugin
目录下的build.gradle
是Gradle构建脚本,负责编译与AdMob交互的Android原生部分。这是插件与Android系统整合的关键,定义了依赖关系和编译规则。
3.2 godot.admob.gdap
和 godot.admob.release.aar
这些不是单独的文件介绍,而是指代AAR(Android ARchive)包,存储在admob-plugin/godot-lib/release/
下,是AdMob插件在Android上的实现。AAR包含所有必要的Java代码和资源,必须正确集成到Godot的Android导出模板中才能使AdMob功能生效。
3.3 Project Settings
内的配置
虽然这不是文件形式的配置,但在Godot项目中,需要进行一系列设置以启用该插件,包括:
- 在Export设置的Android选项下添加必要的权限(Access Network State和Internet)。
- 检查Use Custom Build,指定自定义模板路径。
- 确保插件列表中勾选了“Godot Ad Mob”。
请注意,理解并遵循项目提供的README.md
文档是成功集成AdMob至关重要的一步,它提供了详尽的步骤指导与注意事项。