:memo: [ci skip] Add translation to auto-updater, change links
authorArtur de Oliveira Tsuda <artur.o.tsuda@gmail.com>
Tue, 1 Dec 2015 23:09:20 +0000 (21:09 -0200)
committerArtur de Oliveira Tsuda <artur.o.tsuda@gmail.com>
Tue, 1 Dec 2015 23:09:20 +0000 (21:09 -0200)
docs-translations/pt-BR/README.md
docs-translations/pt-BR/api/auto-updater.md [new file with mode: 0644]

index 61202f8..f458e51 100644 (file)
@@ -40,8 +40,8 @@ selecione a *tag* que corresponde à sua versão.
 
 ### Módulos para o Processo Principal:
 
-* [app](../../docs/api/app.md)
-* [autoUpdater](../../docs/api/auto-updater.md)
+* [app](api/app.md)
+* [autoUpdater](api/auto-updater.md)
 * [BrowserWindow](../../docs/api/browser-window.md)
 * [contentTracing](../../docs/api/content-tracing.md)
 * [dialog](../../docs/api/dialog.md)
diff --git a/docs-translations/pt-BR/api/auto-updater.md b/docs-translations/pt-BR/api/auto-updater.md
new file mode 100644 (file)
index 0000000..1c27a4b
--- /dev/null
@@ -0,0 +1,85 @@
+# autoUpdater
+
+Este módulo oferece uma interface para o framework de atualização automática `Squirrel`.
+
+## Notificações de Plataforma
+
+Embora o `autoUpdater` ofereça uma API uniforme para diferentes plataformas, existem diferenças sutis em cada plataforma.
+
+### OS X
+
+No OS X, o módulo `autoUpdater` é construído sobre o [Squirrel.Mac][squirrel-mac], o que significa que você não precisa de nenhuma configuração especial para fazê-lo funcionar. Para requerimentos de servidor, você pode ler [Server Support][server-support].
+
+### Windows
+
+No Windows, você deve instalar seu aplicativo na máquina de um usuário antes que possa usar o auto-updater, então é recomendado utilizar o módulo [grunt-electron-installer][installer] para gerar um instalador do Windows.
+
+O instalador gerado com Squirrel irá criar um ícone de atalho com um [Application User Model ID][app-user-model-id] no formato `com.squirrel.PACKAGE_ID.YOUR_EXE_WITHOUT_DOT_EXE`, por exemplo: `com.squirrel.slack.Slack` e `com.squirrel.code.Code`. Você precisa usar o mesmo ID para seu aplicativo a API `app.setAppUserModelId`, senão o Windows não conseguirá fixar seu aplicativo corretamente na barra de tarefas.
+
+A configuração do servidor também é diferente do OS X. Você pode ler a documentação do [Squirrel.Windows][squirrel-windows] para mais detalhes.
+
+### Linux
+
+Não há suporte nativo do auto-updater para Linux, então é recomendado utilizar o gerenciador de pacotes da distribuição para atualizar seu aplicativo.
+
+## Eventos
+
+O objeto `autoUpdater` emite os seguintes eventos:
+
+### Evento: 'error'
+
+Retorna:
+
+* `error` Error
+
+Emitido quando há um erro durante a atualização.
+
+### Evento: 'checking-for-update'
+
+Emitido quando está verificando se uma atualização foi inicializada.
+
+### Evento: 'update-available'
+
+Emitido quando há uma atualização disponível. A autalização é baixada automaticamente.
+
+### Evento: 'update-not-available'
+
+Emitido quando não há uma atualização disponível.
+
+### Evento: 'update-downloaded'
+
+Retorna:
+
+* `event` Event
+* `releaseNotes` String
+* `releaseName` String
+* `releaseDate` Date
+* `updateURL` String
+
+Emitido quando uma atualização foi baixada.
+
+No Windows apenas `releaseName` está disponível.
+
+## Métodos
+
+O objeto `autoUpdater` possui os seguintes métodos:
+
+### `autoUpdater.setFeedURL(url)`
+
+* `url` String
+
+Define a `url` e inicializa o auto-updater. A `url` não pode ser alterada uma vez que foi definida.
+
+### `autoUpdater.checkForUpdates()`
+
+Pergunta ao servidor se há uma atualização. Você deve chamar `setFeedURL` antes de usar esta API.
+
+### `autoUpdater.quitAndInstall()`
+
+Reinicia o aplicativo e instala a atualização após esta ter sido baixada. Só deve ser chamado após o `update-downloaded` ter sido emitido.
+
+[squirrel-mac]: https://github.com/Squirrel/Squirrel.Mac
+[server-support]: https://github.com/Squirrel/Squirrel.Mac#server-support
+[squirrel-windows]: https://github.com/Squirrel/Squirrel.Windows
+[installer]: https://github.com/atom/grunt-electron-installer
+[app-user-model-id]: https://msdn.microsoft.com/en-us/library/windows/desktop/dd378459(v=vs.85).aspx