Electron中文文档

新手 642625556  中级 685983304 高级 602866851 Q群区别?

推荐版:3.0.9   测试版:4.0.0-beta.7   极客版:4.0.0-nightly.20181010  

崩溃日志报告

将崩溃日志提交给远程服务器

参见: process, renderer process

以下是一个自动提交崩溃日志到服务器的示例

const {crashReporter} = require('electron')

crashReporter.start({
  productName: 'YourName',
  companyName: 'YourCompany',
  submitURL: 'https://your-domain.com/url-to-submit',
  uploadToServer: true
})

构建一个用于接受和处理崩溃日志的服务,你需要以下工程

Or use a 3rd party hosted solution:

崩溃日志被保存在本地的应用特有的临时文件夹中。 对于YourName对象中的productName,崩溃报日志将被储存在临时文件夹中名为YourName Crashes的文件文件夹中。 在启动崩溃报告器之前,您可以通过调用app.setPath('temp', 'my/custom/temp') API来自定义这些临时文件的保存路径

方法

crashReporter 模块具有以下方法:

crashReporter.start(options)

  • options Object
    • companyName 字符串 - 公司名称 (可选).
    • submitURL 字符串 - 崩溃日志将以POST的方式发送给此URL.
    • productName 字符串(可选) - 默认为 app.getName().
    • uploadToServer 布尔型(可选) - 控制是否将崩溃日志发送给服务器,默认为true.
    • ignoreSystemCrashHandler 布尔型(可选) - 默认为false.
    • extra 对象(可选) - 一个随崩溃日志发送的对象. 只有字符串属性能够被正确发送. 不支持发送嵌套对象,且属性名称和属性值必须小于64个字符长度.
    • crashesDirectory String (可选)-用于临时存储 crashreports 的目录 (仅在崩溃报告器通过 process.crashReporter.start 启动时使用).

你需要调用任何其他的crashReporter API,您必须调用此方法. 在每个需要收集崩溃日志的进程 (主进程 / 渲染器进程) 中,也必须先调用此方法. 从不同的进程调用时, 可以传不同的配置给 crashReporter. start

注意 child_process 模块创建的子进程将无法访问 Electron 模块。 因此, 要收集它们的故障报告, 请用 process.crashReporter.start 代替。 传递与上面相同的选项以及一个名为 crashesDirectory 的附加项, 它应指向一个目录, 以便临时存储崩溃报告。 你可以调用 process.crash() 使子进程崩溃,来测试结果。

注意: 要从 Windows 中的子进程收集崩溃报告, 您也需要添加这样额外的代码。 这将启动一个进程来监视和发送崩溃报告。 用适当的值去替换 submitURL productName crashesDirectory

注意: ,如果您在第一次调用 start 后需要发送 附加的/更新的 extra 参数, 在 macOS 上,你可以调用 addExtraParameter 。而在 Linux 和 Windows 上,则使用 新的/更新的 extra 参数,再次调用 start 即可。

 const args = [
   `--reporter-url=${submitURL}`,
   `--application-name=${productName}`,
   `--crashes-directory=${crashesDirectory}`
 ]
 const env = {
   ELECTRON_INTERNAL_CRASH_SERVICE: 1
 }
 spawn(process.execPath, args, {
   env: env,
   detached: true
 })

注意:在macOS上,Electron使用一个crashpad客户端来收集并报告崩溃信息。 如果要启用崩溃报告,则需要在主进程使用crashReporter.start初始化crashpad, 不管你想收集哪个进程的报告。 使用这种方式初始化后,crashpad将处理从所有进程收集的崩溃报告。 你仍然需要从渲染器进程或子进程中调用crashReporter.start ,否则崩溃报告将不包含companyName, productName和任何extra信息。

crashReporter.getLastCrashReport()

返回 CrashReport:

返回上次崩溃报告的日期和ID。如果没有崩溃报告 发送或crash reporter尚未开始,则返回null

crashReporter.getUploadedReports()

返回 CrashReport[]:

返回所有上传的崩溃报告。每个报告都包含日期和上传ID。

crashReporter.getUploadToServer()LinuxmacOS

返回 Boolean - 是否已将报告提交到服务器。通过start 方法或 setUploadToServer设置。

注意: 这个API仅可从主进程调用。

crashReporter.setUploadToServer(uploadToServer)LinuxmacOS

  • uploadToServer Boolean macOS - 是否将报告提交到服务器.

通常, 是否提交是由用户对系统进行偏好设置而决定的。不能在 start 之前调用该方法,否则无效.

注意: 这个API仅可从主进程调用。

crashReporter.addExtraParameter(key, value)macOS

  • key String - 参数键,长度必须小于64个字符
  • value String - 参数值, 长度必须小于64个字符

设置一个在发送崩溃报告时将额外包含的参数。 当调用 start 时, 除了通过 extra 选项设置的值之外, 此处指定值也将被发送。 此 API 仅在 macOS 上可用, start 首次调用后, 如果您希望在在 Linux 和 Windows 上添加或更新额外参数, 您可以更新 extra 选项并再次调用 start

crashReporter.removeExtraParameter(key)macOS

  • key String - 参数键,长度必须小于64个字符

从当前设定的参数中移除一个额外的参数, 以便它不会与崩溃报告一起发送。

crashReporter.getParameters()

查看传递给崩溃报告的所有当前参数。

崩溃报告内容

崩溃报告将发送下面 multipart/form-dataPOST 型的数据给 submitURL:

  • ver String - Electron 的版本.
  • platform String - 例如 'win32'.
  • process_type String - 例如 'renderer'.
  • guid String - 例如 '5e1286fc-da97-479e-918b-6bfb0c3d1c72'.
  • _version String - package.json 里的版本号.
  • _productName String - crashReporteroptions 对象中的产品名字
  • prod String - 基础产品名字. 在这种情况下为 Electron.
  • _companyName String - crashReporteroptions 对象中的公司名称
  • upload_file_minidump File - minidump 格式的崩溃报告
  • All level one properties of the extra object in the crashReporteroptions object.


相关npm包集合




相关站点资源





官方指南

常见问题 (FAQ)

指南和教程

详细教程

API 参考

自定义 DOM 元素:

主进程可用的模块:

渲染进程(网页)可用的模块:

两种进程都可用的模块:

开发

  • electron不支持prompt对话框怎么办?
  • electron如何利用await解决smalltalk对话框异步执行的问题
  • JS开发者社区

    和大家在一起

    新手/专属新手 642625556
    中级/30元中级 685983304
    高级/50元高级 602866851
    PHP/福利PHP 218127186