AppSDK Flutter Plugin

Flutter Plugin project implemented with the ia.de AppSDK services.

1. General Info

The plugin implementation is based on the native AppSDK libraries developed by the ia.de team with Kotlin and Swift.

These native libraries offer both checkout services as well as view components in order to ensure seamless integration with any client setup.

Public API Reference: https://ihreapotheken.github.io/docs/appsdk/flutter

2. Developer Setup

3. Platform Support

The library is supported on both of the major mobile operating systems, with constraints noted below:

Android

  • Minimum SDK Version: 30
  • Target SDK Version: 36
  • Kotlin 2.1.0
  • Gradle 8.12.3

iOS

  • Minimum iOS Version: 15
  • Xcode: 16.0
  • Swift 5.9

4. Client Setup

For official reference, please see the Flutter SDK documentation on using Flutter plugins.

4.1. Add the dependency to the pubspec.yaml file

The library is accessed from Github as in below example:

# pubspec.yaml

environment:
  sdk: '>=3.10.0'
  flutter: '>=3.30.0'

dependencies:
  flutter:
    sdk: flutter
  appsdk_v2_flutter_plugin:
    git:
      url: https://github.com/ihreapotheken/IA-SDK-Flutter
      ref: main

You may reference specific branch, tag, or commit hash by specifying the ref field.

Version reference numbers can be found by reviewing the package Github repository tags.

4.2. Plugin usage

Methods and properties made available as public APIs implemented with the IaSdk.instance object.

The client setup requires module registration and invocation of the initialize method for usage:

import 'package:appsdk_v2_flutter_plugin/sdk.dart';

Future<void> initIaSdk() {
  await IaSdk.instance.register(
    modules: [
      // Described in the following section.
    ],
  );
  final iaSdkConfig = IaSdkConfiguration(
    accessKey: 'myAccessKey',
    clientId: 'myClientId',
    serverEnvironment: myServerEnvironment,
  );
  await IaSdk.instance.initialize(
    config: iaSdkConfig,
  );
}

Each of the two methods are expected to only be invoked once during the application runtime.

4.3. Module registration

Each of the individual native modules are available for installation from the modules directory:

# pubspec.yaml

environment:
  sdk: '>=3.10.0'
  flutter: '>=3.30.0'

dependencies:
  flutter:
    sdk: flutter
  appsdk_v2_flutter_plugin:
    git:
      url: https://github.com/ihreapotheken/IA-SDK-Flutter
      ref: main
  ia_cardlink: # Example module dependency.
    git:
      url: https://github.com/ihreapotheken/IA-SDK-Flutter
      ref: main
      path: modules/ia_cardlink

After implementing the modules with the pubspec.yaml file, it's public API declaration object needs to be instantiated, after which it can be forwarded to the register method:

import 'package:appsdk_v2_flutter_plugin/sdk.dart';
import 'package:ia_cardlink/ia_cardlink.dart';

final cardLinkModule = IaModuleCardLink();

Future<void> initIaSdk() {
  await IaSdk.instance.register(
    modules: [
      cardLinkModule,
    ],
  );
  
  ...

}

Once this is done, the module and it's respective methods and properties can be accessed from the IaSdk.instance object by accessing it's internal state:

import 'package:appsdk_v2_flutter_plugin/sdk.dart';

IaSdk.instance.cardLink;

For the list of available modules, please visit the modules directory.

For further information, please see the API reference.

Libraries

sdk