2.8 KiB
Variáveis de ambiente
Controla as configurações e comportamento sem modificar o código
Certos comportamentos do Electron são controlados por variáveis de ambiente que são inicializadas antes do código do aplicativo e da chamada da linha de comando.
Exemplo no POSIX shell:
$ export ELECTRON_ENABLE_LOGGING=true
$ electron
Exemplo no prompt de comando do Windows:
> set ELECTRON_ENABLE_LOGGING=true
> electron
Variáveis de produção
As seguintes variáveis de ambiente são destinadas principalmente para o uso em tempo de execução, empacotadas nas aplicações Electron.
GOOGLE_API_KEY
O Electron já vem com uma chave para API inclusa para fazer requisições para o serviço de geolocalização do Google. Por causa da chave da API vir inclusa em cada versão do Electron, frequentemente excede a cota de uso. Para contornar isso, você pode informar sua própria chave da API do Google nas variáveis de ambiente. Informe o código no seu arquivo principal, antes do browser ser aberto, isso fará com que a aplicação use-o para fazer as requisições:
process.env.GOOGLE_API_KEY = 'YOUR_KEY_HERE'
Para maiores instruções de como conseguir uma chave da API do Google, visite essa página.
Por padrão, a mais recente chave da API do Google pode não ser permitida para fazer requisições de geolocalização. Para habilitar as requisições, acesse essa página.
ELECTRON_NO_ASAR
Desabilita o suporte ASAR. Essa variável é suportada somente em processos
filhos bifurcados e gerados a partir de processos que definem
ELECTRON_RUN_AS_NODE.
ELECTRON_RUN_AS_NODE
Inicia o processo como um processo padrão de Node.js.
ELECTRON_NO_ATTACH_CONSOLE Windows
Não anexa a janela à sessão atual do console.
ELECTRON_FORCE_WINDOW_MENU_BAR Linux
Não usa a barra de menu global do Linux.
Variáveis de desenvolvimento
As seguintes variáveis de ambiente são destinadas principalmente ao desenvolvimento e o processo de debug.
ELECTRON_ENABLE_LOGGING
Imprime os logs internos do Chrome no terminal.
ELECTRON_LOG_ASAR_READS
Quando o Electron lê um arquivo ASAR, registra o deslocamento e o caminho
do arquivo no sistema tmpdir. O arquivo resultante pode ser fornecido
ao módulo ASAR para otimizar a organização dos arquivos.
ELECTRON_ENABLE_STACK_DUMPING
Imprime o stack trace no terminal quando o Electron trava.
Essa variável de ambiente não funcionará se o crashReporter for iniciado.
ELECTRON_DEFAULT_ERROR_MODE Windows
Exibe a janela de erro do Windows quando o Electron trava.
Essa variável de ambiente não funcionará se o crashReporter for iniciado.