Requirements
Minimum Requirements
- Android Studio Arctic Fox or later
- minSdkVersion 21 (Android 5.0)
- compileSdkVersion 35 or higher
- targetSdkVersion 35 recommended
- Kotlin 1.9.0+ or Java 8+
Installation Methods
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 that existing ad paths remain intact
- Build Verifier: Runs Gradle builds and catches compilation 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 GDPR/CCPA handling automatically
- ✅ Build Verified: Catches errors before runtime
- ✅ Best Practices: Implements proper initialization order
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
Installation
Quick Install (One-Liner):bash <(curl -fsSL https://raw.githubusercontent.com/cloudx-io/cloudx-sdk-agents/main/scripts/install.sh)
.claude/agents/ in your current project directory.Alternative: Manual Installation# In your Android project directory
curl -fsSL https://raw.githubusercontent.com/cloudx-io/cloudx-sdk-agents/main/scripts/install.sh -o install.sh
bash install.sh --local
ls .claude/agents/ # Verify
Usage
Step 1: Navigate to Your Projectcd /path/to/your/android/project
claude # Launches Claude Code CLI
Use @agent-cloudx-android-integrator to integrate CloudX SDK with app key: YOUR_APP_KEY
Use @agent-cloudx-android-integrator to integrate CloudX SDK as primary ad network.
My app key is abc123-your-key.
Update banner and interstitial ads.
- 🔍 Scan your codebase for existing ad SDKs
- 📦 Add CloudX dependencies to build.gradle
- 🔧 Update Application class with CloudX initialization
- 🎯 Modify ad loading code with CloudX + fallback
- ✅ Validate fallback paths still work
- 🏗️ Run build to catch errors
- 🔒 Check privacy compliance
Step 4: Test & Deploy./gradlew installDebug
# Test CloudX ads load
# Test fallback works (enable airplane mode)
What Gets Changed
build.gradle (app module):dependencies {
// ADDED: CloudX SDK
implementation("io.cloudx:sdk:0.8.0")
implementation("io.cloudx:adapter-cloudx:0.8.0")
// UNCHANGED: Your existing ad SDKs remain
}
class MyApplication : Application() {
override fun onCreate() {
super.onCreate()
// ADDED: CloudX initialization
CloudX.initialize(
CloudXInitializationParams(appKey = "your-key"),
object : CloudXInitializationListener {
override fun onInitialized() { }
override fun onInitializationFailed(error: CloudXError) { }
}
)
}
}
// CloudX first, with automatic fallback
private fun loadBanner() {
val cloudXBanner = CloudX.createBanner("banner_placement")
cloudXBanner.listener = object : CloudXAdViewListener {
override fun onAdLoaded(ad: CloudXAd) {
container.addView(cloudXBanner)
}
override fun onAdLoadFailed(error: CloudXError) {
// Automatic fallback logic added
}
}
}
Troubleshooting
Agents Not Found:# Verify installation
ls ~/.claude/agents/
# Reinstall if needed
bash <(curl -fsSL https://raw.githubusercontent.com/cloudx-io/cloudx-sdk-agents/main/scripts/install.sh)
# Ask Claude to fix:
Use @agent-cloudx-android-build-verifier to run ./gradlew build and fix any errors
# Run privacy check:
Use @agent-cloudx-android-privacy-checker to validate GDPR and CCPA compliance
Time Comparison
| Task | Manual | With Agents |
|---|
| Add dependencies | 5 min | Automatic |
| Implement initialization | 15 min | Automatic |
| Update ad loading | 30 min | Automatic |
| Add fallback logic | 45 min | Automatic |
| Test & debug | 1-2 hours | 15 min |
| Total | 4-6 hours | 20 minutes |
Update AndroidManifest.xml
Add the required permissions to your AndroidManifest.xml:
<manifest xmlns:android="http://schemas.android.com/apk/res/android">
<!-- Required permissions -->
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.READ_BASIC_PHONE_STATE" />
<!-- Recommended: For advertising ID -->
<uses-permission android:name="com.google.android.gms.permission.AD_ID" />
<!-- Optional: For location-based targeting -->
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<application>
<!-- Your app configuration -->
</application>
</manifest>
ProGuard Configuration
If you’re using ProGuard or R8, add these rules to your proguard-rules.pro:
# CloudX SDK
-keep class io.cloudx.sdk.** { *; }
-keepclassmembers class io.cloudx.sdk.** { *; }
# CloudX Adapters
-keep class io.cloudx.adapter.** { *; }
-keepclassmembers class io.cloudx.adapter.** { *; }
Verify Installation
Build your project to verify the SDK is properly installed:
If the build succeeds, you’re ready to initialize the SDK!
Next Steps
