SFMC Core #

Unified SFMC SDK core for Flutter — identity, attributes, custom events, logging.

Installation #

flutter pub add sfmc_core

iOS:

cd ios && pod install

Android: no additional steps — Gradle resolves the dependency automatically.

Required SDK configuration #

• Android — initialize in your MainApplication.kt via SFMCSdk.configure(...). See the Android SDK Integration Guide.
• iOS — initialize in your AppDelegate.swift via SFMCSdk.initializeSdk(...). See the iOS SDK Integration Guide.

Usage #

import 'package:sfmc_core/sfmc_core.dart';

// Initialize the SDK
await SFMCSdkModule.requestSdk();

// Identity
await SFMCSdkModule.setProfileId('user-1234');
final profileId = await SFMCSdkModule.getProfileId();

// Attributes
await SFMCSdkModule.setAttribute('email', 'sample@example.com');
await SFMCSdkModule.setAttributes({'first_name': 'Jane', 'last_name': 'Doe'});
final attrs = await SFMCSdkModule.getAttributes();

// Custom event
await SFMCSdkModule.track(
  CustomEvent(name: 'app_open', attributes: {'screen': 'home'}),
);

// Cart event
await SFMCSdkModule.track(
  AddToCartEvent(
    lineItem: LineItem(
      catalogObjectType: 'Product',
      catalogObjectId: 'sku-1',
      quantity: 2,
      price: 9.99,
      currency: 'USD',
    ),
  ),
);

API #

Notes #

sfmc_core is the dependency root for every SFMC Flutter plugin. Other packages depend on it transitively — installing a product package (sfmc_marketingcloudsdk or sfmc_mobileappmessaging) auto-resolves this.

Versions #

• Flutter: >=3.3.0
• Dart SDK: >=3.0.6 <4.0.0
• Android: sfmcsdk 3.1.+
• iOS: MarketingCloud-SFMCSdk ~> 4.0.0

License #

BSD 3-Clause.