Send Debug Info

_|

This example showcases how to build a Flutter app featuring an interactive map and how to share debug information as a .txt file, using the Maps SDK for Flutter.

How it works

The example app demonstrates the following features:

• Display an interactive map.
• Share debug logs.

Initial map screen

Share menu open with .txt file

UI and Map Integration

The following code builds a UI with an interactive GemMap and a share button.

main.dart

const projectApiToken = String.fromEnvironment('GEM_TOKEN');

void main() async {
  // Turn on logging
  Debug.logCallObjectMethod = false;
  Debug.logCreateObject = true;
  Debug.logLevel = GemLoggingLevel.all;
  Debug.logListenerMethod = true;

  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) {
    return const MaterialApp(
      debugShowCheckedModeBanner: false,
      title: 'Send Debug Info',
      home: MyHomePage(),
    );
  }
}

class MyHomePage extends StatefulWidget {
  const MyHomePage({super.key});

  @override
  State<MyHomePage> createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  @override
  void dispose() {
    GemKit.release();
    super.dispose();
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        backgroundColor: Colors.deepPurple[900],
        title: const Text(
          'Send Debug Info',
          style: TextStyle(color: Colors.white),
        ),
        actions: [
          IconButton(
            onPressed: _shareLogs,
            icon: const Icon(Icons.share, color: Colors.white),
          ),
        ],
      ),
      body: GemMap(
        key: ValueKey("GemMap"),
        appAuthorization: projectApiToken,
        onMapCreated: (ctrl) async {
          await Debug.setSdkDumpLevel(GemDumpSdkLevel.verbose);

          // Redirect Dart SDK logs to the SDK dump log file
          final dartSdkLogger = Logger('GemSdkLogger');
          dartSdkLogger.onRecord.listen((record) {
            Debug.log(level: GemDumpSdkLevel.verbose, message: '${record.time} ${record.message}');
          });
        },
      ),
    );
  }

  Future<void> _shareLogs() async {
    // Get the path to the SDK log dump file
    final logPath = await Debug.getSdkLogDumpPath();

    await SharePlus.instance.share(ShareParams(files: [XFile(logPath)]));
  }
}