Installation

Requirements

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+

Installation Methods

AI Agent Integration (Recommended)
pub.dev (Manual)
Git Repository (Manual)

AI-Powered Integration

Automate your CloudX SDK integration using AI-powered Claude Code agents. Integrate in 20 minutes instead of 4-6 hours.

What Are Claude Code Agents?

CloudX provides 4 specialized AI agents that automate integration:

Integrator: Implements CloudX SDK with intelligent fallback logic
Auditor: Validates integration correctness
Build Verifier: Runs builds and catches errors
Privacy Checker: Ensures GDPR, CCPA, and COPPA compliance

Benefits

✅ Fast Integration: 20 minutes vs 4-6 hours manual work
✅ Automatic Fallback: Preserves your existing ad setup
✅ Privacy Compliant: Validates privacy handling automatically
✅ Build Verified: Catches errors before runtime
✅ Best Practices: Implements proper lifecycle management

Prerequisites

1. Install Claude Code

# macOS / Linux (Homebrew)
brew install --cask claude-code

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

# Verify
claude --version

2. Get Your CloudX App KeySign up at CloudX Dashboard to get your app key.3. Flutter Requirements

Flutter SDK 3.0.0+
Dart SDK 3.0.0+
Android API 21+ / iOS 14.0+

Quick Install (One-Liner):

bash <(curl -fsSL https://raw.githubusercontent.com/cloudx-io/cloudx-sdk-agents/main/scripts/install.sh)

This installs agents to .claude/agents/ in your current project directory.Alternative: Flutter-Only Install

bash <(curl -fsSL https://raw.githubusercontent.com/cloudx-io/cloudx-sdk-agents/main/scripts/install.sh) --platform=flutter

Usage

Step 1: Navigate to Your Project

cd /path/to/your/flutter/project
claude  # Launches Claude Code CLI

Step 2: Request IntegrationWith credentials:

Use @agent-cloudx-flutter-integrator to integrate CloudX SDK with app key: YOUR_APP_KEY

Without credentials (uses TODO placeholders):

Use @agent-cloudx-flutter-integrator to integrate CloudX SDK

Step 3: Review ChangesClaude Code will:

✅ Detect existing ad SDKs
✅ Add CloudX dependency to pubspec.yaml
✅ Initialize SDK in main.dart
✅ Implement ad managers with fallback logic
✅ Update existing ad code
✅ Set up proper lifecycle management

Step 4: Test Your Integration

flutter pub get
flutter run
# Look for "CloudX SDK initialized successfully"

Integration Modes

CloudX-Only (Greenfield)

No existing ad SDK detected
Clean CloudX-only integration
Simpler code, no fallback logic

CloudX-First with Fallback (Migration)

Existing ad SDK detected
CloudX tries first, falls back on error
Existing ad SDK code preserved

The agent decides for you - no configuration needed!

What Gets Changed

pubspec.yaml:

dependencies:
  cloudx_flutter: ^0.18.0

lib/main.dart:

void main() async {
  WidgetsFlutterBinding.ensureInitialized();

  // CloudX initialization
  await CloudX.initialize(
    appKey: 'YOUR_APP_KEY',
    allowIosExperimental: true,
  );

  runApp(MyApp());
}

Banner Widget:

CloudXBannerView(
  placementName: 'banner_home',
  listener: CloudXAdViewListener(
    onAdLoaded: (ad) => print('Loaded'),
    onAdLoadFailed: (error) {
      // Automatic fallback logic (if migrating)
    },
  ),
)

Troubleshooting

Agents Not Found:

ls ~/.claude/agents/
# Reinstall if needed
bash <(curl -fsSL https://raw.githubusercontent.com/cloudx-io/cloudx-sdk-agents/main/scripts/install.sh)

Build Errors:

# Ask Claude to diagnose:
Use @agent-cloudx-flutter-build-verifier to diagnose build issues

Ads Not Loading:

// Check error details
CloudXAdViewListener(
  onAdLoadFailed: (error) {
    print('Ad load failed: $error');
  },
)

Privacy Compliance:

# Run privacy check:
Use @agent-cloudx-flutter-privacy-checker to validate privacy compliance

Time Comparison

Task	Manual	With Agents
Add dependencies	5 min	Automatic
SDK initialization	15 min	Automatic
Ad implementation	30 min	Automatic
Fallback logic	45 min	Automatic
Test & debug	1-2 hours	15 min
Total	4-6 hours	20 minutes

Add to your pubspec.yaml:

dependencies:
  cloudx_flutter: ^0.18.0

Then install:

flutter pub get

For the latest development version:

dependencies:
  cloudx_flutter:
    git:
      url: https://github.com/cloudx-io/cloudx-flutter.git
      ref: v0.2.0  # Use specific version tag
      path: cloudx_flutter_sdk

Then install:

flutter pub get

Platform Setup

iOS Configuration

Set Minimum iOS Version

Update ios/Podfile:

platform :ios, '14.0'

Install CocoaPods

# cd ios && pod install && cd ..

iOS SDK Coming Very Soon! The iOS SDK release is in final preparation. Pod installation is temporarily disabled until the release is complete.

Add Adapters

CloudX requires ad network adapters. Add to ios/Podfile:

target 'Runner' do
  use_frameworks!
  use_modular_headers!

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

  # CloudX Ad Network Adapters
  pod 'CloudXMediationMetaAdapter', '~> 1.1.0'    # Meta Audience Network
  pod 'CloudXMediationPrebidAdapter', '~> 1.1.0'  # Prebid
  # Add other adapters as needed
end

Then run:

# cd ios && pod install && cd ..

iOS SDK Coming Very Soon! The iOS SDK release is in final preparation. Pod installation is temporarily disabled until the release is complete.

iOS is currently Alpha/Experimental. You must set allowIosExperimental: true during SDK initialization.

Android Configuration

Add Adapters

CloudX requires ad network adapters. Add to android/app/build.gradle:

dependencies {
    // CloudX Ad Network Adapters - add the networks you want
    implementation 'io.cloudx:adapter-meta:0.6.1'      // Meta Audience Network
    implementation 'io.cloudx:adapter-cloudx:0.6.1'    // CloudX Network
    // Add other adapters as needed
}

Or if using Kotlin DSL (build.gradle.kts):

dependencies {
    // CloudX Ad Network Adapters
    implementation("io.cloudx:adapter-meta:0.6.1")      // Meta Audience Network
    implementation("io.cloudx:adapter-cloudx:0.6.1")    // CloudX Network
}

Available Adapters

Meta Audience Network

Android: io.cloudx:adapter-meta:0.6.1
iOS: pod 'CloudXMediationMetaAdapter', '~> 1.1.0'High fill rates, competitive eCPMs

CloudX Network

Android: io.cloudx:adapter-cloudx:0.6.1
iOS: pod 'CloudXMediationPrebidAdapter', '~> 1.1.0'Premium demand with Prebid integration

More adapters coming soon. Contact CloudX for specific network integrations.

Verify Installation

Create a test file to verify the SDK is accessible:

import 'package:cloudx_flutter/cloudx.dart';

void main() async {
  // Check if platform is supported
  final supported = await CloudX.isPlatformSupported();
  print('CloudX supported: $supported');
  
  // Get SDK version
  final version = await CloudX.getVersion();
  print('CloudX version: $version');
}

Run your app:

flutter run

You should see the CloudX version printed in your console.

Next Steps

Complete SDK Guide

Full documentation: quickstart, all features, and troubleshooting

Changelog

View release history and migration guides

Flutter SDK

​Requirements

Flutter

iOS

Android

​Installation Methods

​AI-Powered Integration

​What Are Claude Code Agents?

​Benefits

​Prerequisites

​Installation

​Usage

​Integration Modes

​What Gets Changed

​Troubleshooting

​Time Comparison

​Platform Setup

​iOS Configuration

​Android Configuration

​Available Adapters

​Verify Installation

​Next Steps

Complete SDK Guide

Changelog

Requirements

Installation Methods

AI-Powered Integration

What Are Claude Code Agents?

Benefits

Prerequisites

Installation

Usage

Integration Modes

What Gets Changed

Troubleshooting

Time Comparison

Platform Setup

iOS Configuration

Android Configuration

Available Adapters

Verify Installation

Next Steps