发布资源包下载任务
=========

在AppGallery Connect支持创建“使用华为CDN”或“使用三方CDN”的游戏资源包下载任务。

#### 前提条件

*   已准备好游戏资源包并加密，且自行保证游戏资源包的可用性。资源包支持的格式请参见[上传至华为CDN的资源包文件支持哪些格式类型](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/graphics-accelerate-assetdownload-faq-1)。
    
*   游戏资源包支持使用三方CDN或托管至华为CDN：
    
    *   若使用三方CDN，请提前将资源包上传至三方CDN服务器。
        
    *   若使用华为CDN，将在AppGallery Connect上传资源包。华为CDN对资源包有如下限制：
        
        *   文件大小：
            
            *   一个开发者下，所有游戏的所有资源包后台下载任务中，可以上传至华为CDN的资源包总大小不超过300GB。
                
            *   单个游戏的所有资源包后台下载任务中，可以上传至华为CDN的资源包总大小不超过200GB。
                
        *   保存时长：上传至华为CDN的资源包最多保留半年。
            

#### 进入申请页面

登录[AppGallery Connect](https://developer.huawei.com/consumer/cn/service/josp/agc/index.html)，点击“APP与元服务 ”，在游戏列表中选择游戏后，选择“分发 > 服务 > 资源包后台下载申请”，在页面右侧点击“申请”。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/4c/v3/DnqH7OrORA6AFiemRhLIYw/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T073541Z&HW-CC-Expire=86400&HW-CC-Sign=29B6FB1B66714738C652D237FADB4707E76CD32DB353590C6B558918894AC56F)

资源包下载任务的状态说明请参见[下载任务状态说明](#下载任务状态说明)。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/af/v3/qPTKrnntQDuftDgvK5QJPA/zh-cn_image_0000002625188377.png?HW-CC-KV=V1&HW-CC-Date=20260612T073541Z&HW-CC-Expire=86400&HW-CC-Sign=1538F9705C49E8844BB8C76928B66A94BBFB6645AB9B430D77F11F7AF009FD10)

#### 创建下载任务

#### \[h2\]资源包下载方式一：使用三方CDN

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/b5/v3/Ggo994cETnmYVze3n5vxJw/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T073541Z&HW-CC-Expire=86400&HW-CC-Sign=D1CEEB76B522AB423A9C2FA034937D88EBBFBFCB1DD9E791BCD84D78D3F0C51E)

已提前将资源包上传至三方CDN服务器。

在“资源包后台下载申请”页面填写资源包信息后，点击“提交申请”，提交资源包下载任务。若暂不提交该任务，点击“保存草稿”，允许继续编辑后再提交申请。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/8a/v3/-LQ3fbObQGKEiEV7Q3N53w/zh-cn_image_0000002625108521.png?HW-CC-KV=V1&HW-CC-Date=20260612T073541Z&HW-CC-Expire=86400&HW-CC-Sign=B9C7C0C893312ADF1FF624101605B99A76012B8DD6F740FE2C1E654769235D51)

| 配置项 | 是否可选 | 填写说明 |
| :-- | :-- | :-- |
| 下载类型 | 必选 | 
请选择下载器，建议根据应用自身是否有下载器进行选择：

\- 应用未内置下载器，建议选择“extension系统托管下载”，表示将由华为提供的系统下载器下载游戏资源包。

\- 应用已内置下载器，建议选择“extension协同下载”，表示将由应用自身下载器下载游戏资源包。

 |
| CDN | 必选 | 选择“使用三方CDN”。 |
| 指定下载时间段 | 可选 | 

用户向三方CDN服务器请求下载游戏资源包的时间段。步骤如下：

1\. 打开“指定下载时间段”开关。

2\. 点击“添加时间段”，指定开始时间和结束时间，最多可支持添加20个时间段，且多个时间段不能重叠。

 |
| 包体大小 | 必选 | 填写已上传至三方CDN服务器的资源包大小。 |
| CDN域名白名单 | 必选 | 英文逗号隔开，最多添加20个。 |
| 可下载的端侧最小版本号 | 可选 | 

为了提升CDN资源利用率，开发者可以限制下载游戏资源包的游戏版本。

请填写app.json5配置文件中的versionCode字段值。app.json5配置文件介绍请参见[配置文件标签](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/app-configuration-file#配置文件标签)。

若设备上已安装的游戏版本低于指定的端侧最小版本号，则无法下载游戏资源包。

若未填写端侧最小版本号，所有游戏版本均可下载游戏资源包。

 |

#### \[h2\]资源包下载方式二：使用华为CDN

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/f8/v3/BXPVzOKiRaWhvnHPuLaAOA/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T073541Z&HW-CC-Expire=86400&HW-CC-Sign=14D78B8800F839013D8C472DBBDE307C637798DACFEF502390C4EC5D84D69A85)

除了支持在AppGallery Connect“页面”方式创建“华为CDN”的资源包下载任务，还支持开发者使用“API”方式创建“华为CDN”的资源包下载任务，详情请参见[API接口](https://developer.huawei.com/consumer/cn/doc/AppGallery-connect-Guides/agcapi-res-pkg-preload-0000002362269981)。

在“资源包后台下载申请”页面填写资源包信息，具体步骤如下：

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/c0/v3/wcYOupXzTBeGBf7pycn0_g/zh-cn_image_0000002594669004.png?HW-CC-KV=V1&HW-CC-Date=20260612T073541Z&HW-CC-Expire=86400&HW-CC-Sign=E609A7179CE47403F8904929019A8F62900BE97A28886D0158B0A99705FD42B5)

1.  请选择“下载类型”。建议根据应用自身是否内置下载器进行选择。
    
    *   应用未内置下载器，建议选择“extension系统托管下载”，表示将由华为提供的系统下载器从华为CDN下载资源包。
        
    *   应用已内置下载器，建议选择“extension协同下载”，表示将由应用自身下载器从华为CDN下载资源包。
        
2.  “CDN”选择“使用华为CDN”。
    
3.  设置资源包下载的开始时间和结束时间。要求如下：
    
    | 要求 | 举例 |
    | :-- | :-- |
    | 开始时间和结束时间的生效时间均为用户设备的本地时间。 | \- |
    | 开始时间和结束时间只能选择到天。 | 
    \- 开始时间选择2024年4月2日，则默认开始时间为2024年4月2日0点。
    
    \- 结束时间选择2024年4月10日，则默认结束时间为2024年4月10日23点59分。
    
     |
    | 开始时间和结束时间最长间隔为14天。 | \- |
    | 资源包下载申请只有华为运营审批通过后，才能正式对外发布，因此请提前1~3天申请资源包下载任务，给华为运营预留时间进行审批。 | 
    
    申请资源包下载任务时，开始时间选择2024年4月2日，结束时间选择2024年4月10日。
    
    若华为运营审核通过，正式对外发布的时间为2024年4月5日，则当前资源包下载任务只能从2024年4月5日开始执行。
    
     |
    | 游戏资源包在用户客户端最长保留时间为14天，开始时间需要根据游戏首发或游戏发布更新版本的时间合理安排。 | 
    
    申请资源包下载任务时，开始时间选择2024年4月2日，结束时间选择2024年4月10日。
    
    下载任务在2024年4月2日审核通过并对外正式发布，此后符合条件的用户设备就会将资源包下载到设备本地，直到2024年4月10日任务结束。
    
    但您在4月25日才在华为应用市场上架游戏的最新版本，而此时用户设备的游戏资源包已经过了14天的最大保留时间，系统会自动删除设备本地的游戏资源包，从而导致用户下载游戏后无法加载下载的游戏资源包。
    
     |
    | 开始时间设置后如果更改，则结束时间自动清除，需要重新选择。 | \- |
    | 如果审核通过的时间已经晚于下载结束时间，则审核通过后任务会直接变为“任务结束”状态。 | \- |
    
4.  （可选）填写客户端的最小版本号。
    
    为了提升CDN资源利用率，开发者可以限制下载游戏资源包的游戏版本。请填写app.json5配置文件中的versionCode字段值。app.json5配置文件介绍请参见[配置文件标签](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/app-configuration-file#配置文件标签)。
    
    若设备上已安装的游戏版本低于versionCode，则无法下载游戏资源包。
    
    若未填写端侧最小版本号，所有游戏版本均可下载游戏资源包。
    
5.  填写资源包版本号。
    
    版本号用于跟踪不同资源包的下载任务，版本号要求不超过9位的整数，且必须高于已创建任务的版本号。重新编辑“草稿”、“预上线”、“任务结束”状态的资源包下载任务时，资源包版本号也不能低于已有的版本号。
    
6.  上传资源包。
    
    在“上传资源包”栏点击“选择文件”，上传提前准备好的游戏资源包。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/a1/v3/xZoa8c9tQ9qU8aBiAOdTzg/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T073541Z&HW-CC-Expire=86400&HW-CC-Sign=80D0FFAFA70532B96CCFA182FD24AFBE099F8A862F19CB41FF79F85C9F6AE82E)
    
    *   单个游戏的所有资源包后台下载任务中，可以上传至华为CDN的资源包总大小不超过200GB。
        
    *   上传资源包时，若提示空间已满，建议开发者优先删除草稿任务中的资源文件。
        
    
    资源包上传过程及最终状态分为如下几种：
    
    | 游戏资源包的文件状态 | 处理说明 |
    | :-- | :-- |
    | 上传中...进度x% | 等待资源包上传完成，如需停止上传，可以点击“取消上传”。 |
    | 上传失败 | 检查网络是否正常、资源包大小是否超过上限，如无异常，可点击“删除”将游戏资源包删除，并重新上传资源包。 |
    | 扫描中 | 等待游戏资源包扫描完成。 |
    | 扫描不通过，可能存在病毒 | 点击“删除”将游戏资源包删除，并检查包体中是否存在病毒，修复资源包后重新上传。 |
    | 扫描通过 | 表示游戏资源包上传成功。 |
    
7.  （可选）填写hotversion。
    
    开发者可以通过hotversion版本号指定下一级文件的存储路径。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/66/v3/Nb3PrDpVRS2cPWQFnnhRlQ/zh-cn_image_0000002594828932.png?HW-CC-KV=V1&HW-CC-Date=20260612T073541Z&HW-CC-Expire=86400&HW-CC-Sign=AE13A7B53CDF7111DB0925A2DD0C34D01A734260077E5F3909F914DF62FF9516)
    
    例如，资源包版本号为2.1，hotversion为2.1.0，资源包文件的存储路径如下：
    
    └──appid  10035 // 游戏APP ID
       ├──v2.1/ // 资源包版本号
       │  ├──v2.1.0/ // hotversion
       │  │  ├──button.png?v=20240223 // 资源包文件
       │  │  ├──font.ttf?v=20240210 // 资源包文件
       │  │  └──font.ttf?v=20240213 // 资源包文件
       │  └──v2.1.1/ // hotversion
       │     └──font.ttf?v=20240214 // 资源包文件
       └──v2.0/
    
8.  提交资源包下载任务。
    
    点击“提交申请”提交资源包下载任务。若暂不提交该任务，点击“保存草稿”，允许继续编辑后再提交申请。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/97/v3/KkTt5wrkQLWVFYkbb2UxBg/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T073541Z&HW-CC-Expire=86400&HW-CC-Sign=0C5754C8DCFA9BEDF96AB1ACA5E98749C4BA77CFAE582BC579E080A46F42A940)
    
    若列表中有“预上线”、“审核中”中的任一状态任务，则无法在其他任务详情页点击“提交申请”。
    

#### 提交下载任务

在[创建下载任务](#创建下载任务)时已提交申请，可跳过当前步骤。

在[创建下载任务](#创建下载任务)时保存为草稿，请继续编辑后再提交申请。具体步骤如下：

1.  在任务列表中找到“草稿”状态的任务，点击“操作”列中的“编辑”进入申请详情页。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/37/v3/l7pfBu8XTMWiWPX9vwD-MA/zh-cn_image_0000002625188379.png?HW-CC-KV=V1&HW-CC-Date=20260612T073541Z&HW-CC-Expire=86400&HW-CC-Sign=18E42457F7768CC8755F9B358EA730AF35B457FBC877F488F9AE468A73FFCD51)
    
2.  在申请页填写资源包信息，填写要求请参见[创建下载任务](#创建下载任务)。完成后，点击“提交申请”提交资源包下载任务，当前任务状态变更为“预上线”。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/98/v3/IGm9lxIpTOOR-ozUz0oy1Q/zh-cn_image_0000002625108523.png?HW-CC-KV=V1&HW-CC-Date=20260612T073541Z&HW-CC-Expire=86400&HW-CC-Sign=731446878D881FACC377FEDEBF3613648B989174454EA64C498ED95DC2D298DE)
    

#### 测试下载功能

正式发布下载任务前， 请在本地测试“预上线”状态的任务是否可以成功下载资源包。

#### \[h2\]打开资源包自动更新开关

请在HarmonyOS 5.1.0及以上版本测试设备的“游戏中心”客户端打开“我的 > 设置 > 服务管理 > 游戏服务”，打开“允许资源包自动更新”开关。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/8d/v3/f5K-4MyOSP6UWbJvykCeQw/zh-cn_image_0000002594669006.png?HW-CC-KV=V1&HW-CC-Date=20260612T073541Z&HW-CC-Expire=86400&HW-CC-Sign=96105FFA027DE6DA0D327D55EE848BD7B1FE674557C1078A426114912BB604DC "点击放大")

#### \[h2\]配置设备号

1.  输入如下命令行，获取测试设备的设备号。
    
    hdc shell bm get --udid
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/e3/v3/HkwI7pK4RmW482pNmeoiMw/zh-cn_image_0000002594828934.png?HW-CC-KV=V1&HW-CC-Date=20260612T073541Z&HW-CC-Expire=86400&HW-CC-Sign=1D4D4C59E64F1B05005C5BF78FABEA04231080CE1518A5E2805A506171D0706A)
    
2.  在AppGallery Connect页面点击“测试设备”后的“编辑”。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/3a/v3/8pp-sRjjRHmw5z1tamRp3g/zh-cn_image_0000002625188381.png?HW-CC-KV=V1&HW-CC-Date=20260612T073541Z&HW-CC-Expire=86400&HW-CC-Sign=CB079295A8C940FC56CAA459A582252CCFB190EC75698D8E0AD0A65074F4E84E)
    
3.  在输入框中最多添加10台测试设备的设备号，且使用英文逗号（,）间隔开，完成后点击“保存”。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/6f/v3/mvoKhaJ1S1-TjpvMX5vMCw/zh-cn_image_0000002625108525.png?HW-CC-KV=V1&HW-CC-Date=20260612T073541Z&HW-CC-Expire=86400&HW-CC-Sign=8D5B29ED67E15549413D63DE2AD3983EA2B98962116E2878C73DFE82B698ACDF)
    

#### \[h2\]验证方式

1.  如果游戏未安装，则安装游戏。
    
    // 输入命令行，安装游戏。
    // "entry-default-signed.hap"为示例包名，请根据您项目的实际包名替换使用。
    hdc install .\\entry-default-signed.hap
    
2.  如果游戏已安装，则执行模拟设备闲时命令。
    
    // 输入命令行，模拟设备满足闲时条件。
    hdc shell hidumper -s 1904 -a "-s 66272 7800"
    
3.  验证以上两个场景是否触发系统后台下载资源包：查看测试设备的通知栏出现下载任务，则系统后台下载资源包功能验证通过。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/1d/v3/kPjs7TvgT5S8SanGhjVpog/zh-cn_image_0000002594669008.png?HW-CC-KV=V1&HW-CC-Date=20260612T073541Z&HW-CC-Expire=86400&HW-CC-Sign=265915C151F07FDB67A6707C571D741EF4EF2F014BB58FC6B305019BD6BCBCD1 "点击放大")
    

#### 发布下载任务

1.  在任务列表找到“预上线”状态的任务，点击“操作”列中的“发布”。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/48/v3/tkB7epxxSDuL14ZUg1hkyw/zh-cn_image_0000002594828936.png?HW-CC-KV=V1&HW-CC-Date=20260612T073541Z&HW-CC-Expire=86400&HW-CC-Sign=0023F929CAB9EC0E01DD6A7B3D407DEFD725AD0F979A002C3DDD50862BC32428)
    
    在弹出的提示窗中点击“确认”。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/c7/v3/sVtXiBQxQ8-2HEm7TmjYbg/zh-cn_image_0000002625188383.png?HW-CC-KV=V1&HW-CC-Date=20260612T073541Z&HW-CC-Expire=86400&HW-CC-Sign=F946D4225AC1252C5214533200AA1C107EF5648A55E856DBB3BA2C666DE5DE96)
    
    发布该任务后，华为运营人员将在1~3个工作日内完成审批，请耐心等待。
    
    任务通过审批后，游戏资源包将在指定时间内向满足条件的用户设备进行推送。
    
2.  若需要终止已发布的任务，可以在任务列表中主动点击“终止”。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/93/v3/fG8jY3bBRrWas7LHDa0IAg/zh-cn_image_0000002625108527.png?HW-CC-KV=V1&HW-CC-Date=20260612T073541Z&HW-CC-Expire=86400&HW-CC-Sign=6450CA27BA487409CD38A111D7D82E389F92210F70FA1FD6F994A296705490ED)
    
    此时，系统将不再对该资源包进行自动下载。对于用户设备上已开始下载的游戏资源包不会立刻删除，而是在下一次启动自动更新时，删除下载时间大于7\*24小时的游戏资源包。
    

#### 下载任务状态说明

| 序号 | 状态 | 说明 |
| :-- | :-- | :-- |
| 1 | 草稿 | 填写信息后保存为草稿后的状态，草稿状态的任务支持“编辑”和“删除”。 |
| 2 | 预上线 | 提交申请后的状态，任务可以在这个状态下进行资源包下载测试。预上线状态的任务支持“发布”、“编辑”和“终止”。 |
| 3 | 审核中 | “预上线”状态的任务点击“发布”后的状态。审核中的任务不支持执行任何操作。 |
| 4 | 审核不通过 | 任务点击“发布”后提交到华为运营人员审核，审核不通过的状态。审核不通过的任务支持重新“编辑”。 |
| 5 | 已发布 | 任务审核通过后任务正式发布的状态，发布中的任务仅支持“终止”。 |
| 6 | 任务结束 | 本次下载任务执行结束或者被华为运营人员终止了任务。 |
| 7 | 任务暂停 | 被华为运营人员暂停了任务。 |