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

教程介绍

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

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

准备工作

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

  • 注册钉钉开发者账号。

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

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

    详细信息，请参见下载说明。

  • 开通小程序云服务。

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

  • 授权钉钉开发者权限。

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

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

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

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

  1. 使用阿里云账号登录小程序云控制台。
  2. 在左侧导航栏，单击小程序Serverless > 服务空间管理。
  3. 单击创建服务空间，输入服务空间名称，然后单击确定。
  4. 创建成功后，单击详情，查看SpaceID、Secret和Endpoint信息。服务空间
  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。
    • spaceId、clientSecret和endpoint在小程序Serverless控制台创建服务空间后可以获得。详情参见步骤一：创建小程云服务空间。

步骤五：调试小程序

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