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

在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/13/v3/D6vdMfz4Soyg-ROKtXexcA/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260709T132551Z&HW-CC-Expire=86400&HW-CC-Sign=47F77088481D984B648A39AB05356A5B5CAFCD7824C27D4681345C4F72DBAD9B)

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

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/5c/v3/3xDItcd0RxK3L2gj7AUNjg/zh-cn_image_0000002634009458.png?HW-CC-KV=V1&HW-CC-Date=20260709T132551Z&HW-CC-Expire=86400&HW-CC-Sign=97ECB797AEA2B4655C8AD658C7707FD6EBFAF256FB27977E7744B54C73D8B781)

#### 创建下载任务

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

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/1c/v3/ehh8smkbTSWrUfoc0yDz7Q/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260709T132551Z&HW-CC-Expire=86400&HW-CC-Sign=CAAA7D4396DB5794C95818F751FB6C3B591DACECA3314D988242CF9C50AD2FDE)

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

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

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/cc/v3/Z4yoUnLJRsKP16FHQ7azXQ/zh-cn_image_0000002664208607.png?HW-CC-KV=V1&HW-CC-Date=20260709T132551Z&HW-CC-Expire=86400&HW-CC-Sign=910B04562D0701542073BBC1E40AC250E3C1C8A25BF33B848B8F13C4F773ADA3)

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

\- 应用未内置下载器，建议选择“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/bf/v3/JfpnZUYeQ4KynygNl-zatg/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260709T132551Z&HW-CC-Expire=86400&HW-CC-Sign=BD5055870DFF7DF9E74F4BEC521DDD4E7BAE1A75273DF56CE1824B091C0118E6)

除了支持在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/4b/v3/q4iwb0LyTzOlZjhd0p6lWQ/zh-cn_image_0000002664328667.png?HW-CC-KV=V1&HW-CC-Date=20260709T132551Z&HW-CC-Expire=86400&HW-CC-Sign=D333CA2DC51790D28AF59D2B2051B94033109B357F24096D3DEAC464C9B5D71A)

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/1d/v3/Y8X_VIHuTkKAbBW16IhfHg/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260709T132551Z&HW-CC-Expire=86400&HW-CC-Sign=89509F71384CA7356B6E670CFAB1BE316F5CB006EF9B444DE6E5349602BF6681)
    
    *   单个游戏的所有资源包后台下载任务中，可以上传至华为CDN的资源包总大小不超过200GB。
        
    *   上传资源包时，若提示空间已满，建议开发者优先删除草稿任务中的资源文件。
        
    
    资源包上传过程及最终状态分为如下几种：
    
    | 游戏资源包的文件状态 | 处理说明 |
    | :-- | :-- |
    | 上传中...进度x% | 等待资源包上传完成，如需停止上传，可以点击“取消上传”。 |
    | 上传失败 | 检查网络是否正常、资源包大小是否超过上限，如无异常，可点击“删除”将游戏资源包删除，并重新上传资源包。 |
    | 扫描中 | 等待游戏资源包扫描完成。 |
    | 扫描不通过，可能存在病毒 | 点击“删除”将游戏资源包删除，并检查包体中是否存在病毒，修复资源包后重新上传。 |
    | 扫描通过 | 表示游戏资源包上传成功。 |
    
7.  （可选）填写hotversion。
    
    开发者可以通过hotversion版本号指定下一级文件的存储路径。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/8a/v3/rKP7V3pJQz-XA1FL5S5H_w/zh-cn_image_0000002633849556.png?HW-CC-KV=V1&HW-CC-Date=20260709T132551Z&HW-CC-Expire=86400&HW-CC-Sign=B35B1F8653238C7668AC82C0F142565DD7E17C2972B718F611384FB919F52006)
    
    例如，资源包版本号为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/d4/v3/KyDiTUvtTIq3r3uwwLbgCQ/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260709T132551Z&HW-CC-Expire=86400&HW-CC-Sign=60ED2CA6E8939AFB6730390174A9AF87883E7281BE54EDAEDF0A54E8AF58C798)
    
    若列表中有“预上线”、“审核中”中的任一状态任务，则无法在其他任务详情页点击“提交申请”。
    

#### 提交下载任务

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

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

1.  在任务列表中找到“草稿”状态的任务，点击“操作”列中的“编辑”进入申请详情页。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/37/v3/rorcvt2bT4iz6mVKMljg5w/zh-cn_image_0000002634009460.png?HW-CC-KV=V1&HW-CC-Date=20260709T132551Z&HW-CC-Expire=86400&HW-CC-Sign=F4F04F039379FEF0F006FABB570A305C684D959B1AEA3269648D213F15732F30)
    
2.  在申请页填写资源包信息，填写要求请参见[创建下载任务](#创建下载任务)。完成后，点击“提交申请”提交资源包下载任务，当前任务状态变更为“预上线”。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/0b/v3/AG04k_bsRvGCIJk2-7EYAw/zh-cn_image_0000002664208609.png?HW-CC-KV=V1&HW-CC-Date=20260709T132551Z&HW-CC-Expire=86400&HW-CC-Sign=057729A98A403F703F5A3DC9508E826BEFE01B4EA99EA591331D1F900F9ECAF9)
    

#### 测试下载功能

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

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

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

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/9c/v3/k1qbmaM6TfeycujNXZN7PQ/zh-cn_image_0000002664328669.png?HW-CC-KV=V1&HW-CC-Date=20260709T132551Z&HW-CC-Expire=86400&HW-CC-Sign=8063E0968F31B6E9A05CC067B896877F4F9A716DAC09F48057CB071E98ADF12D "点击放大")

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

1.  输入如下命令行，获取测试设备的设备号。
    
    hdc shell bm get --udid
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/3e/v3/-tldN-MvT2KYISCeaxlSFg/zh-cn_image_0000002633849558.png?HW-CC-KV=V1&HW-CC-Date=20260709T132551Z&HW-CC-Expire=86400&HW-CC-Sign=F273DC4D16435900F9DCB55CF88F3DCC66B246A4EF27F02B1000F12935933A14)
    
2.  在AppGallery Connect页面点击“测试设备”后的“编辑”。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/f7/v3/8ef45AJKR3qN8-kTpKBx5w/zh-cn_image_0000002634009462.png?HW-CC-KV=V1&HW-CC-Date=20260709T132551Z&HW-CC-Expire=86400&HW-CC-Sign=16A55687E1A889481160D6FFFBB37A303BFBED294033981A51EE18A4B352662C)
    
3.  在输入框中最多添加10台测试设备的设备号，且使用英文逗号（,）间隔开，完成后点击“保存”。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/e2/v3/Lb8m8RigSvihytWJTVFGKw/zh-cn_image_0000002664208611.png?HW-CC-KV=V1&HW-CC-Date=20260709T132551Z&HW-CC-Expire=86400&HW-CC-Sign=A3525E2717B71D0CF8AEACD54A95A361CBC92B259818A1883EB8D77A7B92F53E)
    

#### \[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/37/v3/CCAH_tIrR5CECho_hk4G_A/zh-cn_image_0000002664328671.png?HW-CC-KV=V1&HW-CC-Date=20260709T132551Z&HW-CC-Expire=86400&HW-CC-Sign=740E553E3D77FC6F3A09A14B1C651170B93F576BD694C0AA03DD720DF119DA13 "点击放大")
    

#### 发布下载任务

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

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

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