开发钉钉小程序

教程介绍

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

准备工作

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

• 注册钉钉开发者账号。

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

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

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

• 开通小程序云服务。

  在首次使用小程序云服务前，您需要开通小程序云服务。详细信息，请参见开通小程序云服务。

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

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

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

1. 使用阿里云账号登录小程序云控制台。
2. 在左侧导航栏，单击小程序Serverless > 服务空间管理。
3. 单击创建服务空间，输入服务空间名称，然后单击确定。
4. 创建成功后，单击详情查看space ID、secret和endpoint信息。
   
5. 单击小程序Serverless > 云数据库，然后在页面右上角选择已创建的服务空间。
6. 单击修改数据库权限，将write权限修改为true。
   说明 为了保证数据安全，默认数据库访问受限。您需要根据需要设置数据库权限，更多详细信息，请参见 数据权限管理。

   

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

参考以下步骤，在钉钉开放平台创建钉钉小程序：

1. 使用钉钉账号登录钉钉开放平台
2. 在钉钉开放平台，单击应用开发页签，然后在左侧导航栏选择第三方个人应用 > 小程序。
   
3. 在小程序页面，单击创建应用，输入小程序基本信息后，再单击创建应用。
4. 单击已创建的小程序，在应用首页页签，单击应用信息列的查看详情获取小程序的App ID及App Secret。
   图 1. 应用详情 图 2. 小程序AppID和AppSecret
5. 单击设置安全域名页签，然后单击HTTP安全域名区域下的添加，加入阿里云的安全域名aliyuncs.com和步骤一：创建小程云服务空间生成的空间endpoint。
   

步骤三：添加钉钉小程序

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

完成以下操作，添加钉钉小程序：

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

   

步骤四：开发钉钉小程序

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

参考以下步骤，开发钉钉小程序：

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

   

步骤五：调试小程序

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