Flutter钉钉集成插件flu_dingtalk的使用

Getting Started（开始使用）

此项目是一个新的Flutter插件项目。它包含了针对Android和/或iOS的平台特定实现代码。

对于如何开始Flutter开发的帮助，可以查看在线文档，其中提供了教程、示例、移动开发指导以及完整的API引用。

使用示例

以下是flu_dingtalk插件的基本用法示例：

import 'package:flu_dingtalk/flu_dingtalk.dart';
import 'package:flu_dingtalk/flu_dingtalk_plugin_api.dart';
import 'package:flu_dingtalk/response/dingtalk_response.dart';
import 'package:flutter/material.dart';
import 'dart:async';

import 'package:flutter/services.dart';

void main() {
  runApp(const MyApp());
}

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

  [@override](/user/override)
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Plugin example app'),
        ),
        body: const HomeWidget(),
      ),
    );
  }
}

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

  [@override](/user/override)
  State<HomeWidget> createState() => _HomeWidgetState();
}

class _HomeWidgetState extends State<HomeWidget> {
  String _platformVersion = 'Unknown';
  String _registerApp = 'Unknown';

  [@override](/user/override)
  void initState() {
    super.initState();

    initPlatformState();

    FluDingtalk.ddResponseEventHandler.listen(dingtalkResponseEvent);
  }

  [@override](/user/override)
  void dispose() {
    super.dispose();
    FluDingtalk.dispose();
  }

  // 初始化平台状态
  Future<void> initPlatformState() async {
    bool registerApp = await FluDingtalk.registerApp(
        'dingcxbptovsyu1lmth0', 'com.example.flu_dingtalk_example');

    String platformVersion;
    // 处理平台消息可能失败的情况
    try {
      platformVersion = await FluDingtalk.openAPIVersion();
    } on PlatformException {
      platformVersion = 'Failed to get platform version.';
    }

    // 如果小部件在异步平台消息飞行时从树中移除，则丢弃回复
    if (!mounted) return;

    setState(() {
      _platformVersion = platformVersion;
      _registerApp = 'registerApp: $registerApp';
    });
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Center(
      child: Column(
        children: [
          Text('版本号: $_platformVersion'),
          Text(_registerApp),
          TextButton(
            onPressed: () {
              FluDingtalk.isDingDingInstalled().then((value) {
                _showDialog("是否安装了钉钉: $value");
              });
            },
            child: const Text('检查钉钉是否安装'),
          ),
          TextButton(
            onPressed: () {
              FluDingtalk.isDingTalkSupportSSO().then((value) {
                _showDialog("是否支持登录: $value");
              });
            },
            child: const Text('检查是否支持SSO登录'),
          ),
          TextButton(
            onPressed: () {
              FluDingtalk.openDDApp().then((value) {
                _showDialog("打开钉钉App: $value");
              });
            },
            child: const Text('打开钉钉App'),
          ),
          TextButton(
            onPressed: () {
              FluDingtalk.sendAuth(
                DTAuthReq(redirectURI: "https://www.yymimang.cn"),
              ).then((value) {
                // _showDialog("打开钉钉登录: $value");
              }).catchError((error) {
                _showDialog(error.toString());
              });
            },
            child: const Text('发送钉钉授权请求'),
          ),
          TextButton(
            onPressed: () {
              FluDingtalk.sendTextMessage('分享文本');
            },
            child: const Text('分享文本'),
          ),
          TextButton(
            onPressed: () {
              FluDingtalk.sendImageMessage(
                  picUrl:
                      'https://www.baidu.com/img/PCtm_d9c8750bed0b3c7d089fa7d55720d6cf.png');
            },
            child: const Text('分享图片'),
          ),
          TextButton(
            onPressed: () {
              FluDingtalk.sendWebPageMessage(
                'https://www.baidu.com/',
                title: '标题',
                content: '描述2333',
                thumbUrl:
                    'https://www.baidu.com/img/PCtm_d9c8750bed0b3c7d089fa7d55720d6cf.png',
              );
            },
            child: const Text('分享网页'),
          ),
        ],
      ),
    );
  }

  // 显示对话框
  void _showDialog(String msg) {
    showDialog(
      context: context,
      builder: (BuildContext context) {
        return _buildDialog(msg);
      },
    );
  }

  // 构建对话框
  Widget _buildDialog(String content) {
    return AlertDialog(
      content: Row(
        children: [
          Expanded(
            child: Text(content),
          ),
          const CloseButton(),
        ],
      ),
    );
  }

  // 钉钉回调监听
  void dingtalkResponseEvent(BaseDDResponse response) {
    if (response is DDShareResponse) {
      _showDialog("DDShareResponse: ${response.shareResult}");
    } else if (response is DDAuthResponse) {
      _showDialog("DDAuthResponse: ${response.accessCode}");
    } else {
      _showDialog("BaseDDResponse: ${response.mErrCode} - ${response.mErrStr}");
    }
  }
}