使用EMAS Serverless服务开发一个简单的钉钉小程序。
教程介绍
本教程以一个可添加和删除待办事项的小程序为例,学习如何使用EMAS Serverless SDK调用云数据库API,开发一个钉钉小程序。本教程使用的小程序示例代码的业务逻辑已经编写好,您只需要根据本教程的引导开通Serverless服务,配置好小程序,就可以运行该小程序了。
目前EMAS Serverless服务仅支持类型为第三方个人应用的钉钉小程序。
准备工作
在开始前,您需要确保已经完成以下准备工作:
注册钉钉开发者账号。
如果您尚未注册钉钉小程序开发者账号,使用钉钉账号登录钉钉开放平台。
下载并安装小程序开发者工具(v1.0以上版本)。
详细信息,请参见下载说明。
开通EMAS服务。
在首次使用EMAS Serverless服务前,您需要开通EMAS服务。详细信息,请参见创建您的第一个服务空间中的“开通EMAS服务”。
授权钉钉开发者权限。
请联系您所在组织的管理员,在OA管理后台中,选择设置 > 权限管理 > 管理组,添加开发者权限下的对应权限。
步骤一:创建服务空间
小程序开发中创建的云资源会和服务空间进行关联。每个服务空间都有一个全局唯一的space ID。在使用云资源时,都通过这个space ID进行关联。
创建服务空间的具体步骤,请参见创建您的第一个服务空间。
步骤二:设置数据库权限
步骤三:创建钉钉小程序应用
您可以参考以下步骤,在钉钉开放平台创建钉钉小程序:
使用钉钉账号登录钉钉开放平台,并选择您的组织。
在钉钉开放平台,选择
。填写应用的基本信息,然后单击确定创建。
单击已创建的小程序,选择应用首页页签,单击应用信息列的查看详情,获取小程序的AppID及AppSecret。
单击设置安全域名页签,然后单击HTTP安全域名区域下的添加,加入阿里云的安全域名
aliyuncs.com
和步骤一:创建小程云服务空间生成的空间Endpoint。
步骤四:添加钉钉小程序
在开发前,您需要在EMAS Serverless服务中添加钉钉小程序。
完成以下操作,添加钉钉小程序:
登录EMAS管理控制台。
查找您的项目,单击项目,进入EMAS概览页。
在顶部导航栏,选择平台服务。
在左侧导航栏,选择
。选择钉钉页签。
单击添加密钥,然后设置钉钉小程序的AppID和AppSecret。
说明您可以在钉钉小程序详情页面获取App ID和App Secret。详情请参见小程序AppID和AppSecret。
步骤五:开发钉钉小程序
本教程以一个开发好的待办事项To Do小程序为例。在开始前,确保您已经了解了小程序的文件结构。具体请参见详细了解小程序文件结构。
参考以下步骤,开发钉钉小程序:
单击这里下载To Do小程序示例项目文件,然后解压下载的文件。
打开阿里云小程序开发工具,选择
,然后单击打开项目,然后选择已解压的项目文件。关联步骤三中添加的钉钉小程序,然后使用钉钉账号登录IDE,并完成授权。
在左侧菜单栏,单击NPM模块,然后选择安装小程序云SDK。
在项目文件列表中找到app.js文件,配置以下信息,然后保存。
appId是小程序的ID。您可以在钉钉开放平台的小程序详情页面查看AppID。
spaceId、clientSecret和endpoint在小程序Serverless控制台创建服务空间后可以获得。详情参见步骤一:创建小程云服务空间。
步骤六:调试小程序
打开小程序模拟器,单击+AddTodo添加待办事项。