安装客户端SDK

前提条件

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

• 在使用EMAS Serverless SDK前，请确保已经正确安装了Node.js开发环境。详情信息，请参见安装Node.js客户端SDK。

• 已获取最新版本的SDK包，如版本号为：3.1.1，则可将以下操作中的版本号替换为3.1.1。

在支付宝小程序中使用SDK

完成以下操作，在支付宝小程序中使用SDK。

1. 在支付宝小程序项目的根目录，执行以下命令安装SDK。

   npm install --save @alicloud/mpserverless-sdk@X.X.X     //其中X.X.X 代表版本号

2. 在支付宝小程序项目的配置文件mini.project.json中，添加以下配置信息。

   // mini.project.json 
   "enableNodeModuleBabelTransform": true,
   "node_modules_es6_whitelist": [ "@alicloud/mpserverless-sdk"]

3. 在小程序项目中的app.js中添加以下代码，构造EMAS Serverless SDK的实例对象。

   // app.js
   import MPServerless from '@alicloud/mpserverless-sdk'
   
   const mpserverless = new MPServerless(my, {
    appId: <您的支付宝小程序appId>,
     spaceId: <您的小程序云serverless服务空间spaceId>
     clientSecret: <您的小程序云serverless服务空间clientSecret>
     endpoint: <您的小程序云serverless服务空间Api endpoint>
   });

   其中：

   • my是支付宝小程序开发者工具中的全局基础库，可以在开发环境中直接获取。

   • appId是小程序的ID。您可以在支付宝小程序开发者工具设置中，直接获取小程序的App ID。

     

   • spaceId、clientSecret和endpoint在小程序Serverless控制台创建服务空间后可以获得。相关操作，请参见创建您的第一个服务空间。

     

4. 在app.js的onLaunch生命周期中调用init接口完成初始化。

   说明

   在小程序端开始使用Serverless服务前，您需先调用mpserverless.init方法完成服务的初始化。在小程序中，我们建议您在onLaunch生命周期中进行初始化操作，并将EMAS Serverless SDK的实例对象挂载到小程序的全局App对象之上，以便后续在其他文件中调用。

   // app.js
   App({
     mpserverless: mpserverless,
     onLaunch() {
       mpserverless.init();
     },
   });

5. 在其他文件中使用SDK。

   说明

   在其他文件中可以通过getApp的方式，从全局对象APP中获取SDK的实例对象。

   // 其他文件中使用 sdk
   const { mpserverless } = getApp();
   
   mpserverless.db.collection('test').find();
   mpserverless.function.invoke('test');

在微信小程序中使用SDK

完成以下操作，在微信小程序中使用EMAS Serverless SDK。

1. 在微信小程序项目的根目录，执行以下命令安装SDK。

   npm install --save @alicloud/mpserverless-sdk@X.X.X    //其中X.X.X 代表版本号

2. 在微信小程序IDE中，选择工具>构建npm。

   

3. 在小程序项目中的app.js中添加以下代码，构造EMAS Serverless SDK的实例对象。

   // app.js
   import MPServerless from '@alicloud/mpserverless-sdk';
   
   const mpserverless = new MPServerless(wx, {
    appId: <您的微信小程序appId>,
     spaceId: <您的EMAS serverless服务空间spaceId>
     clientSecret: <您的EMAS serverless服务空间clientSecret>
     endpoint: <您的EMAS serverless服务空间Api endpoint>
   });

   其中：

   • wx是微信小程序IDE中的全局基础库，可以在开发环境中直接获取。

   • appId是小程序的ID。您可以在微信开发者工具设置中，直接获取小程序的App ID。

     

   • spaceId、clientSecret和endpoint在EMAS Serverless控制台创建服务空间后可以获得。相关操作，请参见创建您的第一个服务空间。

     

4. 在app.js的onLaunch生命周期中调用init接口完成初始化。

   说明

   在小程序端开始使用Serverless服务前，您需先调用mpserverless.init方法完成服务的初始化。在小程序中，我们建议您在onLaunch生命周期中进行初始化操作，并将EMAS Serverless SDK的实例对象挂载到小程序的全局App对象之上，以便后续在其他文件中调用。

   App({
     mpserverless: mpserverless,
     onLaunch(options) {
       mpserverless.init(); 
     },
   });

5. 在其他文件中使用SDK。

   说明

   在其他文件中可以通过getApp的方式，从全局对象APP中获取SDK的实例对象。

   // 其他文件中使用 sdk
   const { mpserverless } = getApp();
   
   mpserverless.db.collection('test').find();
   mpserverless.function.invoke('test');

在钉钉小程序中使用SDK

完成以下操作，在第三方个人应用的钉钉小程序中使用EMAS Serverless SDK。

1. 在钉钉小程序项目的根目录，执行以下命令安装SDK。

   npm install --save @alicloud/mpserverless-sdk@X.X.X    //其中X.X.X 代表版本号

2. 在小程序项目中的app.js中添加以下代码，构造EMAS Serverless SDK的实例对象。

   // app.js
   import MPServerless from '@ali/mpserverless-sdk'
   
   const mpserverless = new MPServerless(dd, {
    appId: <您的钉钉小程序appId>,
     spaceId: <您的EMAS Serverless服务空间spaceId>
     clientSecret: <您的EMAS Serverless服务空间clientSecret>
     endpoint: <您的EMAS Serverless服务空间Api endpoint>
   });

   其中：

   • dd是钉钉小程序开发者工具的全局基础库，可以在开发环境中直接获取。

   • appId是小程序的ID。可以在钉钉开放平台获取。

     

   • spaceId、clientSecret和endpoint在EMAS Serverless控制台创建服务空间后可以获得。相关操作，请参见创建您的第一个服务空间。

     

3. 在app.js的onLaunch生命周期中调用init接口完成初始化。

   说明

   在小程序端开始使用Serverless服务前，您需先调用mpserverless.init方法完成服务的初始化。在小程序中，我们建议您在onLaunch生命周期中进行初始化操作，并将EMAS Serverless SDK的实例对象挂载到小程序的全局App对象之上，以便后续在其他文件中调用。

   App({
     mpserverless: mpserverless,
     onLaunch(options) {
       await mpserverless.init();
     },
   });

4. 在其他文件中使用SDK。

   说明

   在其他文件中可以通过getApp的方式，从全局对象APP中获取SDK的实例对象。

   // 其他文件中使用 sdk
   const { mpserverless } = getApp();
   
   mpserverless.db.collection('test').find();
   mpserverless.function.invoke('test');