Advanced Integration

This guide covers advanced SDK features for customization and extension in both Flutter and Android.

1. Custom Widgets

Register your own native widgets to use them within Digia Studio. This is useful for maps, camera views, or complex native components.

Flutter

Step 1: Define Props Class

class MyWidgetProps {
  final String title;
  MyWidgetProps({required this.title});
  
  static MyWidgetProps fromJson(Map<String, dynamic> json) {
    return MyWidgetProps(title: json['title']);
  }
}

Step 2: Register Widget

DUIFactory().registerWidget<MyWidgetProps>(
  'custom/myWidget', // ID used in Digia Studio
  MyWidgetProps.fromJson,
  (props, childGroups) => MyCustomWidget(title: props.title),
);

Android (Jetpack Compose)

Step 1: Register Widget

DUIFactory.getInstance().registerWidget("custom/map") { props, registry ->
    // Extract props safely
    val lat = props["latitude"] as? Double ?: 0.0
    val lng = props["longitude"] as? Double ?: 0.0
    
    // Return your Composable
    GoogleMap(
        cameraPositionState = rememberCameraPositionState {
            position = CameraPosition.fromLatLngZoom(LatLng(lat, lng), 10f)
        }
    )
}

---

2. Environment Variables

Pass runtime configuration (like API endpoints, feature flags, or user tokens) to your Digia pages. Access them in Digia Studio using ${env.variableName}.

Flutter

Option A: At Initialization

DigiaUIApp(
  digiaUI: digiaUI,
  environmentVariables: {
    'apiBaseUrl': 'https://api.example.com',
    'authToken': user.token,
  },
  builder: ...
)

Option B: Runtime Update

DUIFactory().setEnvironmentVariables({
  'theme': 'dark',
  'userRole': 'premium',
});

Android (Jetpack Compose)

Runtime Update You can set environment variables at any time after initialization:

// Set single variable
DUIFactory.getInstance().setEnvironmentVariable("apiBaseUrl", "https://api.example.com")

// Set multiple variables
DUIFactory.getInstance().setEnvironmentVariables(mapOf(
    "theme" to "dark",
    "userRole" to "premium"
))

---

3. Analytics Integration

Track user interactions from Digia UI pages by implementing the Analytics interface.

Flutter

Step 1: Implement Adapter

class MyAppAnalytics extends DUIAnalytics {
  @override
  void logEvent(String name, Map<String, dynamic>? parameters) {
    // Forward to Firebase, Mixpanel, etc.
    FirebaseAnalytics.instance.logEvent(name: name, parameters: parameters);
  }
  
  // Implement other methods...
}

Step 2: Initialize

DigiaUIAppBuilder(
  analytics: MyAppAnalytics(),
  // ...
)

Android (Jetpack Compose)

Step 1: Implement Interface

class MyAppAnalytics : DUIAnalytics {
    override fun onEvent(events: List<AnalyticEvent>) {
        events.forEach { event ->
            // Forward to your analytics provider
            Log.d("Analytics", "Event: ${event.name}, Payload: ${event.payload}")
        }
    }
    
    override fun onDataSourceSuccess(dataSourceType: String, source: String, metaData: Any?, perfData: Any?) {}
    override fun onDataSourceError(dataSourceType: String, source: String, errorInfo: DataSourceErrorInfo) {}
}

Step 2: Pass to Options

DigiaUI.initialize(
    DigiaUIOptions(
        context = applicationContext,
        accessKey = "KEY",
        analytics = MyAppAnalytics()
    )
)