device_client_information 0.0.1 copy "device_client_information: ^0.0.1" to clipboard
device_client_information: ^0.0.1 copied to clipboard

PlatformAndroid

Plugin para obter as informações do dispositivo como uniqueId

Device Client Information #

This is a plugin that lets you get basic information from your application's client. It's easy to use and supports different platforms (Android). There are four different information types: "application information", "software information", "operating system information", and "device information".

Information Types #

There are 4 different types:

  1. Application Information
  2. Software Information
  3. Operating System Information
  4. Device Information

Application Information #

Application information is all about the application you build. And notice that applicationId is not supported for web applications.

Attribute Android
applicationId
String

package name
applicationType
String (app/web)
applicationName
String
applicationVersion
String
applicationBuildCode
String

Software Information #

"Software" stands for the "software" that runs your application, such as "Operating System" for iOS/Android projects or "Browser" for web projects.

Attribute Android
softwareName
String

OS name
softwareVersion
String

OS version

Operating System Information #

OS information will show you the OS's name and version. Notice: Web projects may not get this information if the browser's user-agent doesn't contain any information about the operating system.

Attribute Android
osName
String

OS name
osVersion
String

OS version
osVersionCode
String

Android API level

Device Information #

The device information will display device's ID and name. Note that web projects don't support real deviceId, so they will use the package uuid to generate a unique string and save to the browser's cookie.

Attribute Android
deviceId
String
deviceName
String

Getting Started #

In the pubspec.yaml of your flutter project, add the following dependency:

dependencies:
  ...
  device_client_information: ^0.0.1

In your project add the following import:

import 'package:client_information/client_information.dart';

Then, you can get information like this:

// Get client information
DeviceInformation info = await DeviceInformation.fetch();

print(info.deviceId); // EA625164-4XXX-XXXX-XXXXXXXXXXXX
print(info.osName); // iOS

Decoration #

Starting from version 2.1.0, you can customize some information by passing the decorators. Like below:

var information = await DeviceInformation.fetch(
      // you can pass decorators to decoration the value before it return.
      decorators: ClientInformationDecorators(
        deviceId: (oriInfo, value) =>
            'prefix-$value-${oriInfo.applicationName}',
      ),
    );

Or, you can use extension method like this:

var information = await DeviceInformation.fetch();
print('Original DeviceId: ${information.deviceId}');
// Original DeviceId: EA625164-4XXX-XXXX-XXXXXXXXXXXX

var decoratedInfo = information.decoration(deviceId: (oriInfo, value) => '$value-some-suffix-string-here');
print('Decorated DeviceId: ${decoratedInfo.deviceId}');
// Decorated DeviceId: EA625164-4XXX-XXXX-XXXXXXXXXXXX-some-suffix-string-here

Mock Data for Test #

Starting from version 1.0.2, you can mock data or enable "mockMode" to facilitate testing. Here is how to set it up:


In your test file:

setUp(() async {
  // Change to "MockMode" and set the default data you need.
  DeviceInformation.mockOn(
      deviceId: 'mock_device_id', osName: 'MyCustomOS');
});

tearDown(() {
  // Close the "MockMode" in tearDown method
  DeviceInformation.mockOff();
});

// Run your test
test('`deviceId` will be "mock_device_id"', () async {
DeviceInformation info = await DeviceInformation.fetch();
  expect(info.deviceId, 'mock_device_id');
});
1
likes
150
pub points
47%
popularity

Publisher

unverified uploader

Plugin para obter as informações do dispositivo como uniqueId

Repository (GitHub)
View/report issues

Documentation

API reference

License

BSD-3-Clause (license)

Dependencies

flutter, plugin_platform_interface

More

Packages that depend on device_client_information