跳转到主要内容

​
要求

Flutter

Flutter SDK 3.0.0+
Dart SDK 3.0.0+

iOS

iOS 14.0+
CocoaPods

Android

API 21+ (Android 5.0)
Gradle 8.0+

​
安装方法

​
AI 驱动集成

使用 AI 驱动的 Claude Code 代理自动化您的 CloudX SDK 集成。20 分钟内完成集成，而不是 4-6 小时。

​
什么是 Claude Code 代理？

CloudX 提供 4 个专用 AI 代理来自动化集成：
  • Integrator：实现具有智能回退逻辑的 CloudX SDK
  • Auditor：验证集成正确性
  • Build Verifier：运行构建并捕获错误
  • Privacy Checker：确保 GDPR、CCPA 和 COPPA 合规

​
优势

  • ✅ 快速集成：20 分钟 vs 4-6 小时手动工作
  • ✅ 自动回退：保留您现有的广告设置
  • ✅ 隐私合规：自动验证隐私处理
  • ✅ 构建验证：在运行时之前捕获错误
  • ✅ 最佳实践：实现正确的生命周期管理

​
前置条件

1. 安装 Claude Code
# macOS / Linux (Homebrew)
brew install --cask claude-code

# macOS / Linux (curl)
curl -fsSL https://claude.ai/install.sh | bash

# 验证
claude --version
2. 获取您的 CloudX 应用密钥在 CloudX 控制台 注册以获取您的应用密钥。3. Flutter 要求
  • Flutter SDK 3.0.0+
  • Dart SDK 3.0.0+
  • Android API 21+ / iOS 14.0+

​
安装

快速安装（一行命令）：
bash <(curl -fsSL https://raw.githubusercontent.com/cloudx-io/cloudx-sdk-agents/main/scripts/install.sh)
这会将代理安装到当前项目目录的 .claude/agents/。替代方案：仅 Flutter 安装
bash <(curl -fsSL https://raw.githubusercontent.com/cloudx-io/cloudx-sdk-agents/main/scripts/install.sh) --platform=flutter

​
使用

步骤 1：导航到您的项目
cd /path/to/your/flutter/project
claude  # 启动 Claude Code CLI
步骤 2：请求集成带凭据：
Use @agent-cloudx-flutter-integrator to integrate CloudX SDK with app key: YOUR_APP_KEY
不带凭据（使用 TODO 占位符）：
Use @agent-cloudx-flutter-integrator to integrate CloudX SDK
步骤 3：检查更改Claude Code 将：
  1. ✅ 检测现有广告 SDK
  2. ✅ 将 CloudX 依赖添加到 pubspec.yaml
  3. ✅ 在 main.dart 中初始化 SDK
  4. ✅ 实现带回退逻辑的广告管理器
  5. ✅ 更新现有广告代码
  6. ✅ 设置正确的生命周期管理
步骤 4：测试您的集成
flutter pub get
flutter run
# 查看 "CloudX SDK initialized successfully"

​
集成模式

仅 CloudX（全新项目）
  • 未检测到现有广告 SDK
  • 干净的仅 CloudX 集成
  • 更简单的代码，无回退逻辑
CloudX 优先带回退（迁移）
  • 检测到现有广告 SDK
  • CloudX 优先尝试，错误时回退
  • 保留现有广告 SDK 代码
代理会为您决定 - 无需配置！

​
更改内容

pubspec.yaml：
dependencies:
  cloudx_flutter: ^0.18.0
lib/main.dart：
void main() async {
  WidgetsFlutterBinding.ensureInitialized();

  // CloudX 初始化
  await CloudX.initialize(
    appKey: 'YOUR_APP_KEY',
    allowIosExperimental: true,
  );

  runApp(MyApp());
}
横幅 Widget：
CloudXBannerView(
  placementName: 'banner_home',
  listener: CloudXAdViewListener(
    onAdLoaded: (ad) => print('已加载'),
    onAdLoadFailed: (error) {
      // 自动回退逻辑（如果迁移）
    },
  ),
)

​
故障排除

找不到代理：
ls ~/.claude/agents/
# 如需重新安装
bash <(curl -fsSL https://raw.githubusercontent.com/cloudx-io/cloudx-sdk-agents/main/scripts/install.sh)
构建错误：
# 让 Claude 诊断：
Use @agent-cloudx-flutter-build-verifier to diagnose build issues
广告未加载：
// 检查错误详情
CloudXAdViewListener(
  onAdLoadFailed: (error) {
    print('广告加载失败: $error');
  },
)
隐私合规：
# 运行隐私检查：
Use @agent-cloudx-flutter-privacy-checker to validate privacy compliance

​
时间对比

任务手动使用代理
添加依赖5 分钟自动
SDK 初始化15 分钟自动
广告实现30 分钟自动
回退逻辑45 分钟自动
测试和调试1-2 小时15 分钟
总计4-6 小时20 分钟

​
平台设置

​
iOS 配置

1

设置最低 iOS 版本

更新 ios/Podfile：
platform :ios, '14.0'
2

安装 CocoaPods

# cd ios && pod install && cd ..
iOS SDK 即将发布！ iOS SDK 版本正在最终准备中。Pod 安装暂时禁用，直到发布完成。
3

添加适配器

CloudX 需要广告网络适配器。添加到 ios/Podfile：
target 'Runner' do
  use_frameworks!
  use_modular_headers!

  flutter_install_all_ios_pods File.dirname(File.realpath(__FILE__))

  # CloudX 广告网络适配器
  pod 'CloudXMediationMetaAdapter', '~> 1.1.0'    # Meta Audience Network
  pod 'CloudXMediationPrebidAdapter', '~> 1.1.0'  # Prebid
  # 根据需要添加其他适配器
end
然后运行：
# cd ios && pod install && cd ..
iOS SDK 即将发布！ iOS SDK 版本正在最终准备中。Pod 安装暂时禁用，直到发布完成。
iOS 目前为 Alpha/实验性。 您必须在 SDK 初始化时设置 allowIosExperimental: true。

​
Android 配置

1

添加适配器

CloudX 需要广告网络适配器。添加到 android/app/build.gradle：
dependencies {
    // CloudX 广告网络适配器 - 添加您需要的网络
    implementation 'io.cloudx:adapter-meta:0.6.1'      // Meta Audience Network
    implementation 'io.cloudx:adapter-cloudx:0.6.1'    // CloudX Network
    // 根据需要添加其他适配器
}
或者如果使用 Kotlin DSL (build.gradle.kts)：
dependencies {
    // CloudX 广告网络适配器
    implementation("io.cloudx:adapter-meta:0.6.1")      // Meta Audience Network
    implementation("io.cloudx:adapter-cloudx:0.6.1")    // CloudX Network
}

​
可用适配器

Android： io.cloudx:adapter-meta:0.6.1
iOS： pod 'CloudXMediationMetaAdapter', '~> 1.1.0'高填充率，有竞争力的 eCPM
Android： io.cloudx:adapter-cloudx:0.6.1
iOS： pod 'CloudXMediationPrebidAdapter', '~> 1.1.0'具有 Prebid 集成的优质需求
更多适配器即将推出。联系 CloudX 了解特定网络集成。

​
验证安装

创建测试文件以验证 SDK 是否可访问： 
import 'package:cloudx_flutter/cloudx.dart';

void main() async {
  // 检查平台是否支持
  final supported = await CloudX.isPlatformSupported();
  print('CloudX 支持: $supported');
  
  // 获取 SDK 版本
  final version = await CloudX.getVersion();
  print('CloudX 版本: $version');
}
运行您的应用： 
flutter run
您应该在控制台中看到打印的 CloudX 版本。

​
下一步

完整 SDK 指南

完整文档：快速开始、所有功能和故障排除

更新日志

查看发布历史和迁移指南