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 and initializes itself on first use, so 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.3

Then import the package:

import 'package:app_info_helper/app_info_helper.dart';

Usage #

For a complete Chinese integration guide, see doc/USAGE.md.

Read values from the shared instance:

final info = AppInfoHelper.instance;

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;

If native values have not been loaded yet, the first getter read starts loading them automatically and returns the documented fallback value for that read. Later reads return the cached native values.

AppInfoHelper.instance is the recommended entry point. AppInfoHelper() is kept as a singleton factory for compatibility.

You may also initialize explicitly during app startup when you want to preload native values:

Future<void> main() async {
  WidgetsFlutterBinding.ensureInitialized();
  final initialized = await AppInfoHelper.instance.init();
  if (!initialized) {
    // Native values are unavailable. Getters still return documented fallbacks.
  }
  runApp(const MyApp());
}

init() returns true when native values were loaded and false when they were unavailable. It does not throw for channel/native read failures.

If you must guarantee that native values are loaded before a local read, use:

final info = await AppInfoHelper.instance.ready;
final model = info.deviceModel;

Refreshing Values #

final refreshed = await AppInfoHelper.instance.refresh();
await AppInfoHelper.instance.refreshAdvertisingId();
await AppInfoHelper.instance.refreshDeviceId();
await AppInfoHelper.instance.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.instance.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:

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