⚡ 10 分間のクイックスタート

flutter pub add tracelet

<key>NSLocationWhenInUseUsageDescription</key>
<string>We need your location to track your route.</string>
<key>NSLocationAlwaysAndWhenInUseUsageDescription</key>
<string>We need background location to record your route even when the app is closed.</string>
<key>NSMotionUsageDescription</key>
<string>Motion detection allows battery-efficient tracking by pausing GPS when stationary.</string>
<key>UIBackgroundModes</key>
<array>
  <string>location</string>
  <string>fetch</string>
</array>

import 'dart:io';
import 'package:flutter/material.dart';
import 'package:tracelet/tracelet.dart';
 
// 1. Define a top-level Headless Task to handle events when the app is killed
@pragma('vm:entry-point')
void headlessTask(HeadlessEvent event) {
  print('[Headless] Event received while app is killed: ${event.name}');
}
 
void main() async {
  WidgetsFlutterBinding.ensureInitialized();
 
  // 2. Register the headless task BEFORE runApp!
  Tracelet.registerHeadlessTask(headlessTask);
 
  // 3. Request permissions required for background tracking natively via Tracelet
  if (Platform.isAndroid) {
    await Tracelet.requestNotificationAuthorization(); // Required for Android 13+ Foreground Service
    await Tracelet.requestMotionAuthorization(); // Required for Motion Detection heuristics
  }
  
  final authStatus = await Tracelet.requestLocationAuthorization();
  if (authStatus == AuthorizationStatus.deniedForever) {
    print("Permissions denied!");
    return;
  }
 
  // 4. (Optional) Mitigate Aggressive OEM Battery Managers (Xiaomi, Huawei, etc.)
  if (Platform.isAndroid) {
    final health = await Tracelet.getSettingsHealth();
    if (health['isAggressiveOem'] == true) {
      await Tracelet.showPowerManager(); // Prompts user to whitelist the app
    }
  }
 
  // 5. Listen to real-time location events
  Tracelet.onLocation((location) {
    print('[Tracelet] Location: ${location.coords.latitude}, ${location.coords.longitude}');
  });
 
  // 6. Configure Tracelet with the Balanced Profile and Notification settings
  await Tracelet.ready(Config.balanced(
    url: 'https://api.your-server.com/locations',
    headers: {'Authorization': 'Bearer YOUR_TOKEN'},
    startOnBoot: true,
    stopOnTerminate: false, // Ensures tracking continues when app is swiped away
    android: AndroidConfig(
      foregroundService: ForegroundServiceConfig(
        contentTitle: "Background Tracking",
        contentText: "We are tracking your location securely.",
        notificationIcon: "mipmap/ic_launcher",
      ),
    ),
  ));
 
  // 7. Start tracking!
  await Tracelet.start();
 
  runApp(MyApp());
}