Altcraft Flutter SDK

Altcraft SDK Logo

Altcraft Flutter SDK is a bridge to the native Altcraft Mobile SDK for Android and iOS. The SDK automates push notification delivery, event submission, request retries, and supports flexible workflows with JWT or role-based tokens.

Features

x Works with anonymous and registered users; supports multiple profiles on one device (JWT).
x Push subscription management: push subscribe, push suspend, push unsubscribe.
x Automatic push token update when it changes.
x Automatic transmission of notification delivery and open events.
x Mobile events registration.
x Update profile fields.
x Automatic retry of failed requests.
x Support for push providers: Firebase FCM (Android), APNs (iOS).
x Secure requests using JWT and flexible identifier matching.
x Support for rToken for simple subscription scenarios.
x SDK data cleanup and background tasks termination.
x Real-time SDK events via Dart Stream.

Dependency

altcraft_sdk:0.0.1

Authorization Types

JWT-Authorization (recommended approach)

JWT is added to the header of every request. The SDK requests the current token from the app via the JWTInterface.

Advantages:

Enhanced security of API requests.
Profile lookup by any identifier (email, phone, custom ID).
Support for multiple users on a single device.
Profile persists after app reinstallation.
Unified user identity across devices.

Authorization with a role token (rToken)

The role token is specified in the SDK configuration. Profile lookup is limited to the push token identifier.

Limitations:

The link to a profile may be lost if the push token changes and the change isn't reflected on the platform.
No multi-profile support.
It's not possible to register the same user on another device.

Requirements

Flutter 3.27+.
Dart 3.0+.
Android 7.1+ (API 25).
iOS 13.0+.
Push provider integrated in the host app (FCM for Android, APNs for iOS).

Documentations

Detailed information on SDK setup, functionality, and usage is available on the Altcraft documentation portal. You can navigate to the required section using the links below:

Provider Setup

FCM
APNs

License

EULA

END USER LICENSE AGREEMENT

LICENSE GRANT This agreement grants you certain rights to use the Altcraft Mobile SDK (hereinafter referred to as the "Software"). All rights not expressly granted by this agreement remain with the copyright holder.
USE You are permitted to use and distribute the Software for both commercial and non-commercial purposes.
MODIFICATION WITHOUT PUBLICATION You may modify the Software for your own internal purposes without any obligation to publish such modifications.
MODIFICATION WITH PUBLICATION Publication of modified Software requires prior written permission from the copyright holder.
DISCLAIMER OF WARRANTIES The Software is provided "as is," without any warranties, express or implied, including but not limited to warranties of merchantability, fitness for a particular purpose, and non-infringement of third-party rights.
LIMITATION OF LIABILITY Under no circumstances shall the copyright holder be liable for any direct, indirect, incidental, special, punitive, or consequential damages (including but not limited to: procurement of substitute goods or services; loss of data, profits, or business interruption) arising in any way from the use of this Software, even if the copyright holder has been advised of the possibility of such damages.
DISTRIBUTION When distributing the Software, you must provide all recipients with a copy of this license agreement.
COPYRIGHT AND THIRD-PARTY COMPONENTS This Software may include components distributed under other licenses. The full list of such components and their respective licenses is provided below:

Third-party libraries and licenses

Apache License 2.0 Licensed under the Apache License, Version 2.0. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0

Flutter
Dart

MIT License

plugin_platform_interface