# 配置预加载

安装预加载、周期性预加载和跳链安装预加载需分别进行配置，且三者均可通过云函数和开发者服务器（即HTTPS请求）两种数据来源方式来实现。

对于不同类型的开发者，支持的数据来源方式有所不同：

* 个人开发者：数据来源默认选择云函数，且仅支持通过云函数来实现预加载。需要开通云函数服务并创建函数才可以配置。

* 非个人开发者：数据来源支持云函数和开发者服务器两种。可根据实际需要进行选择。

下文介绍如何配置两种数据来源方式的预加载实现。

## 数据来源为云函数

### 前提条件

* 已[开通预加载服务](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/cloudfoundation-enable-prefetch)。

* 已[创建函数](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/cloudfoundation-create-and-config-function)。

### 绑定云函数

1. 登录[AppGallery Connect](https://developer.huawei.com/consumer/cn/service/josp/agc/index.html)，点击"开发与服务"。

2. 在项目列表中点击您的项目，在项目下的应用列表中选择需要配置预加载的HarmonyOS应用/元服务。

3. 在左侧导航栏选择"云开发（Serverless）> 预加载"，进入预加载页面。

   ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/fd/v3/1HyP7R1XRgOPEIZVHsxZmw/zh-cn_image_0000002778932747.png?HW-CC-KV=V1&HW-CC-Date=20260929T121652Z&HW-CC-Expire=31536000000&HW-CC-Sign=3B47CDEB496157581B81487256AB9F7A9C93582D3A5F40685F6C964B817AD066)
4. 根据实际需要，在"周期性预加载"、"安装预加载"或者"跳链安装预加载"区域，"数据来源"选择"云函数"，然后点击"函数名称"后的"修改"。

   > 说明
   > * 跳链安装预加载仅支持在HarmonyOS应用中调用。
   >
   > * 由于跳链安装预加载功能需要使用App Linking Kit提供的延迟链接能力，因此在配置跳链安装预加载之前，请务必先完成延迟链接的开发。具体请参见[通过延迟链接跳转至应用详情页](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/applinking-deferredlink)。

   ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/a1/v3/2MFWOObFQn6OXmJwivtzKQ/zh-cn_image_0000002749333666.png?HW-CC-KV=V1&HW-CC-Date=20260929T121652Z&HW-CC-Expire=31536000000&HW-CC-Sign=B8F1EA07806D0BAD4549E63440ACE024438D56C87D5F43B7F1FD8A62C93CAD32)
5. 以"周期性预加载"为例，在"函数名称"下拉框选择实现周期性预加载的函数名称。

   ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/6c/v3/G9PXDvChSy2aPCR5vi16Og/zh-cn_image_0000002749493550.png?HW-CC-KV=V1&HW-CC-Date=20260929T121652Z&HW-CC-Expire=31536000000&HW-CC-Sign=0D10C2E55893775035A0A4D61BF11DABEA9439B90FA9231CD9FEB1C6481FF3E1)
6. 点击"保存"完成周期性预加载配置。

   ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/bf/v3/3D_rZGEESWC_ImnGFsSwww/zh-cn_image_0000002779092607.png?HW-CC-KV=V1&HW-CC-Date=20260929T121652Z&HW-CC-Expire=31536000000&HW-CC-Sign=ECE9F3B13C4C7BE0FC98AF3886365CE947E7B6712613DFC23EFAFD7E32733C88)
7. 若配置"安装预加载"或"跳链安装预加载"，重复步骤4-6即可。

8. （可选）若后续需要修改绑定的云函数，只需点击"函数名称"后的"修改"进行更新。

   ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/a4/v3/I5rOKdUNRpqlXqDHDhX4nA/zh-cn_image_0000002778932749.png?HW-CC-KV=V1&HW-CC-Date=20260929T121652Z&HW-CC-Expire=31536000000&HW-CC-Sign=A7E5071F9C8A23B3DF9E53C228107AD2B6D9FFE542E07E4F20217E0BB76AD7D9)

## 数据来源为开发者服务器

### 前提条件

已[开通预加载服务](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/cloudfoundation-enable-prefetch)。

### 配置服务器地址

1. 登录[AppGallery Connect](https://developer.huawei.com/consumer/cn/service/josp/agc/index.html)，点击"开发与服务"。

2. 在项目列表中点击您的项目，在项目下的应用列表中选择需要配置预加载的HarmonyOS应用/元服务。

3. 在左侧导航栏选择"云开发（Serverless）> 预加载"，进入预加载页面。

   ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/2d/v3/Q8f5HZSHQN6MaBngWHx3Qg/zh-cn_image_0000002749333668.png?HW-CC-KV=V1&HW-CC-Date=20260929T121652Z&HW-CC-Expire=31536000000&HW-CC-Sign=65CECD8BC8C6D0C9E285895F4D717D79319AC25ECEDFA347C106F0C41BA677D8)
4. 根据实际需要，在"周期性预加载"、"安装预加载"或者"跳链安装预加载"区域，"数据来源"选择"开发者服务器"。

   > 说明
   > * 跳链安装预加载仅支持在HarmonyOS应用中调用。
   >
   > * 由于跳链安装预加载功能需要使用App Linking Kit提供的延迟链接能力，因此在配置跳链安装预加载之前，请务必先完成延迟链接的开发。具体请参见[通过延迟链接跳转至应用详情页](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/applinking-deferredlink)。

   ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/42/v3/JJAdFz1TSESTplNHtjKspQ/zh-cn_image_0000002749493552.png?HW-CC-KV=V1&HW-CC-Date=20260929T121652Z&HW-CC-Expire=31536000000&HW-CC-Sign=401DA6061B0E2F0556379D0D8FD6028D27E1F9DFBD6B892BE7178B7F37DCC71C)
5. 点击"下载地址"后的"修改"。

   ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/3d/v3/sfvLbpQTSCKpKlM2UbJIUQ/zh-cn_image_0000002779092609.png?HW-CC-KV=V1&HW-CC-Date=20260929T121652Z&HW-CC-Expire=31536000000&HW-CC-Sign=63BDF314905DAEABB2DD71D6DCA348D8ABD24991186A1152EF4532F86A1727D8)
6. 以"周期性预加载"为例，"下载地址"以"https://"开头，输入框中输入服务器地址，配置完成后点击"保存"。

   需要注意以下几点：
   * 仅支持填写一个服务器地址，需包含预加载资源接口路径，如图中示例：prefetchData。

   * 域名：须填写完整的域名。例如www.example.com，不可写为example.com。

   * IP地址：须填写准确的IP地址，确保没有输入错误。

   * 端口号：如果要指定端口号，可在服务器地址后面以冒号分隔，例如https://www.example.com:443。HTTPS协议的默认端口号（443）可以省略。

   ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/ae/v3/zy0ON04aS6GC5hGiV1c46w/zh-cn_image_0000002778932751.png?HW-CC-KV=V1&HW-CC-Date=20260929T121652Z&HW-CC-Expire=31536000000&HW-CC-Sign=B07F3EEFC53442019F302804B2B17278A17B59F0FF5FC51349A3166B171F91E9)

   后续AGC会周期性地向该处配置的开发者服务器（即下载地址）发起一个HTTP GET请求，其中包含的query参数请参考[开发者服务器接口规范](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/cloudfoundation-prefetch-cloud-interdev#开发者服务器接口规范)，获取到数据后会将整个HTTP body缓存在本地。
   > 说明
   > * 开发者服务器接口返回的数据内容需仅包含文本、图片、视频、音频等供页面展示的静态资源，不支持包含代码、脚本等动态数据。
   >
   > * 开发者服务器接口返回的数据类型为其自定义格式的JSON或字符串数据，大小需限定在3MB以内。

7. 若配置"安装预加载"，重复步骤4-6即可。

8. （可选）若后续需要修改下载地址，只需点击"下载地址"后的"修改"进行更新。

   ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/8c/v3/TD29j44hSLi00MU2CIFysw/zh-cn_image_0000002749333670.png?HW-CC-KV=V1&HW-CC-Date=20260929T121652Z&HW-CC-Expire=31536000000&HW-CC-Sign=F7890AA3246A190219AEC2C804442166E075CC753BEEE7248A48BFC7F22A7EE3)