配置预加载
=====

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

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

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

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

#### 数据来源为云函数

#### \[h2\]前提条件

*   已[开通预加载服务](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)。
    

#### \[h2\]绑定云函数

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/1a/v3/1ASt2CqsSy60UXrYkOC_5A/zh-cn_image_0000002594669158.png?HW-CC-KV=V1&HW-CC-Date=20260612T073604Z&HW-CC-Expire=86400&HW-CC-Sign=E724E1E87E8B3E621D3DD706B5552AE76DA200C0AAA63C66D11208F34621B3D7)
    
4.  根据实际需要，在“周期性预加载”、“安装预加载”或者“跳链安装预加载”区域，“数据来源”选择“云函数”，然后点击“函数名称”后的“修改”。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/49/v3/W6JslFVdSG-3cGUmEgr1oQ/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T073604Z&HW-CC-Expire=86400&HW-CC-Sign=F12F9549898470FCAC7949CC43D959B8DA4E4E49647BBF9E4F19928BB2ABA43A)
    
    *   跳链安装预加载仅支持在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/25/v3/TlBh-BcLQZ6LTUw6u9DBIQ/zh-cn_image_0000002594829086.png?HW-CC-KV=V1&HW-CC-Date=20260612T073604Z&HW-CC-Expire=86400&HW-CC-Sign=D07DCEDFB3100D1F4E08A612F841616DF85AAB6A97FF69A835E4CD6860EA71FC)
    
5.  以“周期性预加载”为例，在“函数名称”下拉框选择实现周期性预加载的函数名称。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/d6/v3/PGBjUdraTVSTnYURe5OJDg/zh-cn_image_0000002625188533.png?HW-CC-KV=V1&HW-CC-Date=20260612T073604Z&HW-CC-Expire=86400&HW-CC-Sign=7E81865A7F7B05600225AB0009E3FF0F3B67E13A2C23C55762DA79648A27B762)
    
6.  点击“保存”完成周期性预加载配置。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/2b/v3/YeEP_4PgSN28MdGxAKXDxA/zh-cn_image_0000002625108677.png?HW-CC-KV=V1&HW-CC-Date=20260612T073604Z&HW-CC-Expire=86400&HW-CC-Sign=ABBC0C927D968009434F8710E691D8895471BD1B25D6C28A104FE5EF6C8F3CAD)
    
7.  若配置“安装预加载”或“跳链安装预加载”，重复步骤4-6即可。
    
8.  （可选）若后续需要修改绑定的云函数，只需点击“函数名称”后的“修改”进行更新。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/ba/v3/B2wvllfHQUqL91NFyEAXJA/zh-cn_image_0000002594669160.png?HW-CC-KV=V1&HW-CC-Date=20260612T073604Z&HW-CC-Expire=86400&HW-CC-Sign=5664719A44D4426B066D783E381C18425B516DE06440D1B0C82C1CBB5276D050)
    

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

#### \[h2\]前提条件

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

#### \[h2\]配置服务器地址

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/f7/v3/ocuq2MjITJSSMaxbIhJErQ/zh-cn_image_0000002594829088.png?HW-CC-KV=V1&HW-CC-Date=20260612T073604Z&HW-CC-Expire=86400&HW-CC-Sign=BA0AC259E9FE98057E0727BC7E1903DCF6E21BB03BEAECE1EF9723EAB1AA32BB)
    
4.  根据实际需要，在“周期性预加载”、“安装预加载”或者“跳链安装预加载”区域，“数据来源”选择“开发者服务器”。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/dd/v3/7m_rHJTcQOSoImr-z3hLZg/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T073604Z&HW-CC-Expire=86400&HW-CC-Sign=1BC3F6002BD98883EBF2A6CFF791E4AE4E4E9B838BC602E2F9AC667CFACD5755)
    
    *   跳链安装预加载仅支持在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/ce/v3/IxXjUpn2QDC6FLvtBA81eQ/zh-cn_image_0000002625188535.png?HW-CC-KV=V1&HW-CC-Date=20260612T073604Z&HW-CC-Expire=86400&HW-CC-Sign=069A47AD94DF2A6A9DCED7F66926EF45E088C5A634B27D22F1298BF074EEF154)
    
5.  点击“下载地址”后的“修改”。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/81/v3/FfHdQ5T1SmGIvgg-mQQA4Q/zh-cn_image_0000002625108679.png?HW-CC-KV=V1&HW-CC-Date=20260612T073604Z&HW-CC-Expire=86400&HW-CC-Sign=3F451FFAF718546C0BFBE027216CFED40E7D4ECC2F3DAC43421FDB412B192D9A)
    
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/07/v3/UmjpubIrRVaq17H8K6I9yg/zh-cn_image_0000002594669162.png?HW-CC-KV=V1&HW-CC-Date=20260612T073604Z&HW-CC-Expire=86400&HW-CC-Sign=7B502CC5A89E8EE96B7E579CA1F3DD5B749567054340C94496AC021AB1D145D3)
    
    后续AGC会周期性地向该处配置的开发者服务器（即下载地址）发起一个HTTP GET请求，其中包含的query参数请参考[开发者服务器接口规范](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/cloudfoundation-prefetch-cloud-interdev#开发者服务器接口规范)，获取到数据后会将整个HTTP body缓存在本地。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/d/v3/Euv5Ts3TTwqpnb3Wa1POrg/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T073604Z&HW-CC-Expire=86400&HW-CC-Sign=137BEDFAFF4FB834BECD7A4D1559C58C2C87314E221B9F880375D937EE8B34DF)
    
    *   开发者服务器接口返回的数据内容需仅包含文本、图片、视频、音频等供页面展示的静态资源，不支持包含代码、脚本等动态数据。
        
    *   开发者服务器接口返回的数据类型为其自定义格式的JSON或字符串数据，大小需限定在3MB以内。
        
    
7.  若配置“安装预加载”，重复步骤4-6即可。
    
8.  （可选）若后续需要修改下载地址，只需点击“下载地址”后的“修改”进行更新。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/92/v3/uX-MLRg6Qw2hg4iwS03wOQ/zh-cn_image_0000002594829090.png?HW-CC-KV=V1&HW-CC-Date=20260612T073604Z&HW-CC-Expire=86400&HW-CC-Sign=CD26B6AE22D8F897609BEA658D9F49900256B7494E8C7A05F9BBD68E0AB2E717)