如何实现在端侧调用云函数？
观看前，友情提示：
不知道《如何一键创建端云一体化模板》的小白同学，请看：
鸿蒙端云一体化开发--开发云函数--适合小白体制-CSDN博客
实现方法：
第一步：添加依赖
如果你用的不是《端云一体化模板》进行创建项目的，你就要自行在端侧的 oh-package.json5 中添加依赖：
"dependencies": {"@hw-agconnect/cloud": "^1.0.0","@hw-agconnect/hmcore": "^1.0.0","@hw-agconnect/auth-component": "^1.0.0","long": "5.2.1"}注：oh-package.json5文件是在端测ArkTS开发中entry模块下的，它就是管理端侧依赖的。
如果你使用的是《端云一体化模板》进行创建项目的，则系统创建自带依赖：
第二步：初始化AGConnect
初始化AGConnect，它是我们接下来调用云函数、使用云数据库、使用云存储的一个前提，简单来说，你只要使用到云侧的功能就必须先做一件事就是初始化AGConnect。当然，如果你用的是《端云一体化》模板生成好的，那么初始化AGConnect代码就已经生成好了。
初始化AGConnect相关代码介绍：
第一：引入initialize函数
import { initialize } from '@hw-agconnect/hmcore';
第二：调用initialize函数
initialize(this.context, JSON.parse(json));的解析：
this.context:传递的是端侧UIAbility的上下文对象
JSON.parse(json)是从云侧agconnect-services.json文件中传递进来的，所以上三行代码就是为了解析agconnect-services.json文件的配置文件信息，而agconnect-services.json文件存放位置一般是：
1. AppScope/resources/rawfile/agconnect-services.json
2. entry/resources/rawfile/agconnect-servicesn.jso
案例：
那这个agconnect-services.json文件它里面放了些什么东西呢？
答：存放的是我们云侧应用的一些相关配置信息。
我们可以转向看看AGC控制台：
如果你不是使用《端云一体化》模板创建应用的，可在AGC控制台上可以手动下载agconnect-services.json文件。但是请注意：
请下载最新的配置文件（如果您修改了项目、应用信息或者更改了某个开发服务设置，可能需要更新该文件）
而agconnect-services.json文件是相应应用的配置文件，有了配置文件，端侧那边才知道怎么根据这个配置文件去连接云侧，去执行云侧的相关功能。
如果你使用的是《端云一体化》模板创建应用的，它已经自动帮我们下载好并且存储在DevEco Studio开发软件内项目工程相应位置上。
如果你项目和应用做了更改，请记得重新下载最新的agconnect-services.json文件，将其copy覆盖原文件。
补充内容（可选看）
在initialize函数中，它是怎么去读取这个agconnect-services.json配置文件的呢？
答：
但是上述代码操作感觉很繁琐，所以有没有更简介的方法？
答：有的，教你一招：
我们可以用import语句，来引入这个agconnect-services.json文件，而且引入的结果就直接会拿到最终我们需要的JSON对象：
第一步：利用import语句进行导入：
修改之前的代码：
再补充一点：
我们initialize函数不仅仅可以在onWindowStageCreate这个方法内调用，根据官网文档，initialize函数也可以放在onCreate里面来调用：
如果你不是使用端云一体化模板添加：
操作如下：
下载 agconnect-services.json 文件（由端云一体化模板下载）
存放位置一般是
AppScope/resources/rawfile/agconnect-services.json
entry/resources/rawfile/agconnect-services.json
初始化代码一般放在 EntryAbility 中
import { initialize } from '@hw-agconnect/hmcore';
// @ts-ignore
import json from '../../resources/rawfile/agconnect-services.json'export default class EntryAbility extends UIAbility {onCreate() {try {initialize(this.context, json);} catch (e) {hilog.error(0x0000, 'AGConnectError', JSON.stringify(e))}// ...
}
}
第三步：ArkTS 界面开发
第一步创建一个page页面：
在这里我们只想做一个按钮，点击按钮即可触发云函数：
创建MyIndex页面：
注意：别忘记修改项目启动，跳转到首先是我们的MyIndex页面：
第四步：调用云函数
对按钮添加onClick（）事件，并且调用一个叫cloud对象来调用云函数：
- name 是云函数名
- version 是云函数版本，$latest 即为最新版本
- params 是输入参数，注意会封装在 event.body 中，且需要自己 JSON.parse
而cloud对象来自于我们之前的项目依赖：
那么要接收云函数返回的结果，要什么来接收呢？
首先了解一下cloud的callFunction函数的返回类型：
因为是Promise封装的，所以我们要awit异步调用：
进行测试：
注意：调用云函数不是使用预览器实现的，要在模拟器或者真机中进行测试。
