flutter_ad_gromore 是一个用于在 Flutter 应用中集成 Gromore 广告的插件。Gromore 是一个广告聚合平台，支持多种广告形式，如开屏广告、Banner 广告、插屏广告、激励视频广告等。以下是如何在 Flutter 项目中使用 flutter_ad_gromore 插件的详细步骤。

1. 添加依赖

首先，你需要在 pubspec.yaml 文件中添加 flutter_ad_gromore 插件的依赖。

dependencies:
  flutter:
    sdk: flutter
  flutter_ad_gromore: ^latest_version

然后运行 flutter pub get 来安装依赖。

2. 配置 Android 和 iOS 项目

Android 配置

在 android/app/build.gradle 文件中，确保 minSdkVersion 至少为 16，并且添加以下配置：

android {
    ...
    defaultConfig {
        ...
        minSdkVersion 16
        ...
    }
    ...
}

在 AndroidManifest.xml 文件中添加必要的权限和 Gromore 的配置：

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.example.yourapp">

    <uses-permission android:name="android.permission.INTERNET" />
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
    <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />

    <application
        android:name=".MyApplication"
        ...>
        <meta-data
            android:name="com.gromore.sdk.appid"
            android:value="YOUR_GROMORE_APP_ID" />
        ...
    </application>
</manifest>

iOS 配置

在 ios/Podfile 文件中，确保你使用的是 iOS 10.0 或更高版本：

platform :ios, '10.0'

在 Info.plist 文件中添加必要的权限和 Gromore 的配置：

<key>GromoreAppID</key>
<string>YOUR_GROMORE_APP_ID</string>

3. 初始化插件

在 Dart 代码中初始化 flutter_ad_gromore 插件。通常，你可以在 main.dart 文件中进行初始化。

import 'package:flutter_ad_gromore/flutter_ad_gromore.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await FlutterAdGromore.init('YOUR_GROMORE_APP_ID');
  runApp(MyApp());
}

4. 加载和显示广告

flutter_ad_gromore 插件支持多种广告形式，以下是一些常见的广告类型的示例。

开屏广告

import 'package:flutter_ad_gromore/flutter_ad_gromore.dart';

class SplashAdExample extends StatefulWidget {
  [@override](/user/override)
  _SplashAdExampleState createState() => _SplashAdExampleState();
}

class _SplashAdExampleState extends State<SplashAdExample> {
  FlutterAdGromoreSplashAd? _splashAd;

  [@override](/user/override)
  void initState() {
    super.initState();
    _loadSplashAd();
  }

  void _loadSplashAd() {
    _splashAd = FlutterAdGromoreSplashAd(
      adUnitId: 'YOUR_SPLASH_AD_UNIT_ID',
      onAdLoaded: () {
        print('Splash Ad Loaded');
      },
      onAdShow: () {
        print('Splash Ad Shown');
      },
      onAdClick: () {
        print('Splash Ad Clicked');
      },
      onAdDismiss: () {
        print('Splash Ad Dismissed');
      },
      onAdError: (error) {
        print('Splash Ad Error: $error');
      },
    );
    _splashAd?.loadAd();
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      body: Center(
        child: Text('Splash Ad Example'),
      ),
    );
  }
}

Banner 广告

import 'package:flutter_ad_gromore/flutter_ad_gromore.dart';

class BannerAdExample extends StatefulWidget {
  [@override](/user/override)
  _BannerAdExampleState createState() => _BannerAdExampleState();
}

class _BannerAdExampleState extends State<BannerAdExample> {
  FlutterAdGromoreBannerAd? _bannerAd;

  [@override](/user/override)
  void initState() {
    super.initState();
    _loadBannerAd();
  }

  void _loadBannerAd() {
    _bannerAd = FlutterAdGromoreBannerAd(
      adUnitId: 'YOUR_BANNER_AD_UNIT_ID',
      onAdLoaded: () {
        print('Banner Ad Loaded');
      },
      onAdShow: () {
        print('Banner Ad Shown');
      },
      onAdClick: () {
        print('Banner Ad Clicked');
      },
      onAdError: (error) {
        print('Banner Ad Error: $error');
      },
    );
    _bannerAd?.loadAd();
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Banner Ad Example'),
      ),
      body: Center(
        child: _bannerAd != null
            ? AdWidget(ad: _bannerAd!)
            : Text('Loading Banner Ad...'),
      ),
    );
  }
}

激励视频广告

import 'package:flutter_ad_gromore/flutter_ad_gromore.dart';

class RewardAdExample extends StatefulWidget {
  [@override](/user/override)
  _RewardAdExampleState createState() => _RewardAdExampleState();
}

class _RewardAdExampleState extends State<RewardAdExample> {
  FlutterAdGromoreRewardAd? _rewardAd;

  [@override](/user/override)
  void initState() {
    super.initState();
    _loadRewardAd();
  }

  void _loadRewardAd() {
    _rewardAd = FlutterAdGromoreRewardAd(
      adUnitId: 'YOUR_REWARD_AD_UNIT_ID',
      onAdLoaded: () {
        print('Reward Ad Loaded');
      },
      onAdShow: () {
        print('Reward Ad Shown');
      },
      onAdClick: () {
        print('Reward Ad Clicked');
      },
      onAdReward: () {
        print('Reward Ad Reward');
      },
      onAdError: (error) {
        print('Reward Ad Error: $error');
      },
    );
    _rewardAd?.loadAd();
  }

  void _showRewardAd() {
    _rewardAd?.showAd();
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Reward Ad Example'),
      ),
      body: Center(
        child: ElevatedButton(
          onPressed: _showRewardAd,
          child: Text('Show Reward Ad'),
        ),
      ),
    );
  }
}

5. 处理生命周期

确保在页面销毁时释放广告资源，以避免内存泄漏。

[@override](/user/override)
void dispose() {
  _splashAd?.dispose();
  _bannerAd?.dispose();
  _rewardAd?.dispose();
  super.dispose();
}