Aigens SDK Core - Flutter Plugin

⚡ Quick Start

Step 1: Add Dependency

Add the following to your Flutter project's pubspec.yaml:

dependencies:
  aigens_sdk_core: ^1.0.4

Step 2: Get Dependencies

flutter pub get

Step 3: Add SPM Package in Xcode (First Time Only)

open ios/Runner.xcworkspace

Then in Xcode:

File → Add Package Dependencies...

Enter URL:

https://github.com/AigensTechnology/AigensSdkCore.git

Select version:
- Branch → spm-swift
Select products:
- ✅ aigens-sdk-core (Flutter plugin)
Click Finish

Step 4: Run the Project

flutter run

Done! 🎉 After the initial setup, you only need to run flutter pub get and don't need to repeat Step 3.

📖 Detailed Instructions

Why Manual SPM Package Addition is Required?

Flutter 3.16+ supports SPM, but only automatically handles Flutter-generated plugins. Third-party SPM dependencies still need to be manually added to the Xcode project.

The good news is:

✅ Only needs to be added once
✅ Permanent after addition
✅ Works normally with flutter pub get afterwards

🔧 Troubleshooting

Q: How to Verify SPM Package is Correctly Integrated?

In Xcode:

Select the project
Check the Package Dependencies tab
You should see AigensSdkCore

Q: What to Do If Build Fails?

Try cleaning cache and rebuilding:

flutter clean
flutter pub get
flutter build ios

📱 Usage Example

import 'package:aigens_sdk_core/aigens_sdk_core.dart';

// Open WebContainer
final closedData = await AigensSdkCore.openUrl(
  url: 'https://your-server.com',
  member: MemberData(
    memberCode: 'member123',
    source: 'your-brand',
    universalLink: 'https://your-domain.com',
    appScheme: 'yourapp',
  ),
  deeplink: DeeplinkData(
    addItemId: 'item-001',
    addDiscountCode: 'SAVE10',
  ),
);

// Close WebContainer
await AigensSdkCore.dismiss();