操作方法：从 Android 设备导出崩溃日志 (logcat)

摘要

将 Esri 产品用于 Android 移动平台且应用程序崩溃时，可以检索生成的日志文件 (logcat) 以执行诊断和故障排除。 但是，由于并非所有这些产品均默认启用开发人员模式，因此只能使用 Android SDK 平台工具检索日志文件。

注： 一些 Esri 应用程序提供故障排除日志，可以从应用程序中获取这些日志，以帮助排除错误（请参阅以下来自 Field Maps 的屏幕截图作为示例）。 本文介绍了导出设备日志的工作流，而非专门从某个应用程序中导出日志。

过程

可以对未 Root 的 Android 设备执行以下工作流来提取日志文件。 但是，必须先在未 Root 的 Android 设备上激活开发人员模式才可重现错误以生成和提取日志文件。 需要在计算机上执行提取。

警告： 此工作流涉及使用 Android SDK 平台工具，但 Esri 不支持该工作流。

1. 在 Android 设备上，导航至设置 > 关于设备，然后点击内部版本号选项七次，即可启用开发人员模式。

注： 在某些 Android 设备上，可以通过设置 > 关于手机 > 软件信息访问内部版本号选项。

2. 导航回设置菜单 > 系统 > 高级，打开开发人员选项，然后启用 USB 调试选项。

3. 对于在 5.0 或更高版本上运行的 Android 设备，请将每个日志缓冲区的记录程序缓冲区大小增加至 4 MB。

注： 4MB 足够用来存储日志。 但是，您可以根据需要增加其大小。

4. 打开移动应用程序，然后重现错误。 随即生成日志文件。
5. 通过 USB 线将 Android 设备连接到计算机。 您可能会在设备上收到提示以允许访问手机数据。

6. 在您的计算机上创建一个文件夹用于存储日志，例如 C:\AndroidLog。
7. 下载 Android SDK 平台工具，并将内容提取到计算机。
8. 打开提取的 platform-tools 文件夹并确保 adb.exe 已存在。
9. 按 Ctrl + Shift，右键单击空白工作空间区域，然后选择在此处打开命令窗口或在此处打开 PowerShell 窗口。

• 在 Windows 10 中按下 Ctrl + Shift 并单击鼠标右键时，您可能没有在此处打开命令窗口选项。 您可以选择使用 PowerShell。
• 如果出于任何原因需要使用 Windows 命令提示符，则可以转至“任务栏”设置，并禁用将命令提示符替换为 Windows PowerShell 的选项。
• 可以通过右键单击 Windows 开始菜单以管理员身份打开命令提示符。

10. 在命令提示符/PowerShell 中，执行以下命令：
    1. 将以下示例代码中的输出路径更改为您在步骤 6 中创建的文件夹。
    2. 指定用于导出日志的文本文件的名称（扩展名为 .txt）。

adb logcat -v threadtime -d > C:\AndroidLog\logcat.txt

注： 如果该命令失败并出现如下错误： “adb：未将术语“adb”识别为 cmdlet、函数、脚本文件或可运行程序的名称。”，请尝试使用“.\adb”，而非“adb”运行相同的命令，如下所示。

.\adb logcat -v threadtime -d > C:\AndroidLog\logcat.txt

注： 导出过程开始后，您可能会在手机上收到提示以允许 USB 调试。 您必须单击确定以允许调试。

11. 现已使用详细记录将日志文件 (logcat.txt) 提取到到目标文件夹。

注： 有关了解日志文件的详细信息，请参阅阅读漏洞报告。