在线文档教程

环境变量 | Environment Variables

环境变量

控制应用程序配置和行为,而不更改代码。

某些电子行为是由环境变量控制的,因为它们比命令行标志和应用程序的代码更早初始化。

POSIX shell示例:

$ export ELECTRON_ENABLE_LOGGING=true $ electron

Windows控制台示例:

> set ELECTRON_ENABLE_LOGGING=true > electron

生产变量

以下环境变量主要用于在封装的Electron应用程序中运行时使用。

GOOGLE_API_KEY

Electron包含一个硬编码的API密钥,用于向Google的地理编码Web服务发送请求。由于此API密钥包含在Electron的每个版本中,因此通常会超出其使用配额。要解决此问题,您可以在环境中提供自己的Google API密钥。将下面的代码放置在主进程文件中,然后打开任何将进行地理编码请求的浏览器窗口:

process.env.GOOGLE_API_KEY = 'YOUR_KEY_HERE'

有关如何获取Google API密钥的说明,请访问此页面

默认情况下,新生成的Google API密钥可能不允许进行地理编码请求。要启用地理编码请求,请访问此页面

ELECTRON_NO_ASAR

禁用ASAR支持。该变量仅在分叉的子进程和设置的衍生子进程中受支持ELECTRON_RUN_AS_NODE

ELECTRON_RUN_AS_NODE

作为一个正常的Node.js进程启动进程。

ELECTRON_NO_ATTACH_CONSOLE窗

不要附加到当前控制台会话。

ELECTRON_FORCE_WINDOW_MENU_BARlinux

不要在Linux上使用全局菜单栏。

发展变量

以下环境变量主要用于开发和调试目的。

ELECTRON_ENABLE_LOGGING

将 Chrome 的内部日志记录打印到控制台。

ELECTRON_LOG_ASAR_READS

当 Electron 从 ASAR 文件读取时,请将读取偏移量和文件路径记录到系统tmpdir。可以将结果文件提供给 ASAR 模块以优化文件排序。

ELECTRON_ENABLE_STACK_DUMPING

Electron崩溃时,将堆栈跟踪打印到控制台。

如果crashReporter启动该环境变量将不起作用。

ELECTRON_DEFAULT_ERROR_MODE窗

当Electron崩溃时显示Windows的崩溃对话框。

如果crashReporter启动该环境变量将不起作用。