nbase_ad_flutter_sdk 1.0.1

nbase_ad_flutter_sdk: ^1.0.1 copied to clipboard

🚀 NBase AdStage SDK 3.0.3 Integration #

• 📦 Updated Native SDK Dependencies

  • Android: Updated to io.nbase:nbase-adapter-adstage:3.0.3
  • iOS: Updated to AdapterAdStage 3.0.3

• 🎯 Simplified Initialization (Airbridge-style)

  • iOS: Added AdStageSDK.shared.initializeAdStage() one-line setup
  • Android: Enhanced initialization with AdStageSDK.setApiKey() + AdStageSDK.setUnifiedListener()
  • Removed complex cross-platform bridge logic
  • Sample app updated with simplified AppDelegate setup

• 🔧 Enhanced Features

  • Automatic deeplink handling for both platforms
  • Improved error handling and logging
  • Better documentation and examples

🎉 First Stable Release #

• 📚 Complete Documentation Added

  • Comprehensive SDK guide (NBase-AdStage-Flutter-SDK-Guide.md)
  • Dedicated deeplink functionality guide (DEEPLINK_GUIDE.md)
  • Dedicated promotion management guide (PROMOTION_GUIDE.md)
  • AI coding instructions for contributors (.github/copilot-instructions.md)

• 🚀 Core Features Stabilized

  • Deep linking functionality with proper URL handling
  • Promotion management (openPromotion, getPromotionList)
  • Cross-platform support (Android/iOS)
  • Automatic dependency management

• 🔧 Technical Improvements

  • Enhanced Android/iOS native plugin implementations
  • Improved sample application with proper setup
  • Better error handling and debugging support
  • Code cleanup and optimization

• ✅ Production Ready

  • Stable API interface
  • Comprehensive testing
  • Full platform compatibility
  • Ready for production use

Critical Fix #

• 🔧 iOS Framework Files Missing
  • Force-add AdapterAdStage.framework files to Git
  • Include both device (ios-arm64) and simulator (ios-arm64_x86_64) frameworks
  • Fix "No such module 'AdapterAdStage'" Swift compilation error
  • Resolve missing framework binary files in published package

Technical Details #

• ✅ Framework binaries now properly included in pub.dev package
• ✅ Both iOS device and simulator architectures supported
• ✅ Swift import resolution should work correctly
• ✅ Native module compilation fixed

Bug Fixes #

• 🔧 iOS xcframework inclusion
  • Add .pubignore file to override Git ignore rules for pub.dev
  • Include AdapterAdStage.xcframework in published package
  • Fix "No such module 'AdapterAdStage'" compilation error
  • Resolve iOS native module dependency issues

Technical Details #

• ✅ AdapterAdStage.xcframework now properly included in pub.dev package
• ✅ Separate ignore rules for Git (.gitignore) and pub.dev (.pubignore)
• ✅ iOS builds should now work correctly with Swift integration

Bug Fixes #

• 🔧 iOS podspec configuration
  • Rename adstage_deeplink.podspec → nbase_ad_flutter_sdk.podspec
  • Update podspec name and metadata to match package name
  • Fix CocoaPods integration issues for iOS builds
  • Resolve "No podspec found" error in Flutter iOS builds

Compatibility #

• ✅ Maintain full backward compatibility with 0.1.0 API
• ✅ Android builds remain unaffected
• ✅ iOS builds now work correctly with pub.dev package

Features #

• ✅ Initial release of NBase AdStage SDK for Flutter
• ✅ Deep link creation and handling with Cold Start support
• ✅ AdStage promotion system integration
• ✅ Cross-platform support (iOS/Android)
• ✅ Event tracking and analytics
• ✅ React Native SDK architecture adoption
• ✅ Flutter event stream for deep link notifications

Platform Support #

• ✅ Android: API 24+ (Android 7.0+)
• ✅ iOS: iOS 12.0+

Bundle Configuration #

• Sample app bundle ID: com.nbase.sdkdemo
• URL schemes: com.nbase.sdkdemo, nbasesdkdemo
• Universal Links support for beta.adg.im

Technical Details #

• Built with React Native SDK architecture for stability
• Comprehensive MainActivity and AppDelegate integration
• Cold start deep link handling
• Promotion management UI components