更新记录

1.0.7（2026-01-29）

修复纯血鸿蒙检测不到钉钉是否安装的问题

1.0.6（2026-01-29）

优化登录方式

1.0.5（2026-01-29）

文档更新

平台兼容性

钉钉登录插件

📱 功能说明

唤起手机钉钉 APP 进行授权登录，如果没有安装钉钉，会自动跳转到钉钉 H5 授权页面。

🚀 快速开始

1. 钉钉开发平台申请应用

1. 前往 钉钉开放平台 申请应用
2. 在分享设置中添加：
   • 重定向 URL
   • 分享中的包名、签名等信息

2. 使用示例

import {
  createDDLogin,      // 钉钉登录（必须）
  isDDAppInstalled    // 检测是否安装钉钉（可选）
} from "@/uni_modules/why-dd-login"

//安装了会跳转钉钉app进行授权 没有安装钉钉会走 H5 授权
createDDLogin({
  appId: 'dingc*****', //请看下面的参数说明
  redirectUri: 'http://**/**'
}, (res) => {
  console.log('授权结果=========', res)
  // 成功示例：{"msg":"success","state":"state","code":"*****ccbb2482cb******"}
})

//是否安装钉钉的判断 - 非必须 
isDDAppInstalled((isApp) => {
  console.log('是否安装钉钉:', isApp)
})

📋 参数说明

⚙️ 平台配置

一. 安卓不用配置

二. iOS 配置

在 uni_modules/why-dd-login/utssdk/app-ios/Info.plist 中：

• 将这里填写钉钉开放平台里面应用的Client ID 替换成上面的 appId

配置示意图：

三. 鸿蒙配置

1. 创建 build-profile.json5 （参考下图）

在项目根目录下创建 harmony-configs/build-profile.json5：

{
  "app": {
    "products": [
      {
        "name": "default",
        "signingConfig": "default",
        "compatibleSdkVersion": "5.0.3(15)",
        "runtimeOS": "HarmonyOS",
        "buildOption": {
          "strictMode": {
            "useNormalizedOHMUrl": true
          }
        }
      },
      {
        "name": "release",
        "signingConfig": "release",
        "compatibleSdkVersion": "5.0.3(15)",
        "runtimeOS": "HarmonyOS",
        "buildOption": {
          "strictMode": {
            "useNormalizedOHMUrl": true
          }
        }
      }
    ]
  }
}

2. 配置 module.json5

在 harmony-configs/entry/src/main/module.json5 的 "module" 下增加 "querySchemes": ["dingtalk"]。

如果有微信登录等其他应用和其它权限，在数组中自行添加。

完整示例：

{
  "module": {
    "name": "entry",
    "type": "entry",
    "description": "$string:module_desc",
    "mainElement": "EntryAbility",
    "deviceTypes": [
      "phone"
    ],
    "querySchemes": [
      "dingtalk"
    ],
    "requestPermissions": [
      {
        "name": "ohos.permission.INTERNET"
      }
    ],
    "deliveryWithInstall": true,
    "installationFree": false,
    "pages": "$profile:main_pages",
    "abilities": [
      {
        "name": "EntryAbility",
        "srcEntry": "./ets/entryability/EntryAbility.ets",
        "description": "$string:EntryAbility_desc",
        "icon": "$media:layered_image",
        "label": "$string:EntryAbility_label",
        "startWindowIcon": "$media:startIcon",
        "startWindowBackground": "$color:start_window_background",
        "exported": true,
        "skills": [
          {
            "entities": [
              "entity.system.home"
            ],
            "actions": [
              "ohos.want.action.home"
            ]
          }
        ]
      }
    ]
  }
}

配置示意图：

⚠️ 注意事项

• ❗ ！！！集成插件后需要打自定义基座包！！！ 分享暂时没加 ！！！后台集成移动端服务，不要用web端的，不然会提示：不存在临时授权码
• 分享功能暂时未添加