管理 H5 离线包
发布 H5 离线包后，您可以管理已发布的离线包。管理操作包括查看、暂停、结束发布、导出、删除 H5 离线包。查看离线包发布任务 进入 mPaaS 控制台，完成以下步骤：单击左侧导航栏的 实时发布>离线包管理 菜单。在 H5App 列表中，选择目标 H...
创建 H5 离线包
在创建 H5 离线包资源时，您需要填写基本信息和配置信息。前置任务 您已经在配置管理页面，完成 H5 离线包相关配置。详细信息，参见 配置离线包。关于此任务 您可以选择单个创建 H5 离线包，也可以选择以批量导入 H5 离线包文件的方式一次...
离线包分析
在页面右上方，单击 添加过滤条件 按钮，选择平台、应用版本、离线包或离线包版本，并选择数据分析的时间范围，即可查看相应的离线包分析数据。指标总览 指标 说明 下发次数 指客户端成功请求到离线包更新提醒的次数。若您下载了离线包但未...
离线包简介
离线包原理 您将从以下方面了解离线包原理：离线包结构 离线包类型 渲染过程 离线包结构 离线包是一个.amr 格式的压缩文件，将后缀 amr 改成 zip 解压缩后，可以看到其中包含了 HTML 资源和 JavaScript 代码等。待 H5 容器加载后，这些资源...
从 HTTP 层面观察离线包的行为（1）：下载离线包
mPaaS 客户端框架对离线包的下载行为作出深度的封装，开发者往往并不直接控制离线包的下载行为。离线包的下载过程大致如下：客户端向 MDS 服务端（cn-hangzhou-component-gw.cloud.alipay.com）发送请求，请求中提供了下载目标 H5 App 的 ...
配置 H5 离线包
您可以在实时发布平台上传、发布离线包，将离线包快速推送到客户端。关于离线包的详细介绍，请参考 离线包简介。在添加离线包之前，您需要添加离线包的相关配置。操作步骤 进入 mPaaS 控制台，完成以下步骤：单击左侧导航栏的 实时发布>离...
发布 H5 离线包
要发布您已经创建的离线包，您需要创建该离线包的发布任务并完成相关配置。您可以选择发布单个 H5 离线包，也可以选择批量发布多个离线包。操作步骤 发布单个离线包 进入 mPaaS 控制台，完成以下步骤：点击左侧导航栏的 实时发布>离线包...
如何保证离线包内容的安全性
为了保证离线包的安全，开发者可以开启离线包验签功能。验签的基本过程如下：开发者配置好一对公私钥，私钥放在服务端用于对离线包进行签名，公钥放在客户端，用于对签名对验证。在离线包发布平台，如果配置了签名私钥，平台下发的 amr ...
从 HTTP 层面观察离线包的行为（2）：更新指定离线包
当开发者在离线包发布平台上发布一个新的离线包版本时，客户端拉取更新包的基本过程如下：客户端向 MDS 服务端发送请求，请求中提供了需要更新的目标 H5 App 的 ID 和本地版本号。服务端返回该离线包的相关更新信息（如果存在）。客户端...
如何排查离线包验签失败的问题
问题定义 离线包验签的原理与作用如 离线包简介 中所述，验签失败并不会直接导致 H5 应用不可用，但会导致 H5 容器无法从本地获取到 H5 应用的资源，所有流量都会 fallback 到线上，对用户体验和性能有一定的影响。常见症状 网络正常的情况...
从 HTTP 层面观察离线包的行为（4）：fallback
若在某些情况下（例如，离线包本地验签失败），H5 容器无法从本地获取所需的资源，会转而从线上地址获取这些资源。基本过程如下：客户端向 MDS 服务端发送请求，请求中携带了本地已有的 H5 App 的 ID 和本地的版本号。服务端返回该离线包的...
实时发布流程
离线包>离线包管理：将不同的业务封装打包成离线包，通过发布平台下发，对客户端资源进行更新。开关配置>配置管理：实现各种开关的配置、修改、推送。可以按平台、白名单、百分比等进行有针对性地下发。白名单管理：为实时发布提供一个白...
生成 H5 离线包
生成一个离线包主要分为以下两步：构建前端.zip 包 在线生成.amr 包 构建前端.zip 包 根据离线包使用的场景不同，配置路径分为以下两种：全局资源包 普通资源包 说明 在同一个 H5 离线包中，全局资源包与普通资源包不可共存。离线包 ID（即...
离线包的加载过程是怎样的
离线包的基本加载过程见下图：
管理离线包
加载离线包 根据是否在客户端预置离线包，分为以下两种方式：预置离线包 加载远程离线包 预置离线包 不管网络情况如何，首页或登录页等页面都需快速加载。因此，可以将这部分资源打包为离线包、提前预置在工程中，以保证在离线情况下资源也...
如何排查离线包（H5应用或小程序）无法更新的问题
问题定义 当一个 H5 应用或小程序需要更新时，开发者通过 mPaaS 离线包发布平台上传这个 H5 应用的更新包或小程序的更新包，并赋予一个新的版本号。在客户端，App 会主动询问服务端某个 H5 应用或小程序的离线包是否存在版本更新，如果有，...
开发小助手的功能
离线包中心 在离线包中心，您可以查看离线包应用信息、已安装离线包列表、JsApis 列表和 Plugins 列表，还可以关闭离线包验签、一键更新离线包。说明：为了保证功能的完整性和独立性，离线包中心功能需要单独接入 离线包开发助手，更多详情...
快速开始
} 若您需要使用 预置离线包、自定义 JSAPI 和 Plugin 等功能，请将上方代码中的 initNebula 接口替换为下方代码中的 initNebulaWith 接口，传入对应参数对容器进行初始化。presetApplistPath：自定义的预置离线包的包信息路径。...
10.1.68 系列
V10.1.68.50（2022-06-30）H5 容器和离线包 修复 修复 APM 隐私权限弹框在加载 H5 后，首次打开小程序出现 register worker error 的问题。社交分享 新增 拆分微信、微博、QQ、钉钉及支付宝分享的 SDK，支持自行集成替换。更新 更新 ...
使用 H5 离线包
H5 离线包的使用可以分为以下四个部分：发布离线包 预置离线包 启动离线包 更新离线包 在本教程中为了说明和演示 H5 离线包的功能，采取了从发布到预置，再到启动，最后完成更新的流程。但是这一流程并非是使用 H5 离线包的必要条件。在...
使用 SDK（版本＝10.1.32）
} 若您需要使用 预置离线包、自定义 JSAPI 和 Plugin 等功能，需将上述功能的相关信息分别存储在以下默认的 bundle 中，否则功能不生效。名称 含义 MPCustomPlugins.bundle 自定义的 JSAPI 和 Plugin 路径。MPCustomPresetApps.bundle 预置...
使用 H5 离线包
在控制台的应用中配置离线包信息，参考 配置离线包。生成您自己前端 App 的离线包（或者使用我们的示例离线包），参考 生成离线包。在控制台上创建该离线包并上传，参考 创建离线包。将配置好的离线包发布到您的客户端 App 中，参考 发布离...
从 HTTP 层面观察离线包的行为(3)：更新全部离线包
iOS 和 Android 平台均提供了 API 实现一次请求所有离线包的更新信息，其基本过程如下：客户端向 MDS 服务端发送请求，请求中提供了本地已安装的所有 H5 App 的 ID 和本地版本号，外加一个特殊的 App ID：nebula-*-all。服务端返回所有符合...
iOS 常见问题
为什么控制台发布新版本离线包后客户端不能正常加载到新包 解答：在查看此问题解决方案前，确认您已理解 离线包更新原理，客户端不能正常加载新包，离线包渲染在任一阶段都有可能出错，下面将一一进行排查：查看全量更新离线包的 RPC 返回...
iOS 常见问题
控制台发布新版本离线包后，客户端不能正常加载到新的离线包 解答：在查看此问题解决方案前，确认您已理解 离线包更新原理，客户端不能正常加载新包，离线包渲染在任一阶段都有可能出错，下面将一一进行排查。查看全量更新离线包的 RPC ...
常见问题
JSAPI startapp 接口打开新的离线包时，TitleBar 变成自动透明模式？解答：需要传入 transparentTitle 参数控制 TitleBar 行为，可选参数包括：AUTO|YES|NO，详情请参考启动 参数文档。相关链接 接入 Android 常见问题 接入 iOS 常见问题
总览
使用离线包时通过预先下载该压缩包到本地，然后通过客户端打开，直接从本地加载离线包，从而最大程度地摆脱网络环境对 H5 页面的影响。本教程将带您一起体验和使用 H5 容器和离线包的基本能力。本教程一共分为以下 3 个部分：在 Xcode 中...
常见通用问题
JSAPI startapp 接口打开新的离线包时，TitleBar 变成自动透明模式？解答：需要传入 transparentTitle 参数控制 TitleBar 行为，可选参数包括：AUTO|YES|NO，详情请参考启动 参数文档。离线包验签的流程是什么样的？解答：为了保证离线包的...
10.1.60 系列
V10.1.60-beta.21（2019-12-19）H5 容器和离线包&小程序 新增 小程序支持 chooseLocation API。修复 修复 H5 页面自动化埋点数据不准确的问题。V10.1.60-beta.20（2019-12-15）移动分析 修复 修复 Crash 日志缺失页面栈信息。V10.1.60-beta...
Android 常见问题
解答：在离线包发布平台，如果您配置了签名私钥，平台下发的 amr 文件就会带上离线包的签名信息（通过私钥对离线包的 hash 值加密后得到的密文）。验签的时候会使用在项目中预置的公钥进行签名的验证（解密上一步的密文得到 hash 值，本地...
Android 常见问题
解答：在离线包发布平台，如果您配置了签名私钥，平台下发的 amr 文件就会带上离线包的签名信息（通过私钥对离线包的 hash 值加密后得到的密文）。验签的时候会使用在项目中预置的公钥进行签名的验证（解密上一步的密文得到 hash 值，本地...
管理离线包
离线包的管理操作包括：预置 H5 应用、利用全局资源包、更新 H5 应用、下载 H5 应用、安装 H5 应用、获取应用信息、校验安全签名以及删除本地应用。前置条件 您已完成接入配置。具体的操作步骤，查看 添加 SDK。您已经生成离线包。具体的...
移动网关常见问题
在离线包验签中有网的情况下，离线包应用可以正常打开；关闭网络，离线包应用无法打开。该如何排查？请参考 如何排查移动网关调用错误。在离线包验签中 H5 应用加载缓慢，该如何排查？请参考 如何排查移动网关调用错误。
自定义 JSAPI
自定义 JSAPI 路径和预置离线包信息 NSString*presetApplistPath=[[NSBundle mainBundle]pathForResource:[NSString stringWithFormat:@"DemoCustomPresetApps.bundle/h5_json.json"]ofType:nil];NSString*appPackagePath=[[NSBundle ...
H5 容器简介
强大的离线包能力 强大的离线包统一推包平台：通过 MDS 推包平台，能够迅速将离线包推送到客户端，保证客户端数据在短时间能够获得最新同步。预置离线包：针对特殊场景，支持在客户端预置，提高打开效率。广泛的生态基础 支持蚂蚁内部接入...
H5 应用及小程序加载失败：“系统繁忙，请稍候再试”
常见原因 mPaaS 框架在打开一个 H5 应用前，首先需要获知该应用离线包的基本信息，因此客户端会主动通过 RPC 接口 alipay.client.getUnionResource 去拉取离线包信息。如果离线包信息获取失败，或没有命中要打开的目标应用，容器会提示错误...
H5 应用及小程序加载失败：“系统繁忙，请稍后再试”
问题描述 开发者在完成基本接入后，尝试打开 H5 应用，但容器页面显示错误提示“系统繁忙，请稍后再试”，如下图：常见原因 mPaaS 框架在打开一个 H5 应用前，首先需要获知该应用离线包的基本信息，因此客户端会主动通过 RPC 接口 alipay....
快速开始
通过使用 H5 容器可以实现在应用内打开一个在线网页、前端调用 Native 接口、前端调用自定义 JSAPI、自定义 H5 页面的 TitleBar、使用 UC 内核等相关功能。使用 H5 离线包可以实现发布、预置、启动和更新离线包等相关功能。前置条件 若采用...
H5 容器自动化埋点
打开离线包页面的相关埋点集：SeedId 含义 H5_APP_REQUEST 请求离线包信息。H5_APP_LOAD_DATASOURCE 加载离线包信息。H5_AL_SESSION_FROM_NATIVE 容器已经启动。H5_APP_DOWNLOAD 离线包下载。H5_APP_UNZIP 离线包解压。H5_APP_POOL 包管理...
接口说明
installType Integer 安装时机，0：不预加载（只有进入离线包或小程序页面时才安装），1：预加载（离线包或小程序下载完成后则自动安装）。platform String 使用平台，分为 all（全平台）、Android 和 iOS。clientVersionMin String 客户端...
- 产品推荐
- 这些文档可能帮助您