开发钉钉小程序

使用EMAS Serverless服务开发一个简单的钉钉小程序。

教程介绍

本教程以一个可添加和删除待办事项的小程序为例,学习如何使用EMAS Serverless SDK调用云数据库API,开发一个钉钉小程序。本教程使用的小程序示例代码的业务逻辑已经编写好,您只需要根据本教程的引导开通Serverless服务,配置好小程序,就可以运行该小程序了。

说明

目前EMAS Serverless服务仅支持类型为第三方个人应用的钉钉小程序。

准备工作

在开始前,您需要确保已经完成以下准备工作:

  • 注册钉钉开发者账号。

    如果您尚未注册钉钉小程序开发者账号,使用钉钉账号登录钉钉开放平台

  • 下载并安装小程序开发者工具(v1.0以上版本)。

    详细信息,请参见下载说明

  • 开通EMAS服务。

    在首次使用EMAS Serverless服务前,您需要开通EMAS服务。详细信息,请参见创建您的第一个服务空间中的“开通EMAS服务”。

  • 授权钉钉开发者权限。

    请联系您所在组织的管理员,在OA管理后台中,选择设置 > 权限管理 > 管理组,添加开发者权限下的对应权限。

步骤一:创建服务空间

小程序开发中创建的云资源会和服务空间进行关联。每个服务空间都有一个全局唯一的space ID。在使用云资源时,都通过这个space ID进行关联。

创建服务空间的具体步骤,请参见创建您的第一个服务空间

步骤二:设置数据库权限

  1. 登录EMAS管理控制台

  2. 查找您的项目,单击项目,进入EMAS概览页。

  3. 在顶部导航栏,选择平台服务

  4. 在左侧导航栏,选择EMAS Serverless > 云数据库,然后在页面右上角选择已创建的服务空间。

  5. 云数据库页面,单击立即添加数据表

  6. 单击您的数据表,然后选择权限> 编辑权限

    说明

    为了保证数据安全,默认数据库访问受限。您需要根据需要设置数据库权限,更多详细信息,请参见数据权限管理

  7. 权限管理页面,单击自定义安全规则,将write权限修改为true

    4
  8. 单击确定

步骤三:创建钉钉小程序应用

您可以参考以下步骤,在钉钉开放平台创建钉钉小程序:

  1. 使用钉钉账号登录钉钉开放平台,并选择您的组织。

  2. 在钉钉开放平台,选择应用开发 > 第三方个人应用 > 创建应用

    应用
  3. 填写应用的基本信息,然后单击确定创建

    小程序
  4. 单击已创建的小程序,选择应用首页页签,单击应用信息列的查看详情,获取小程序的AppID及AppSecret。

    应用详情
    小程序AppID和AppSecret
  5. 单击设置安全域名页签,然后单击HTTP安全域名区域下的添加,加入阿里云的安全域名aliyuncs.com步骤一:创建小程云服务空间生成的空间Endpoint。

步骤四:添加钉钉小程序

在开发前,您需要在EMAS Serverless服务中添加钉钉小程序。

完成以下操作,添加钉钉小程序:

  1. 登录EMAS管理控制台

  2. 查找您的项目,单击项目,进入EMAS概览页。

  3. 在顶部导航栏,选择平台服务

  4. 在左侧导航栏,选择EMAS Serverless > 设置

  5. 选择钉钉页签。

  6. 单击添加密钥,然后设置钉钉小程序的AppID和AppSecret。

    说明

    您可以在钉钉小程序详情页面获取App ID和App Secret。详情请参见小程序AppID和AppSecret

步骤五:开发钉钉小程序

本教程以一个开发好的待办事项To Do小程序为例。在开始前,确保您已经了解了小程序的文件结构。具体请参见详细了解小程序文件结构

参考以下步骤,开发钉钉小程序:

  1. 单击这里下载To Do小程序示例项目文件,然后解压下载的文件。

  2. 打开阿里云小程序开发工具,选择钉钉 > 第三方个人应用,然后单击打开项目,然后选择已解压的项目文件。

  3. 关联步骤三中添加的钉钉小程序,然后使用钉钉账号登录IDE,并完成授权。

  4. 在左侧菜单栏,单击NPM模块,然后选择安装小程序云SDK。

  5. 在项目文件列表中找到app.js文件,配置以下信息,然后保存。

    • appId是小程序的ID。您可以在钉钉开放平台的小程序详情页面查看AppID。

    • spaceId、clientSecret和endpoint在小程序Serverless控制台创建服务空间后可以获得。详情参见步骤一:创建小程云服务空间

步骤六:调试小程序

打开小程序模拟器,单击+AddTodo添加待办事项。