业务场景
典型场景如：安卓应用市场apk分发、手机/电视盒子ROM更新、离线地图包/游戏资源包下载、在线音频批量下载等。移动端是否必须上传流量才能使用PCDN？不需要，P2P节点布局中有路由器、运营商接入层/汇聚层节点等二级节点可以为客户App提供P2P...
管理 H5 离线包
发布 H5 离线包后，您可以管理已发布的离线包。管理操作包括查看、暂停、结束发布、导出、删除 H5 离线包。查看离线包发布任务 进入 mPaaS 控制台，完成以下步骤：单击左侧导航栏的 实时发布>离线包管理 菜单。在 H5App 列表中，选择目标 H...
创建 H5 离线包
在创建 H5 离线包资源时，您需要填写基本信息和配置信息。前置任务 您已经在配置管理页面，完成 H5 离线包相关配置。详细信息，参见 配置离线包。关于此任务 您可以选择单个创建 H5 离线包，也可以选择以批量导入 H5 离线包文件的方式一次...
离线包分析
通过离线包分析报告，您可以了解离线包的离线包下发次数、成功下载次数和使用次数。完成以下步骤，查看离线包分析报告：登录控制台，点击 产品与服务>移动开发平台 mPaaS，选择应用。从左侧导航栏进入 移动分析>组件使用分析>离线包分析 ...
使用 H5 离线包
H5 离线包的使用可以分为以下四个部分：发布离线包 预置离线包 启动离线包 更新离线包 在本教程中为了说明和演示 H5 离线包的功能，采取了从发布到预置，再到启动，最后完成更新的流程。但是这一流程并非是使用 H5 离线包的必要条件。在...
使用 H5 离线包
生成您自己前端 App 的离线包（或者使用我们的示例离线包），参考 生成离线包。在控制台上创建该离线包并上传，参考 创建离线包。将配置好的离线包发布到您的客户端 App 中，参考 发布离线包。单击 视频教程，查看对应的视频教程。预置离线...
离线包简介
离线包原理 您将从以下方面了解离线包原理：离线包结构 离线包类型 渲染过程 离线包结构 离线包是一个.amr 格式的压缩文件，将后缀 amr 改成 zip 解压缩后，可以看到其中包含了 HTML 资源和 JavaScript 代码等。待 H5 容器加载后，这些资源...
从 HTTP 层面观察离线包的行为（1）：下载离线包
mPaaS 客户端框架对离线包的下载行为作出深度的封装，开发者往往并不直接控制离线包的下载行为。离线包的下载过程大致如下：客户端向 MDS 服务端（cn-hangzhou-component-gw.cloud.alipay.com）发送请求，请求中提供了下载目标 H5 App 的 ...
管理离线包
加载离线包 根据是否在客户端预置离线包，分为以下两种方式：预置离线包 加载远程离线包 预置离线包 不管网络情况如何，首页或登录页等页面都需快速加载。因此，可以将这部分资源打包为离线包、提前预置在工程中，以保证在离线情况下资源也...
配置 H5 离线包
您可以在实时发布平台上传、发布离线包，将离线包快速推送到客户端。关于离线包的详细介绍，请参考 离线包简介。在添加离线包之前，您需要添加离线包的相关配置。操作步骤 进入 mPaaS 控制台，完成以下步骤：单击左侧导航栏的 实时发布>离...
发布 H5 离线包
要发布您已经创建的离线包，您需要创建该离线包的发布任务并完成相关配置。您可以选择发布单个 H5 离线包，也可以选择批量发布多个离线包。操作步骤 发布单个离线包 进入 mPaaS 控制台，完成以下步骤：点击左侧导航栏的 实时发布>离线包...
如何排查离线包（H5应用或小程序）无法更新的问题
在客户端，App 会主动询问服务端某个 H5 应用或小程序的离线包是否存在版本更新，如果有，服务端会告知客户端更新包的详细信息，客户端则根据信息按需主动下载新的资源包到本地并解压覆盖之前的离线资源文件，从而实现离线资源的更新。...
如何保证离线包内容的安全性
为了保证离线包的安全，开发者可以开启离线包验签功能。验签的基本过程如下：开发者配置好一对公私钥，私钥放在服务端用于对离线包进行签名，公钥放在客户端，用于对签名对验证。在离线包发布平台，如果配置了签名私钥，平台下发的 amr ...
常见问题
离线包（无论是预置还是下载）验签是否一定需要网络？解答：不需要，离线包验签不依赖网络。验签的时间点在什么时候？下载后解压的时自动验签还是在调用的时候才验签？解答：验签过程在下载离线包之后，解压离线包之前。若验签不通过会导致...
从 HTTP 层面观察离线包的行为（2）：更新指定离线包
当开发者在离线包发布平台上发布一个新的离线包版本时，客户端拉取更新包的基本过程如下：客户端向 MDS 服务端发送请求，请求中提供了需要更新的目标 H5 App 的 ID 和本地版本号。服务端返回该离线包的相关更新信息（如果存在）。客户端...
如何排查离线包验签失败的问题
问题定义 离线包验签的原理与作用如 离线包简介 中所述，验签失败并不会直接导致 H5 应用不可用，但会导致 H5 容器无法从本地获取到 H5 应用的资源，所有流量都会 fallback 到线上，对用户体验和性能有一定的影响。常见症状 网络正常的情况...
开发小助手的功能
离线包中心 在离线包中心，您可以查看离线包应用信息、已安装离线包列表、JsApis 列表和 Plugins 列表，还可以关闭离线包验签、一键更新离线包。说明：为了保证功能的完整性和独立性，离线包中心功能需要单独接入 离线包开发助手，更多详情...
从 HTTP 层面观察离线包的行为(3)：更新全部离线包
iOS 和 Android 平台均提供了 API 实现一次请求所有离线包的更新信息，其基本过程如下：客户端向 MDS 服务端发送请求，请求中提供了本地已安装的所有 H5 App 的 ID 和本地版本号，外加一个特殊的 App ID：nebula-*-all。服务端返回所有符合...
总览
使用离线包时通过预先下载该压缩包到本地，然后通过客户端打开，直接从本地加载离线包，从而最大程度地摆脱网络环境对 H5 页面的影响。本教程将带您一起体验和使用 H5 容器和离线包的基本能力。本教程一共分为以下 3 个部分：在 Xcode 中...
常见通用问题
离线包（无论是预置还是下载）验签是否一定需要网络？解答：不需要，离线包验签不依赖网络。验签的时间点在什么时候？下载后解压的是自动验签还是在调用的时候才验签？解答：验签过程在下载离线包之后，解压离线包之前。若验签不通过会导致...
从 HTTP 层面观察离线包的行为（4）：fallback
若在某些情况下（例如，离线包本地验签失败），H5 容器无法从本地获取所需的资源，会转而从线上地址获取这些资源。基本过程如下：客户端向 MDS 服务端发送请求，请求中携带了本地已有的 H5 App 的 ID 和本地的版本号。服务端返回该离线包的...
iOS 常见问题
为什么控制台发布新版本离线包后客户端不能正常加载到新包 解答：在查看此问题解决方案前，确认您已理解 离线包更新原理，客户端不能正常加载新包，离线包渲染在任一阶段都有可能出错，下面将一一进行排查：查看全量更新离线包的 RPC 返回...
实时发布流程
在 mPaaS 插件中打包生成版本升级包、热修复包、离线包等，上传到发布控制台。在控制台创建发布任务进行灰度发布、正式发布等。客户端再去拉取新的发布包进行升级、热修复、离线发布。另外，您还可以使用开关配置服务修改客户端代码处理...
生成 H5 离线包
生成一个离线包主要分为以下两步：构建前端.zip 包 在线生成.amr 包 构建前端.zip 包 根据离线包使用的场景不同，配置路径分为以下两种：全局资源包 普通资源包 说明 在同一个 H5 离线包中，全局资源包与普通资源包不可共存。离线包 ID（即...
Android 常见问题
解答：在离线包发布平台，如果您配置了签名私钥，平台下发的 amr 文件就会带上离线包的签名信息（通过私钥对离线包的 hash 值加密后得到的密文）。验签的时候会使用在项目中预置的公钥进行签名的验证（解密上一步的密文得到 hash 值，本地...
iOS 常见问题
控制台发布新版本离线包后，客户端不能正常加载到新的离线包 解答：在查看此问题解决方案前，确认您已理解 离线包更新原理，客户端不能正常加载新包，离线包渲染在任一阶段都有可能出错，下面将一一进行排查。查看全量更新离线包的 RPC ...
管理离线包
离线包的管理操作包括：预置 H5 应用、利用全局资源包、更新 H5 应用、下载 H5 应用、安装 H5 应用、获取应用信息、校验安全签名以及删除本地应用。前置条件 您已完成接入配置。具体的操作步骤，查看 添加 SDK。您已经生成离线包。具体的...
Android 常见问题
解答：在离线包发布平台，如果您配置了签名私钥，平台下发的 amr 文件就会带上离线包的签名信息（通过私钥对离线包的 hash 值加密后得到的密文）。验签的时候会使用在项目中预置的公钥进行签名的验证（解密上一步的密文得到 hash 值，本地...
移动网关常见问题
注意 虽然离线包验签过程可以保证离线包在传输和加载过程中不被篡改，但由于客户端的控制权完整掌握在用户手中，该机制并不能完全阻止在客户端上恶意破解和篡改 H5 逻辑的行为。因此，开发者需注意在前端上存在的各种潜在的安全风险。例如...
H5 容器简介
强大的离线包能力 强大的离线包统一推包平台：通过 MDS 推包平台，能够迅速将离线包推送到客户端，保证客户端数据在短时间能够获得最新同步。预置离线包：针对特殊场景，支持在客户端预置，提高打开效率。广泛的生态基础 支持蚂蚁内部接入...
H5 应用加载失败：白屏或显示不正确，伴有 Mixed ...
问题排查 当发现离线包页面无法正常加载时，可以通过浏览器对 WebView 进行调试。打开 Safari>开发>目标机器>目标离线包页面。点击刷新按钮，在 WebView 中重新加载页面。在控制台中检查是否有被阻止（Blocked）的页面资源。解决方法 保证...
H5 应用及小程序加载失败：“系统繁忙，请稍候再试”
目标离线包 ID：离线包管理页中的离线包 ID 要和工程代码中要打开的离线包 ID 一致；查看离线包发布状态，确认离线包是否存在一个处于发布状态的版本；查看离线包发布状态，确认离线包资源类型：必须为“普通资源包”；“全局资源包”不可...
H5 应用及小程序加载失败：“系统繁忙，请稍后再试”
问题描述 开发者在完成基本接入后，尝试打开 H5 应用，但容器页面显示错误提示“系统繁忙，请稍后再试”，如下图：常见原因 mPaaS 框架在打开一个 H5 应用前，首先需要获知该应用离线包的基本信息，因此客户端会主动通过 RPC 接口 alipay....
H5 应用加载失败：页面提示：“NoSuchKey.The ...
从这个原因出发，触发问题的流程一般为：客户端试图访问一个离线包中不存在的资源，客户端本地未命中，线上 fallback 地址也未命中，MDS 服务器返回该错误。问题排查步骤 根据原因分析，排查方向如下：客户端打开的 H5 App 的页面地址是否...
快速开始
H5 容器和离线包支持 原生 AAR 接入 和 组件化接入 两种接入方式。通过使用 H5 容器可以实现在应用内打开一个在线网页、前端调用 Native 接口、前端调用自定义 JSAPI、自定义 H5 页面的 TitleBar、使用 UC 内核等相关功能。使用 H5 离线包...
离线包的加载过程是怎样的
离线包的基本加载过程见下图：
接口说明
lazyLoad Integer 启动加载，目前都是 0 mainUrl String 含义和上传离线包中的一致 md5 String 离线包文件的md5 memo String 离线包的 h5.json 文件的下载地址 metaId Long 无意义 modifier 修改者 目前没有使用 platform 平台 含义和上传...
快速开始
本文介绍如何将 H5 容器和离线包组件接入到 iOS 客户端。H5 容器和离线包支持 基于 mPaaS 框架接入、基于已有工程且使用 mPaaS 插件接入 和 基于已有工程且使用 CocoaPods 接入 三种接入方式。通过使用 H5 容器和离线包可以实现初始化容器...
H5 容器自动化埋点
打开离线包页面的相关埋点集：SeedId 含义 H5_APP_REQUEST 请求离线包信息。H5_APP_LOAD_DATASOURCE 加载离线包信息。H5_AL_SESSION_FROM_NATIVE 容器已经启动。H5_APP_DOWNLOAD 离线包下载。H5_APP_UNZIP 离线包解压。H5_APP_POOL 包管理...
H5 应用加载失败：系统繁忙，请稍后再试
解决方法 确认控制台该离线包存在一个处于 发布 状态的离线包。确认工程代码中提供的 appId 是否正确：确认工程的 info.plist 中的 Product Version 字段中的代码是否在离线包覆盖的客户端范围内：点击这里 下载包含错误的代码示例。
- 产品推荐
- 这些文档可能帮助您