更新记录

1.0.0（2026-03-19）

钉钉分享功能

平台兼容性

uni-app(4.76)

uni-app x(4.76)

tt-dingtalk-share

🚀 钉钉分享 UTS 插件，为 uni-app x & uni-app 提供钉钉分享集成解决方案，支持分享文本、图片、链接到钉钉

📖 目录

• SDK版本信息
• 环境配置
• 快速开始
• 基础使用
• 功能介绍
  • 分享文本
  • 分享图片
  • 分享链接
• 错误处理
• 常见问题

SDK版本信息

📚 推荐阅读: 钉钉分享接入文档

🚨 重要提示

⚠️ 必须使用自定义基座运行，否则无法找到插件方法
⚠️ 测试前需在钉钉开放平台创建应用并获取 Client ID
⚠️ 分享前需先调用 register 初始化 SDK

环境配置

前置条件

1. 在钉钉开放平台创建移动应用
2. 获取应用的 Client ID（即 appId）
3. 配置应用包名和签名（Android）

iOS 平台配置

编辑插件内的 uni_modules/tt-dingtalk-share/utssdk/app-ios/Info.plist，将 CFBundleURLSchemes 中的 Client ID 替换为您的实际值：

<key>CFBundleURLSchemes</key>
<array>
  <string>此处填写您应用的 Client ID</string>
</array>

Android 平台配置

Android 平台会自动完成相关配置，确保在钉钉开放平台正确配置应用包名和签名即可。

HarmonyOS 平台配置

在项目的 harmony-configs/entry/src/main/module.json5 中，确保 querySchemes 包含钉钉相关 scheme：

{
  "module": {
    "querySchemes": [
      "dingtalk"
    ]
  }
}

💡 若项目已有 module.json5，只需在 querySchemes 数组中添加 "dingtalk" 即可。

快速开始

1. 导入插件

uni-app x 版本

import * as ddShare from "@/uni_modules/tt-dingtalk-share";

export default {
    data() {
        return {
            dingTalkShare: null as ddShare.TTDingTalkShare | null,
        }
    },
    onLoad() {
        this.dingTalkShare = ddShare.getTTDingTalkShare()
        this.initDingTalkShare()
    },
    methods: {
        initDingTalkShare() {
            // SDK 初始化代码见下方
        }
    }
}

uni-app 版本

import * as ddShare from "@/uni_modules/tt-dingtalk-share";

export default {
    data() {
        return {
            dingTalkShare: null,
        }
    },
    onLoad() {
        this.dingTalkShare = ddShare.getTTDingTalkShare()
        this.initDingTalkShare()
    },
    methods: {
        initDingTalkShare() {
            // SDK 初始化代码见下方
        }
    }
}

2. 初始化 SDK

uni-app x 版本

initDingTalkShare() {
    if (this.dingTalkShare == null) {
        console.error('钉钉分享 SDK 初始化失败')
        return
    }

    this.dingTalkShare!.register({
        appId: "您的钉钉应用 Client ID",
        success: (e) => {
            console.log("✅ 钉钉分享 SDK 初始化成功")
            this.checkDingTalkInstalled()
        },
        fail: (err) => {
            console.error("❌ 钉钉分享 SDK 初始化失败:", err)
            uni.showToast({
                title: 'SDK 初始化失败',
                icon: 'error'
            })
        }
    } as ddShare.TTDingTalkShareRegisterOptions)
}

uni-app 版本

initDingTalkShare() {
    if (this.dingTalkShare == null) {
        console.error('钉钉分享 SDK 初始化失败')
        return
    }

    this.dingTalkShare.register({
        appId: "您的钉钉应用 Client ID",
        success: (e) => {
            console.log("✅ 钉钉分享 SDK 初始化成功")
            this.checkDingTalkInstalled()
        },
        fail: (err) => {
            console.error("❌ 钉钉分享 SDK 初始化失败:", err)
            uni.showToast({
                title: 'SDK 初始化失败',
                icon: 'error'
            })
        }
    })
}

基础使用

检测钉钉是否安装

uni-app x 版本

checkDingTalkInstalled() {
    const isInstalled = this.dingTalkShare?.isInstall()
    if (isInstalled == false) {
        uni.showModal({
            title: '提示',
            content: '请先安装钉钉客户端',
            showCancel: false
        })
        return false
    }
    return true
}

uni-app 版本

checkDingTalkInstalled() {
    const isInstalled = this.dingTalkShare.isInstall()
    if (isInstalled == false) {
        uni.showModal({
            title: '提示',
            content: '请先安装钉钉客户端',
            showCancel: false
        })
        return false
    }
    return true
}

功能介绍

分享文本

💡 将文本内容分享到钉钉

参数说明

TTDingTalkShareTextOptions

示例代码

uni-app x 版本

shareText() {
    if (this.checkDingTalkInstalled() == false) return

    this.dingTalkShare?.shareText({
        text: '这是分享的文本内容',
        success: (res) => {
            console.log('✅ 文本分享成功')
            uni.showToast({ title: '分享成功' })
        },
        fail: (err) => {
            console.error('❌ 分享失败:', err)
            uni.showToast({ title: '分享失败', icon: 'error' })
        }
    } as ddShare.TTDingTalkShareTextOptions)
}

uni-app 版本

shareText() {
    if (this.checkDingTalkInstalled() == false) return

    this.dingTalkShare.shareText({
        text: '这是分享的文本内容',
        success: (res) => {
            console.log('✅ 文本分享成功')
            uni.showToast({ title: '分享成功' })
        },
        fail: (err) => {
            console.error('❌ 分享失败:', err)
            uni.showToast({ title: '分享失败', icon: 'error' })
        }
    })
}

分享图片

💡 将本地图片或网络图片分享到钉钉

参数说明

TTDingTalkShareImageOptions

示例代码

uni-app x 版本

shareImage() {
    if (this.checkDingTalkInstalled() == false) return

    this.dingTalkShare?.shareImage({
        imagePath: '/static/share-image.png', // 本地路径，也支持 file:// 或 http(s)://
        desc: '图片描述',
        success: (res) => {
            console.log('✅ 图片分享成功')
            uni.showToast({ title: '分享成功' })
        },
        fail: (err) => {
            console.error('❌ 图片分享失败:', err)
            uni.showToast({ title: '分享失败', icon: 'error' })
        }
    } as ddShare.TTDingTalkShareImageOptions)
}

uni-app 版本

shareImage() {
    if (this.checkDingTalkInstalled() == false) return

    this.dingTalkShare.shareImage({
        imagePath: '/static/share-image.png',
        desc: '图片描述',
        success: (res) => {
            console.log('✅ 图片分享成功')
            uni.showToast({ title: '分享成功' })
        },
        fail: (err) => {
            console.error('❌ 图片分享失败:', err)
            uni.showToast({ title: '分享失败', icon: 'error' })
        }
    })
}

分享链接

💡 将网页链接分享到钉钉，支持标题、描述和缩略图

参数说明

TTDingTalkShareLinkOptions

示例代码

uni-app x 版本

shareLink() {
    if (this.checkDingTalkInstalled() == false) return

    this.dingTalkShare?.shareLink({
        title: '网页标题',
        desc: '网页描述信息',
        url: 'https://www.example.com',
        thumbPath: '/static/thumb.png', // 可选，也支持 http(s):// 网络图片
        success: (res) => {
            console.log('✅ 链接分享成功')
            uni.showToast({ title: '分享成功' })
        },
        fail: (err) => {
            console.error('❌ 链接分享失败:', err)
            uni.showToast({ title: '分享失败', icon: 'error' })
        }
    } as ddShare.TTDingTalkShareLinkOptions)
}

uni-app 版本

shareLink() {
    if (this.checkDingTalkInstalled() == false) return

    this.dingTalkShare.shareLink({
        title: '网页标题',
        desc: '网页描述信息',
        url: 'https://www.example.com',
        thumbPath: '/static/thumb.png',
        success: (res) => {
            console.log('✅ 链接分享成功')
            uni.showToast({ title: '分享成功' })
        },
        fail: (err) => {
            console.error('❌ 链接分享失败:', err)
            uni.showToast({ title: '分享失败', icon: 'error' })
        }
    })
}

错误处理

错误码说明

错误对象结构

失败回调中的 err 对象包含：

• errCode: 错误码
• errMsg: 错误信息
• cause: 钉钉 SDK 原始错误（如有）

常见问题

1. 找不到插件方法？

解决方案: 确保使用自定义基座运行，标准基座不包含原生插件。

2. iOS 平台分享无响应？

解决方案:

• 检查 uni_modules/tt-dingtalk-share/utssdk/app-ios/Info.plist 中的 CFBundleURLSchemes 是否填写了正确的 Client ID
• 确认钉钉开放平台的 iOS 应用配置正确

3. Android 平台分享失败？

解决方案:

• 确认应用包名、签名与钉钉开放平台配置一致
• 检查是否已正确调用 register 初始化

4. 图片分享失败？

解决方案:

• 确保图片路径正确，本地路径需使用 convert2AbsFullPath 可解析的格式
• 检查图片文件是否存在且格式支持（JPG、PNG 等）

5. HarmonyOS 平台问题？

解决方案:

• 确保 module.json5 的 querySchemes 包含 "dingtalk"
• 确保项目依赖了 ddsharesdk.har 库

祝您开发愉快！ 🎉