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

教程介绍

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

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

准备工作

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

  • 注册钉钉开发者账号。

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

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

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

  • 开通小程序云服务。

    在首次使用小程序云服务前,您需要开通小程序云服务,具体请参见开通小程序云服务

  • 授权钉钉开发者权限。

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

步骤一:创建小程云服务空间

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

参考以下步骤,创建服务空间并设置数据库权限:

  1. 使用阿里云账号登录小程序云控制台
  2. 在左侧导航栏,单击小程序Serverless > 服务空间管理
  3. 单击创建服务空间,输入服务空间名称,然后单击确定
  4. 创建成功后,单击详情,查看SpaceIDSecretEndpoint信息。服务空间
  5. 选择小程序Serverless > 云数据库,然后在页面右上角选择已创建的服务空间。
  6. 云数据库页面,单击立即添加数据表
  7. 新建数据表页面,输入数据表名称,单击确定。新创建的数据表将在左侧导航栏显示出来。
  8. 单击您的数据表,然后选择权限 > 编辑权限
    说明 为了保证数据安全,默认数据库访问受限。您需要根据需要设置数据库权限。具体请参见数据权限管理
  9. 权限管理页面,选择自定义安全规则,并将write权限修改为true权限
  10. 单击确定

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

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

  1. 使用钉钉账号登录钉钉开放平台,并选择您的组织。
  2. 在钉钉开放平台,选择应用开发 > 第三方个人应用 > 创建应用
    应用
  3. 填写应用的基本信息,然后单击确定创建
    小程序
  4. 单击已创建的小程序,选择应用首页页签,单击应用信息列的查看详情,获取小程序的AppID及AppSecret。
    图 1. 应用详情
    图 2. 小程序AppID和AppSecret
  5. 单击设置安全域名页签,然后单击HTTP安全域名区域下的添加,加入阿里云的安全域名aliyuncs.com步骤一:创建小程云服务空间生成的空间Endpoint。

步骤三:添加钉钉小程序

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

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

  1. 使用阿里云账号登录小程序云控制台
  2. 在左侧导航栏栏,选择小程序Serverless > 设置,然后单击钉钉
  3. 单击添加密钥,然后设置钉钉小程序的AppID和AppSecret。
    说明 您可以在钉钉小程序详情页面获取App ID和App Secret。详情请参见图 2

步骤四:开发钉钉小程序

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

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

  1. 单击这里下载To Do小程序示例项目文件,然后解压下载的文件。
  2. 打开阿里云小程序开发工具,选择钉钉 > 第三方个人应用,然后单击打开项目,然后选择已解压的项目文件。
  3. 关联步骤三中添加的钉钉小程序,然后使用钉钉账号登录IDE,并完成授权。
  4. 在左侧菜单栏,单击NPM模块,然后选择安装小程序云SDK。
  5. 在项目文件列表中找到app.js文件,配置以下信息,然后保存。
    • appId是小程序的ID。您可以在钉钉开放平台的小程序详情页面查看AppID。
    • spaceIdclientSecretendpoint在小程序Serverless控制台创建服务空间后可以获得。详情参见步骤一:创建小程云服务空间

步骤五:调试小程序

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