The CloudX iOS SDK is a comprehensive mobile advertising solution that provides programmatic advertising capabilities for iOS applications. This unified repository contains the complete CloudX iOS SDK ecosystem including the core SDK and various adapter implementations.

platform :ios, '14.0'

target 'YourApp' do
  use_frameworks!
  
  # CloudX Core SDK (source-based distribution)
  pod 'CloudXCore'
  
  # Optional: CloudX Adapters (framework-based distribution)
  pod 'CloudXMetaAdapter'
  # pod 'CloudXAdManagerAdapter'  # Coming soon
  # pod 'CloudXPrebidAdapter'     # Coming soon
end

Add this repository URL to your Xcode project:

https://github.com/cloudx-io/cloudx-ios

• core/ - The foundational CloudX Core SDK written in Objective-C that provides the base functionality for programmatic advertising (source-based distribution)
• adapter-meta/ - Meta (Facebook Audience Network) adapter for integrating Meta's advertising platform (framework-based distribution)
• adapter-cloudx/ - Prebid adapter for header bidding integration with CloudX's programmatic platform
• demo-app-objc/ - Complete Objective-C demo application showcasing CloudX SDK integration and usage patterns
• demo-app-swift/ - Complete Swift demo application demonstrating CloudX SDK implementation in Swift projects

For detailed installation instructions and usage examples, please refer to the individual component READMEs linked above.

This repository uses component-specific releases with tagged distribution to provide both organizational clarity and distribution flexibility.

• Core SDK: Source-based distribution with tags like v1.1.40-core
• Meta Adapter: Framework-based distribution with tags like v1.1.25-meta
• Individual Versioning: Each component maintains its own version to allow independent updates
• Clear Release Assets: Each release provides the appropriate distribution format for that component

v1.1.40-core   # Core SDK release (source distribution)
v1.1.25-meta  # Meta Adapter release (framework distribution)

• Core SDK: Direct source integration via CocoaPods/SPM for easier debugging and customization
• Meta Adapter: Pre-built xcframework for faster build times and simplified integration
• Automated Releases: GitHub Actions automatically build, test, and publish releases when tags are pushed

Each component release provides the appropriate assets for its distribution method:

• Direct source file access via CocoaPods/SPM
• No binary downloads required
• Full source code availability for debugging

CloudXMetaAdapter-v1.1.25.xcframework.zip  # Static xcframework for integration

• Optimized Distribution: Each component uses the most appropriate distribution method
• Independent Updates: Components can be updated independently without affecting others
• Developer Choice: Use source or framework distribution based on your needs
• Automated Pipeline: Releases are automatically built and published via GitHub Actions

For detailed documentation, installation instructions, and usage examples, please refer to the individual component READMEs:

• Core SDK - Detailed core SDK documentation and installation
• Meta Adapter - Meta integration guide and setup
• Prebid Adapter - Prebid integration guide and configuration
• Demo Apps - Explore the demo application directories for complete integration examples

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Make your changes in the appropriate component directory
4. Add tests for your changes
5. Commit your changes (git commit -m 'Add amazing feature')
6. Push to the branch (git push origin feature/amazing-feature)
7. Open a Pull Request

This project is licensed under the MIT License - see the individual LICENSE files in each component directory for details.

For technical support and questions:

• Create an issue in this repository
• Contact the CloudX team at [support email]
• Check the documentation in each component's README

See RELEASES for detailed changelog and version history.