Flutter钉钉集成插件flutter_dingtalk_sdk的使用

Flutter钉钉集成插件flutter_dingtalk_sdk的使用

flutter_dingtalk_sdk 是一个钉钉的SDK插件，允许开发者调用钉钉的原生SDK。

安装

在 pubspec.yaml 文件中添加 flutter_dingtalk_sdk 依赖：

dependencies:
  flutter_dingtalk_sdk: ^1.0.4

Android配置

在 build.gradle 文件中添加以下内容：

buildscript {
    dependencies {
        classpath 'com.android.tools.build:gradle:4.1.0'
    }
}

iOS配置

在Xcode中，选择你的项目设置，选择目标，在信息标签页下的URL类型中，添加钉钉应用ID作为URL Scheme。

URL Types
tencent: identifier=tencent schemes=appId

在 Info.plist 中添加以下内容以检查其他应用程序是否已安装：

<key>LSApplicationQueriesSchemes</key>
<array>
  <string>dingtalk</string>
  <string>dingtalk-open</string>
  <string>dingtalk-sso</string>
</array>

确保Flutter版本

确保你使用的Flutter版本与插件兼容：

Flutter 2.2.2 • channel stable nullsafety
Framework • revision d79295af24 (9天前) • 2021-06-11 08:56:01 -0700
Engine • revision 91c9fc8fe0
Tools • Dart 2.13.3

功能说明

• 分享图片、文字、音乐、视频等。
• 钉钉登录。
• 打开钉钉应用。

准备工作

在集成之前，建议阅读官方文档以了解更多信息。

注册应用

通过 FluDing 注册应用：

FluDing.registerApp("dingu6xwfjbghhqtwwzu");

对于Android，查看文章以了解如何获取应用签名。然后你需要知道发布版和调试版应用签名的区别。如果签名不正确，可能会收到错误 errCode = -1。

文档说明

• 登录
• 分享

更多功能可以查看源代码。

常见问题

这些问题可能对你有帮助

示例代码

以下是完整的示例代码：

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

import 'package:flutter/services.dart';
import 'package:flutter_dingtalk_sdk/flutter_dingtalk_sdk.dart';

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

class MyApp extends StatefulWidget {
  [@override](/user/override)
  _MyAppState createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  String _dingtalkVersion = '未知';

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

    FluDingtalk.ddResponseEventHandler.listen(dingtalkResponseEvent);
  }

  Future<void> initPlatformState() async {
    String dingtalkVersion;
    try {
      dingtalkVersion = await FluDingtalk.openAPIVersion;
      print("钉钉SDK: ===》 versionSDK: $dingtalkVersion");
      bool isSupport = await FluDingtalk.registerApp(
          "dingcxbptovsyu1lmth0", "com.example.flu_dingtalk_example");
      print("注册成功: $isSupport");
    } on PlatformException {
      dingtalkVersion = '获取平台版本失败。';
    }
    if (!mounted) return;

    setState(() {
      _dingtalkVersion = dingtalkVersion;
    });
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('钉钉SDK演示'),
        ),
        body: Center(
          child: Column(
            mainAxisAlignment: MainAxisAlignment.center,
            children: [
              Text('dingtalkVersion: $_dingtalkVersion\n'),
              TextButton(
                onPressed: () {
                  FluDingtalk.isDingDingInstalled().then((value) {
                    print("是否安装了钉钉: $value");
                  });
                },
                child: Text('isDingDingInstalled'),
              ),
              TextButton(
                onPressed: () {
                  FluDingtalk.isDingTalkSupportSSO.then((value) {
                    print("是否支持登录: $value");
                  });
                },
                child: Text('isDingTalkSupportSSO'),
              ),
              TextButton(
                onPressed: () {
                  FluDingtalk.openDingTalk
                      .then((value) => print("打开钉钉App: $value"));
                },
                child: Text('openDingTalk'),
              ),
              TextButton(
                onPressed: () {
                  FluDingtalk.sendAuth("Auth").then(
                    (value) => print("打开钉钉登录: $value"),
                  );
                },
                child: Text('sendAuthDingTalk'),
              ),
              TextButton(
                onPressed: () {
                  FluDingtalk.sendTextMessage('分享文本');
                },
                child: Text('shareText'),
              ),
              TextButton(
                onPressed: () {
                  FluDingtalk.sendImageMessage(
                      picUrl:
                          'https://www.baidu.com/img/PCtm_d9c8750bed0b3c7d089fa7d55720d6cf.png');
                },
                child: Text('shareImage'),
              ),
              TextButton(
                onPressed: () {
                  FluDingtalk.sendWebPageMessage(
                    'https://www.baidu.com/',
                    title: '标题',
                    content: '描述2333',
                    thumbUrl:
                        'https://www.baidu.com/img/PCtm_d9c8750bed0b3c7d089fa7d55720d6cf.png',
                  );
                },
                child: Text('shareWebPage'),
              ),
            ],
          ),
        ),
      ),
    );
  }

  // 钉钉回调监听
  void dingtalkResponseEvent(event) {
    if (event is DDShareAuthResponse) {
      var response = event;
      if (response.code.isNotEmpty) {
        print("OAuthCode: ${response.code}");
      } else {
        print(response.mErrStr);
      }
    }
  }
}