Flutter支持Zapper集成插件support_zapper的使用

功能

此插件将在应用中发生的任何事件创建ADO（Azure DevOps）工单。您需要提供组织名称、项目名称及访问令牌以创建工单。

开始使用

首先，导入 support_zapper 包：

import 'package:support_zapper/support_zapper.dart';

使用方法

包含了一些短小且有用的示例代码供用户参考。您可以将更长的示例添加到 /example 文件夹中。

await ExceptionHandler.initialize(
  organization: 'your_organization',
  project: 'your_project',
  accessToken: 'your_token',
  userDetails: {'name': 'test'}
);

ExceptionHandler.createTicket(message: 'Test Custom Ticket');

完整示例代码

以下是一个完整的示例代码，展示了如何在Flutter应用中使用 support_zapper 插件。

import 'package:dio/dio.dart';
import 'package:flutter/material.dart';
import 'package:support_zapper/support_zapper.dart';
import 'error_pages.dart';

Future<void> main() async {
  WidgetsFlutterBinding.ensureInitialized();

  // 初始化ExceptionHandler
  await ExceptionHandler.initialize(
      organization: 'your_organization',
      project: 'your_project',
      accessToken: 'your_token',
      userDetails: {'name': 'test'});

  runApp(const MyApp());
}

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

  // 此Widget是您的应用的根
  [@override](/user/override)
  Widget build(BuildContext context) {
    return const MaterialApp(
      title: 'Support Zapper Demo',
      home: MyHomePage(),
    );
  }
}

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

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: const Text('Support Zapper Demo'),
      ),
      body: Column(
        children: [
          Center(
            child: ElevatedButton(
              onPressed: () {
                Navigator.push(context, MaterialPageRoute<dynamic>(
                  builder: (_) => const CustomError(),
                ));
              },
              child: const Text('Create Custom Ticket'),
            ),
          ),
          Center(
            child: ElevatedButton(
              onPressed: () async {
                Navigator.push(context, MaterialPageRoute<dynamic>(
                  builder: (_) => const RenderError(),
                ));
              },
              child: const Text('Render Issue'),
            ),
          ),
          Center(
            child: ElevatedButton(
              onPressed: () async {
                Navigator.push(context, MaterialPageRoute<dynamic>(
                  builder: (_) => const NullError(),
                ));
              },
              child: const Text('Null Issue'),
            ),
          ),
          Center(
            child: ElevatedButton(
              onPressed: () {
                throw DioException(
                  requestOptions: RequestOptions(
                    path: 'https://unauthorized-exception-simulation-endpoint.com',
                  ),
                  response: Response(
                    requestOptions: RequestOptions(),
                    statusCode: 401,
                    statusMessage: 'Unauthorized',
                    data: {
                      'message': 'Unauthorized',
                    },
                  ),
                );
              },
              child: const Text('404'),
            ),
          ),
          Center(
            child: ElevatedButton(
              onPressed: () {
                throw DioException(
                  requestOptions: RequestOptions(
                    path: 'https://unauthorized-exception-simulation-endpoint.com',
                  ),
                  response: Response(
                    requestOptions: RequestOptions(),
                    statusCode: 500,
                    statusMessage: 'Unauthorized',
                    data: {
                      'message': 'Unauthorized',
                    },
                  ),
                );
              },
              child: const Text('500'),
            ),
          ),
          Center(
            child: ElevatedButton(
              onPressed: () async {
                Navigator.push(context, MaterialPageRoute<dynamic>(
                  builder: (_) => const ImageURlError(),
                ));
              },
              child: const Text('Image URL Error'),
            ),
          ),
        ],
      ),
    );
  }
}