app_info_helper 0.1.0

Unified native app, device, locale, timezone, and identifier information for Flutter apps on iOS and Android.

app_info_helper

A Flutter plugin that exposes unified app, device, locale, timezone, and identifier information on iOS and Android.

The package keeps native values cached in memory after initialization, so most values can be read through synchronous getters in the rest of your app.

Features

• App metadata: app name, package name, version, build number, installer store, install time, update time, and Android build signature.
• Device and system metadata: model, manufacturer/platform, OS version, device name, physical device flag, disk size, and memory size.
• Locale and timezone metadata: language code, ISO-3 language code, country code, ISO-3 country code, locale, timezone, and UTC offset.
• Identifiers: IDFA, IDFV, Android ID, Google advertising ID, App Set ID, local UUID, and unified advertisingId / deviceId convenience getters.
• iOS ATT authorization helper for requesting IDFA access at the right moment in your app flow.

Installation

dependencies:
  app_info_helper: ^0.1.0

Then import the package:

import 'package:app_info_helper/app_info_helper.dart';

Usage

Initialize once during app startup:

Future<void> main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await AppInfoHelper().init();
  runApp(const MyApp());
}

Read cached values anywhere after initialization:

final info = AppInfoHelper();

final appName = info.appName;
final packageName = info.packageName;
final version = info.version;
final model = info.deviceModel;
final country = info.countryCode;
final timeZone = info.timeZone;
final deviceId = info.deviceId;

AppInfoHelper() is a singleton factory. Instances created in different places share the same cached native data.

Refreshing Values

await AppInfoHelper().refresh();
await AppInfoHelper().refreshAdvertisingId();
await AppInfoHelper().refreshDeviceId();
await AppInfoHelper().resetLocalUuid();

The plugin also refreshes cached values when the app returns to the foreground.

iOS IDFA and ATT

init() never shows the ATT prompt. It only reads IDFA when tracking permission has already been granted.

To request ATT authorization:

final result = await AppInfoHelper().requestIdfaAuthorization();

if (result.isSuccess) {
  final idfa = result.idfa;
} else {
  final failure = result.failure;
}

Before calling requestIdfaAuthorization() in a real iOS app, add NSUserTrackingUsageDescription to the host app's ios/Runner/Info.plist:

<key>NSUserTrackingUsageDescription</key>
<string>This identifier is used to provide more relevant content and advertising.</string>

Fallbacks

String getters never return null. Unavailable values return '', except these documented locale defaults:

Getter	Default
languageCode	en
languageCode3	eng
countryCode	US
countryCode3	USA
locale	en_US

Integer getters return 0, boolean getters return false, and list getters return an empty list when native values are unavailable.

Publishing

Before publishing from this directory, run:

flutter test
flutter analyze
flutter pub publish --dry-run