adjust_helper_init

A lightweight Flutter plugin that provides a smooth loading experience with Adjust attribution integration. Shows a loading screen while initializing the Adjust SDK, awaiting attribution data, and performing a remote configuration check in the background.

Features

  • Awaits Adjust attribution data before proceeding
  • Sends full attribution data and adid as query parameters to the server
  • Customizable loading screen with remote image support
  • Background initialization and configuration checks
  • Adjust SDK integration with externalDeviceId
  • Smooth fade animations during loading
  • Automatic caching for faster subsequent launches
  • Configurable attribution timeout
  • Embedded in-app WebView fallback for redirects
  • Debug mode for development

Getting Started

Wrap your app with AdjustHelperGate to add a loading screen:

import 'package:flutter/material.dart';
import 'package:adjust_helper_init/adjust_helper_init.dart';

void main() {
  WidgetsFlutterBinding.ensureInitialized();
  runApp(
    AdjustHelperGate(
      config: const AdjustHelperConfig(
        baseAddress: 'https://your-app.com',
        configKey: 'your-config-key',
        imagePath: '/images/splash.jpg',
        adjustAppToken: 'YOUR_ADJUST_APP_TOKEN',
      ),
      child: const MyApp(),
    ),
  );
}

Configuration

Parameter Description Default
baseAddress Base address for loading resources required
configKey Configuration key for the app required
imagePath Path to the loading image required
adjustAppToken Adjust app token for SDK initialization required
adjustSandbox Use Adjust sandbox environment (set false for production) false
attributionTimeoutSeconds Timeout for waiting on Adjust attribution 30
imageDownloadTimeoutSeconds Timeout for image download 10
debugMode Enable debug logging false

Platform Support

Platform Support
iOS Yes