Cordova AdMob 插件项目教程

Cordova AdMob 插件项目教程

1. 项目目录结构及介绍

cordova-plugin-admob-simple/
├── docs/
│   └── 文档文件
├── src/
│   ├── android/
│   │   └── Android 平台相关代码
│   ├── ios/
│   │   └── iOS 平台相关代码
│   └── windows/
│       └── Windows 平台相关代码
├── test/
│   └── 测试代码
├── www/
│   └── 插件的 JavaScript 代码
├── .gitignore
├── LICENSE
├── README.md
├── package.json
└── plugin.xml

目录结构介绍

• docs/: 包含项目的文档文件，通常是 Markdown 格式的文档。
• src/: 包含插件的源代码，按平台分为 android/, ios/, 和 windows/ 子目录。
• test/: 包含插件的测试代码，用于确保插件的功能正常。
• www/: 包含插件的 JavaScript 代码，这些代码会被注入到 Cordova 应用中。
• .gitignore: Git 忽略文件，指定哪些文件或目录不需要被版本控制。
• LICENSE: 项目的开源许可证文件，通常是 MIT 许可证。
• README.md: 项目的自述文件，包含项目的介绍、安装和使用说明。
• package.json: 项目的 npm 配置文件，包含项目的依赖和脚本。
• plugin.xml: 插件的配置文件，定义了插件的名称、版本、依赖等信息。

2. 项目启动文件介绍

www/admob.js

www/admob.js 是插件的主要 JavaScript 文件，负责与原生代码进行交互，提供 AdMob 广告的加载和显示功能。

主要功能

• 初始化广告: 通过 initAd() 函数初始化广告，设置广告 ID 和选项。
• 加载和显示广告: 通过 createBannerView() 和 createInterstitialView() 函数加载广告，并通过 showBannerFunc() 和 showInterstitialFunc() 函数显示广告。
• 事件监听: 通过 registerAdEvents() 函数注册广告事件监听器，监听广告的加载、显示、关闭等事件。

3. 项目配置文件介绍

plugin.xml

plugin.xml 是插件的配置文件，定义了插件的名称、版本、依赖等信息。

主要配置项

• <plugin>: 定义插件的名称、版本和描述。
• <js-module>: 定义插件的 JavaScript 模块，指定模块的入口文件。
• <platform>: 定义插件在不同平台上的配置，包括 Android、iOS 和 Windows。
• <config-file>: 定义插件在不同平台上的配置文件，如 AndroidManifest.xml 和 Info.plist。
• <source-file>: 定义插件在不同平台上的源代码文件。

package.json

package.json 是项目的 npm 配置文件，包含项目的依赖和脚本。

主要配置项

• name: 项目的名称。
• version: 项目的版本号。
• description: 项目的描述。
• main: 项目的入口文件。
• scripts: 定义项目的脚本，如 test 和 build。
• dependencies: 定义项目的依赖包。
• devDependencies: 定义项目的开发依赖包。

通过以上配置文件和启动文件，开发者可以轻松地集成和使用 Cordova AdMob 插件，实现广告的加载和显示功能。