# ExploreX- AdFlutterPlugin

**Repository Path**: explore-x-one/explore-x--ad-flutter-plugin

## Basic Information

- **Project Name**: ExploreX- AdFlutterPlugin
- **Description**: Flutter Android和iOS的广告通用插件
- **Primary Language**: Unknown
- **License**: BSD-3-Clause
- **Default Branch**: develop
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-06-16
- **Last Updated**: 2025-12-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

## 导入和配置
从pub.dev导入
```
flutter pub add explorex_adflutterplugin
```
运行命令后，将在项目工程的pubspec.yaml中，自动添加以下类似代码（并触发flutter pub get）
```
dependencies:
  explorex_adflutterplugin: ^0.0.8
```
在类文件中引入头文件
```
  import 'package:explorex_adflutterplugin/explorex_adflutterplugin.dart';
```

## Android 集成注意事项

### 1. 最低 SDK 版本要求
插件依赖的部分广告 SDK 要求 `minSdkVersion >= 24`，请在你的项目 `android/app/build.gradle(.kts)` 中设置：

```
android {
    defaultConfig {
        minSdkVersion 24 // 或 minSdk = 24
    }
}
```

### 2. NDK 版本要求
插件依赖的部分广告 SDK 要求 `ndkVersion = "27.0.12077973"`，请在 `android/app/build.gradle(.kts)` 中设置：

```
android {
    ndkVersion = "27.0.12077973"
}
```

### 3. Manifest 合并冲突处理
如果遇到 Manifest 合并报错（如 label、allowBackup 冲突），请在 `android/app/src/main/AndroidManifest.xml` 的 `<application>` 标签中添加：

```
<application
    ...
    tools:replace="android:label,android:allowBackup"
    android:allowBackup="true"
    ...>
```
并确保 `<manifest>` 标签包含：
```
<manifest ... xmlns:tools="http://schemas.android.com/tools">
```

## IOS 集成注意事项
权限与配置
开启 HTTP 权限
在 ios/Runner/Info.plist 添加

```
   <key>NSAppTransportSecurity</key>
   <dict>
     <key>NSAllowsArbitraryLoads</key>
     <true/>
   </dict>
```


### 4. 常见错误与解决方法
- Manifest merger failed: 见上述配置
- minSdkVersion too low: 提升到 24
- NDK version mismatch: 设置为 27.0.12077973

如有疑问请参考 [Flutter 官方文档](https://flutter.dev/to/review-gradle-config) 或提交 issue。


## 广告功能API与用法示例

### 1. 设置广告请求URL
```dart
final adPlugin = ExplorexAdflutterplugin();
await adPlugin.setADSdkRequestUrl('https://your-ad-url');
```

### 2. 激励视频广告
```dart
final adPlugin = ExplorexAdflutterplugin();
String? result = await adPlugin.showRewardVideoAd('广告位ID');
```

### 3. 插屏广告
```dart
final adPlugin = ExplorexAdflutterplugin();
String? result = await adPlugin.showInterstitialAd('广告位ID');
```

### 4. 横幅广告（Banner）
```dart
import 'package:explorex_adflutterplugin/platformview/at_banner_platform_widget.dart';

PlatformBannerWidget('广告位ID')
```

### 5. 信息流广告（Feed）
```dart
import 'package:explorex_adflutterplugin/platformview/at_feed_platform_widget.dart';

PlatformFeedWidget('广告位ID')
```

### 6. Draw视频信息流广告
```dart
import 'package:explorex_adflutterplugin/platformview/at_Draw_platform_widget.dart';

PlatformDrawWidget('广告位ID')
```

### 7. 全屏视频广告
```dart
final adquest = ExplorexAdflutterplugin();
String? result = await adquest.showFullScreenVideoAd('广告位ID');
```

### 8. 开屏广告
```dart
final adquest = ExplorexAdflutterplugin();
String? result = await adquest.showSplashAd('广告位ID');
```

---

> 更多用法请参考 example 目录下的演示页面和源码

[项目主页](https://gitee.com/explore-x-one/explore-x--ad-flutter-plugin)