EloView 应用和内容部署错误的故障排除
适用对象: EloView 管理的 Android 设备 | 最后更新: 2026年11月11日
当应用程序或其他内容未能在您的 EloView 设备上下载、安装或播放时,请使用此故障排除指南。
⚠️ 开始之前
- 写下完整的错误消息、代码、内容名称和故障的确切时间。
- 检查设备是否在线,以及所需内容是否已正确分配给它。
- 如果使用计划,验证设备的本地系统时间、时区设置和活动计划窗口。
- 注意: 下载、安装和播放是独立的步骤。成功的下载并不能保证应用程序已安装或成功启动。始终检查设备的最新事件、内容版本和计划,以确认当前正在运行的内容。
选择下一步
识别您在屏幕或门户中观察到的内容,并使用下面的起始链接:
| 您看到的内容 | 从这里开始 |
|---|---|
| 下载正在等待、暂停或失败 | 检查连接、可用存储以及内容是否仍然可用。请参阅 下载和安装代码。 |
| APK 已下载但无法安装 | 检查 APK 文件、可用存储和兼容性。请参阅 应用程序安装错误。 |
| 内容已安装但无法播放 | 检查 活动计划、应用允许列表、内容格式和任何启动消息。 |
| 网页无法加载 | 请参阅 网站和 WebView 错误。 |
| 消息为空、不清晰或显示为空 | 捕获高质量的屏幕截图,并 联系 Elo 支持,如果本指南中的故障排除步骤没有解决问题。 |
如何读取代码
代码的含义很大程度上取决于出现的位置。同一个数字可以被软件套件的不同部分使用。始终结合 完整的错误消息 和 内容类型 以及数字代码一起使用。代码和设置可能因设备型号和固件/软件版本而异。
示例: 代码 -1005 可能表示文件状态中的无效 ZIP,或者在与 SSL_ERROR_CODE 一起显示时表示证书验证问题。代码 -1000 在与 CONTENT_NOT_VALID 一起显示时可能表示无效的下载 URL 或无效内容。如果消息和数字代码不一致,则将 两个 值提供给 Elo 支持。
下载和安装代码
当 EloView 报告文件或内容状态时,请使用这些条目。建议的原因是故障排除的起点;仅凭代码可能无法确定确切的根本原因。
💡 颜色编码指南: 绿色状态 表示操作成功。 红色状态 突出显示关键错误、安全阻止或需要立即采取行动的签名不匹配。标准的灰色/黑色状态表示等待、暂停或标准的网络行为。
| 代码和消息 | 它的含义 | 该怎么办 |
|---|---|---|
| -1000 INVALID_DOWNLOAD_URL | 设备未接收到可用的下载 URL。 | 确认内容存在并正确分配。重试部署。如果问题仍然存在,请联系 Elo 支持。 |
| -1001 DOWNLOADING_FAILURE | 内容未能成功下载。 | 检查设备连接、网络访问和可用的系统存储。恢复稳定连接后重试部署。 |
| -1002 CHECKSUM_FAIL | 下载的文件与预期的加密哈希不匹配。 | 重试下载。如果持续失败,请请内容拥有者验证原始文件并上传正确的副本。 |
| -1003 APK_SIGN_MISMATCH | 新 APK 签名与要求或当前安装的签名不兼容。 | 请求应用程序提供商提供一个签名为已安装应用程序及目标设备的正确凭证的更新 APK。 |
| -1004 INVALID_APK | 应用程序安装包 (APK) 被拒绝。 | 请开发人员/提供商验证文件是一个完整的、有效的 APK,并与设备架构兼容。请参阅 应用程序安装错误。 |
| -1005 INVALID_ZIP | 无法成功提取压缩的 ZIP 文件。 | 请内容拥有者测试、在本地重新构建档案并上传新的档案文件。 |
| -1006 INVALID_WEB | 下载的网页部署内容无效。 | 请内容拥有者验证网页包内容、启动页面索引和相关的必需资产。 |
| -1007 EMPTY_ZIP | ZIP 存档中没有可用或可识别的内容。 | 检查所有计划文件是否成功打包并上传更正的档案。 |
| -1008 INVALID_MEDIA | 媒体文件类型无效或完全不受支持。 | 检查文件格式是否符合设备的官方支持内容类型。注意:更改文件扩展名并不会转换物理文件容器。 |
| -1009 INVALID_VIDEO | 视频文件无效或不受支持。 | 确保视频是经过适当编码的 MP4,适合目标硬件。与内容创建者检查活动编码、分辨率和整体文件完整性。 |
| -1010 INVALID_APK_SIGN | 无法验证 APK 的签名。 | 请应用程序提供商检查包签名安全配置和与已安装应用程序的兼容性。 |
.mp4 容器或支持的文件名扩展名并不保证编码流内部会播放,如果不满足编码要求。进度和计划内容
下载和安装进度
| 代码和状态 | 这代表什么 | 该怎么办 |
|---|---|---|
| 1000 DOWNLOAD_SUCCESS | 文件下载成功完成。 | 接下来检查设备应用程序的安装和播放情况。 |
| 1001 INSTALL_SUCCESS | 应用程序安装完成。 | 确认预期版本是否正常打开和播放。 |
| 1002 DOWNLOADING_PAUSE | 下载当前被暂停。 | 如果它一直保持暂停状态,检查网络连接和可用的设备存储。 |
| 1003 YET_TO_DOWNLOAD | 下载尚未开始。 | 检查活动设备连接、部署分配和计划时间。 |
| 1004 DOWNLOADING | 下载当前在排队或正在进行中。 | 监控下载进度。如果下载停滞,检查系统连接状态和可用存储。 |
计划状态
| 代码和状态 | 这代表什么 | 该怎么办 |
|---|---|---|
| 0 SCHEDULE_LAUNCH_SUCCESS | 计划内容已成功启动。 | 验证当前设备屏幕上播放的是否是正确的目标内容。 |
| 100_SCHEDULE_PENDING | 内容仍需下载或安装。 | 检查关联的文件下载状态,并给予适当时间以完成。 |
| -99 SCHEDULE_LAUNCH_FAILURE | 计划内容无法启动。 | 确认安装完成,并验证应用程序是否可以打开。如果无法打开,请联系应用程序创建者或 Elo 支持。 |
| -98 SCHEDULE_NOT_WHITELISTED | 不允许应用程序播放。 | 请您的 EloView 管理员在系统应用程序允许列表中启用目标包。 |
| -97 SCHEDULE_DOWNLOAD_INSTALL_FAILURE | 计划内容下载或安装失败。 | 查找相关文件或安装错误,并遵循本指南中的匹配步骤。 |
🕒 如果计划未按预期行为运行:
验证设备的系统日期、本地时间、时区、计划日期和播放窗口。确认所有计划内容已完全下载并安装。检查应用程序是否被允许根据您组织的设备策略运行。
注意: “等待” 不是成功状态。如果历史记录包含失败和成功,请在决定问题是否仍然存在之前,比较内容版本和计划。
网站和 WebView 错误
WebView 在设备上显示网站内容。使用这些错误代码来识别加载网页或其底层资源的问题。在应用修复之前,请始终检查完整的原始错误消息。
| 代码和消息 | 检查内容 |
|---|---|
| -2002 ERROR_HOST_LOOKUP | 无法解析网站或代理主机名。检查 URL、设备网络连接、DNS 和代理设置。 |
| -2003 ERROR_UNSUPPORTED_AUTH_SCHEME | 网站使用不支持的身份验证方法。请网站管理员确认兼容性。 |
| -2004 ERROR_AUTHENTICATION | 网站身份验证失败。验证凭据、登录要求和会话过期限制。 |
| -2005 ERROR_PROXY_AUTHENTICATION | 代理身份验证失败。请您的本地网络管理员确认代理访问和授权凭据。 |
| -2006 ERROR_CONNECT | 设备无法连接到服务器。检查网络访问并确认服务器是否在线。 |
| -2007 ERROR_IO | 网络读取/写入操作失败。检查是否存在中断的物理/无线连接和服务器端错误。 |
| -2008 ERROR_TIMEOUT | 连接超时。检查网络稳定性和整体网站响应时间。 |
| -2009 ERROR_REDIRECT_LOOP | 页面重复重定向。请网站管理员检查登录重定向、cookie 和 HTTP 重定向规则。 |
| -2010 ERROR_UNSUPPORTED_SCHEME | URL 使用不支持的方案协议。检查地址和重定向。 |
| -2011 ERROR_FAILED_SSL_HANDSHAKE | 无法建立安全连接。检查设备系统时钟、网站 SSL 证书和网络 TLS 要求。 |
| -2012 ERROR_BAD_URL | URL 格式不正确。检查地址是否缺少、拼写错误或有误字符。 |
| -2013 ERROR_FILE | 无法访问所需文件。验证文件的目录位置和本地可用性。 |
| -2014 ERROR_FILE_NOT_FOUND | 请求的文件或资产资源未找到。请内容拥有者验证相对文件路径和包内容。 |
| -2015 ERROR_TOO_MANY_REQUESTS | 在页面加载期间发生了太多请求。请网站开发人员检查重复查询、资产或快速重载。 |
您可能遇到的其他网页消息:
- 1 / ERROR_OK: 网站内容状态成功。确认设备屏幕上是否显示正确的网页。
- -1005 / SSL_ERROR_CODE: 网站 SSL 证书可能不受信任、过期、尚未生效或针对与主机名不匹配的情况而签发。请更正设备时钟或请您的网络管理员解决服务器证书错误。
- -1000 / CONTENT_NOT_VALID: 网络内容未被识别为有效的支持内容类型。请内容拥有者验证文件,并确保在上传过程中选择了正确的内容类型。
应用程序安装错误
Android 系统安装结果消息可能提供比 EloView 用户界面状态更深入的详细信息。如果您的设备诊断日志中出现以下任何结果,请根据下面的指南操作。您的应用程序开发者或 Elo 支持可以帮助解读这些结果。
| Android 结果 (代码) | 含义和下一步 |
|---|---|
| INSTALL_FAILED_ALREADY_EXISTS (-1) | 该包已安装。确认是否打算进行更新。 |
| INSTALL_FAILED_INVALID_APK (-2) | APK 被拒绝。请从应用程序提供商那里获取经过验证的完整包。 |
| INSTALL_FAILED_INVALID_URI (-3) | 安装程序无法定位或使用包的位置。请支持人员检查安装程序输入。 |
| INSTALL_FAILED_INSUFFICIENT_STORAGE (-4) | 设备上的安装空间不足。仅删除批准的未使用内容。注意:安装可能需要比 APK 原始大小更多的工作空间。 |
| INSTALL_FAILED_UPDATE_INCOMPATIBLE (-7) | 更新与已安装的包不兼容。请提供方检查签名兼容性。 |
| INSTALL_FAILED_OLDER_SDK (-12) | 设备的 Android 操作系统版本过旧,不适合此应用程序。获取兼容版本或讨论固件/设备更新。 |
| INSTALL_FAILED_NEWER_SDK (-14) | 设备 SDK 比包配置允许的版本更新。请向开发人员索要兼容版本。 |
|
INSTALL_FAILED_CPU_ABI_INCOMPATIBLE (-16) / INSTALL_FAILED_NO_MATCHING_ABIS (-113) |
应用程序的本地编译二进制文件与设备的 CPU 架构不匹配。获取针对目标设备配置的构建。 |
| INSTALL_FAILED_VERSION_DOWNGRADE (-25) | 该 APK 的 versionCode 低于已安装在设备上的版本。请从提供方获取正确的更新。 |
| INSTALL_FAILED_MISSING_SPLIT (-28) | 安装缺少必需的拆分包。获取完整的应用程序包,采用支持的部署格式。 |
|
INSTALL_PARSE_FAILED_NO_CERTIFICATES (-103) / INSTALL_PARSE_FAILED_INCONSISTENT_CERTIFICATES (-104) |
签名证书信息完全缺失或不一致。请提供方验证并重建签名包。 |
| INSTALL_FAILED_INTERNAL_ERROR (-110) | 发生意外的内部 Android 安装错误。请提供完整的日志详细信息和设备规格,联系 Elo 支持。 |
🔍 如果怀疑签名或包有效性是原因:
请应用程序开发者仔细检查并比较包名称、签名证书、versionCode、最低 Android 操作系统要求以及处理器/架构支持。注意:在本地重命名 APK 文件并不会使其成为有效包,而新签名的 APK 可能与现有安装不兼容。
解决持续错误并获取帮助
如果代码缺失或描述似乎不正确
空白或无效代码并不意味着部署成功。保存完整事件日志的截图,并检查预期应用程序是否确实下载、安装并启动。如果一个代码指向签名问题,但设备报告不同的问题,请将两个消息提供给 Elo 支持。避免仅根据代码号码进行破坏性的系统更改。
示例:
- 下载成功,然后出现 -1010: 文件传输完成,但签名验证失败。请应用程序开发者验证 APK 与当前安装版本的兼容性。
-
计划报告 -97: 首先检查计划内容的文件状态。如果显示
-1001,请解决下载问题,然后再进行计划启动故障排除。 - 网站报告 -2002: 检查 URL 地址和网络名称解析(DNS)。重新安装无关的应用程序不会修复主机名查找问题。
本地安装故障排除
如果管理员需要隔离 APK 问题,请遵循链接的 Elo 指示在批准的测试设备上手动安装。如果安装本地应用程序 灰显,Elo 指示要求在 EloView 门户中启用自动播放 设备,并应用该设置。注意,成功的本地安装并不保证云下载、CDN 或计划任务正常工作。
📞 联系 Elo 支持之前
请收集以下信息以加快您的支持请求:
- 设备型号和序列号
- Android 操作系统和 Elo 平台软件版本
- EloView 门户版本(如果可用)
- 内容名称和具体应用程序版本
- 完整的错误消息和随附的截图
- 确切的失败时间戳和时区
- 部署是立即进行还是计划进行
- 可用设备存储容量
- 已完成的故障排除步骤
- 如果请求,请包括诊断系统日志
⚠️ 重要:请不要在支持票或通信中包含密码、私有签名密钥或 API 访问令牌。
应用修复后,请确认预期版本是否正常安装、打开并播放。对于计划内容,验证在预期计划窗口中的播放情况,并检查最新的 EloView 状态。
相关帮助链接
Please report any broken links by emailing elo.support@zebra.com and include a link to the knowledge article