diff --git a/docs-translations/pt-BR/README.md b/docs-translations/pt-BR/README.md index 05fedfeb4381..8498ca420fc8 100644 --- a/docs-translations/pt-BR/README.md +++ b/docs-translations/pt-BR/README.md @@ -1,7 +1,7 @@ Por favor, certifique-se de que está utilizando a documentação que corresponde à sua versão do Electron. O número da versão deve ser uma parte da URL da página. Se não for, você provavelmente está utilizando a documentação de um branch de desenvolvimento que pode conter mudanças na API que não são compatíveis -com a sua versão do Electron. Se este for o caso, você pode mudar para uma versão diferente da +com a sua versão do Electron. Se este for o caso, você pode mudar para uma versão diferente da documentação na lista de [versões disponíveis](http://electron.atom.io/docs/) em atom.io, ou se você estiver usando a interface do GitHub, abra o *dropdown* "Switch branches/tags" e selecione a *tag* que corresponde à sua versão. @@ -20,7 +20,7 @@ Existem muitas perguntas comuns que são feitas, verifique antes de criar uma is * [Usando Módulos Nativos do Node](tutorial/using-native-node-modules.md) * [Depuração do Processo Principal](tutorial/debugging-main-process.md) * [Usando Selenium e WebDriver](../../docs/tutorial/using-selenium-and-webdriver.md) -* [Extensão DevTools](../../docs/tutorial/devtools-extension.md) +* [Extensão DevTools](tutorial/devtools-extension.md) * [Usando o Plugin Pepper Flash](tutorial/using-pepper-flash-plugin.md) * [Usando o Plugin Widevine CDM](../../tutorial/using-widevine-cdm-plugin.md) diff --git a/docs-translations/pt-BR/tutorial/devtools-extension.md b/docs-translations/pt-BR/tutorial/devtools-extension.md new file mode 100644 index 000000000000..958b70c2e1e6 --- /dev/null +++ b/docs-translations/pt-BR/tutorial/devtools-extension.md @@ -0,0 +1,46 @@ +# Extensão DevTools + +Para facilitar a depuração, o Electron provê suporte para a extensão [Chrome DevTools][devtools-extension]. + +Para a maioria das extensões DevTools você pode simplesmente baixar o código-fonte e usar a função `BrowserWindow.addDevToolsExtension` para carregá-las. As extensões carregadas serão lembradas, assim você não precisa carregar sempre que criar uma nova janela. + +**NOTA: Se o DevTools React não funcionar, verifique a issue https://github.com/electron/electron/issues/915** + +Por exemplo, para usar a extensão [React DevTools](https://github.com/facebook/react-devtools), primeiro você deve baixar seu código-fonte: + +```bash +$ cd /some-directory +$ git clone --recursive https://github.com/facebook/react-devtools.git +``` + +Siga as instruções em [`react-devtools/shells/chrome/Readme.md`](https://github.com/facebook/react-devtools/blob/master/shells/chrome/Readme.md) para fazer o build da extensão. + +Agora você poderá carregar a extensão no Electron abrindo o DevTools em qualquer janela, e executando o seguinte código no console do DevTools: + +```javascript +const BrowserWindow = require('electron').remote.BrowserWindow; +BrowserWindow.addDevToolsExtension('/some-directory/react-devtools/shells/chrome'); +``` + +Para remover a extensão, você pode executar a chamada `BrowserWindow.removeDevToolsExtension` +com o nome da extensão e ela não será carregada na próxima vez que você abrir o DevTools: + +```javascript +BrowserWindow.removeDevToolsExtension('React Developer Tools'); +``` + +## Formato das extensões DevTools + +Idealmente todas as extensões DevTools escritas para o navegador Chrome podem ser carregadas pelo Electron, mas elas devem estar em um diretório. Pacotes com extensão `crx` não podem ser carregados pelo Electron a não ser que tenha uma forma de extraí-los em um diretório. + +## Páginas em segundo plano (background pages) + +Atualmente o Electron não suporta páginas em segundo plano nas extensões do Chrome, então extensões com essa característica podem não funcionar no Electron. + +## APIs `chrome.*` + +Algumas extensões do Chrome podem usar a API `chrome.*`. Apesar de um esforço na implementação destas APIs no Electron, elas ainda não estão finalizadas. + +Dado que nem todas as funções `chrome.*` esstão implementadas, algumas extensões que utilizam `chrome.devtools.*` podem não funcionar. Você pode reportar este erro no issue tracker para que possamos adicionar suporte a essas APIs. + +[devtools-extension]: https://developer.chrome.com/extensions/devtools