share_tracker 1.0.9

share_tracker: ^1.0.9 copied to clipboard

Overview #

The Share Tracker package allows you to track device movements, locations, and other related data in a foreground service within your Flutter application. This example demonstrates how to integrate and use the Share Tracker package to display location and movement data in a simple Flutter application.

Requirements #

• Flutter: Ensure you have Flutter installed and set up on your development environment.
• Package Dependency: The Share Tracker package must be added to your pubspec.yaml.

dependencies:
  flutter:
    sdk: flutter
  share_tracker: ^1.0.0 # Replace with the latest version of the package

• iOS: Include the NSMotionUsageDescription key in your Info.plist file to grant the app permission to access motion data.

Steps to Use #

1. Initialize the Tracker Service:

void main() {
  TrackerService.instance.init();
  runApp(const ExampleApp());
}

2. Create the Main Application Widget:

class ExampleApp extends StatelessWidget {
  const ExampleApp({Key? key}) : super(key: key);

  @override
  Widget build(BuildContext context) {
    return const MaterialApp(
      home: MainPage(),
    );
  }
}

3. Create the Main Page Widget:

class MainPage extends StatefulWidget {
  const MainPage({Key? key}) : super(key: key);

  @override
  State<StatefulWidget> createState() => _MainPageState();
}

class _MainPageState extends State<MainPage> {
  final _controller = TrackerController();

  @override
  void initState() {
    super.initState();
    _controller.attach(this);
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: _buildAppBar(),
      body: _buildContent(),
    );
  }

  AppBar _buildAppBar() {
    return AppBar(
      title: const Text('Location Service'),
      centerTitle: true,
    );
  }

  Widget _buildContent() {
    return Center(
      child: SingleChildScrollView(
        child: ValueListenableBuilder(
          valueListenable: _controller.listenable,
          builder: (BuildContext context, Tracker? location, _) {
            return _buildResultTable(location);
          },
        ),
      ),
    );
  }

  Widget _buildResultTable(Tracker? tracker) {
    return Column(
      crossAxisAlignment: CrossAxisAlignment.stretch,
      children: [
        DataTable(
          columns: const [
            DataColumn(label: Text('key')),
            DataColumn(label: Text('value')),
          ],
          rows: [
            DataRow(cells: _buildDataCells('timeStamp', tracker?.position?.timestamp)),
            DataRow(cells: _buildDataCells('stepCount', tracker?.stepCount?.steps)),
            DataRow(cells: _buildDataCells('status', tracker?.status)),
            DataRow(cells: _buildDataCells('latitude', tracker?.position?.latitude)),
            DataRow(cells: _buildDataCells('longitude', tracker?.position?.longitude)),
            DataRow(cells: _buildDataCells('altitude', tracker?.position?.altitude)),
            DataRow(cells: _buildDataCells('speed', tracker?.position?.speed != null ? (tracker.position!.speed * 3.6) : 0)),
            DataRow(cells: _buildDataCells('sendTime', tracker?.sendTime)),
          ],
        )
      ],
    );
  }

  List<DataCell> _buildDataCells(String key, dynamic value) {
    return [
      DataCell(Text(key)),
      DataCell(Text(value.toString())),
    ];
  }

  @override
  void dispose() {
    _controller.dispose();
    super.dispose();
  }
}

4. Add a Message Listener to Update Location Data:

class TrackerController {
  final listenable = ValueNotifier<Tracker?>(null);

  void attach(State state) {
    TrackerService.instance.addTrackerListener((Tracker? tracker) {
      listenable.value = tracker;
    });
  }

  void dispose() {
    TrackerService.instance.removeTrackerListener();
  }
}

How It Works #

• TrackerService.instance.init(): Initializes the tracker service.
• TrackerService.instance.addTrackerListener(): Adds a listener to the tracker service that updates the ValueNotifier whenever new location or movement data is received.
• ValueListenableBuilder: Watches the ValueNotifier for changes and updates the UI accordingly.
• DataTable: Displays the received data (timestamp, step count, latitude, longitude, altitude, speed, sendTime) in a table format for easy visualization.

Additional Information #

For more detailed information on the Share Tracker package and its API, visit the package's documentation on pub.flutter-io.cn.

By following this example, you can effectively integrate and visualize location and movement data in your Flutter applications using the Share Tracker package.