Electron-update-checker-notifier NPM

In English

UpdateCheckerNotifier

It's a project that seeks new updates for the app from the GitHub repository and informs the user about these updates. The goal is to keep the user informed about the latest versions of their software and allow for simple and fast updating.

Functionalities

Checks the latest version of the app in the Github repository.
Displays a notification to the user when a new update is available.
Event management for customizing update checks and notification display.
Ability to choose the language used for log messages and notifications.

Language setting

You can choose the language that will be used for log messages and notifications by adding the following option to the updateNotification method call:

import { updateCheckerNotifier, Language } from 'electron-update-checker-notifier';

updateCheckerNotifier.language = Language.PT_BR;

updateCheckerNotifier.updateNotification();

import { UpdateCheckerNotifier, Language } from 'electron-update-checker-notifier';

const notifier = new UpdateCheckerNotifier();

notifier.updateNotification({
  language: Language.PT_BR,
});

The currently supported languages are:

en-US (English - United States)
pt-BR (Portuguese - Brazil)

Installation

npm install electron-update-checker-notifier

Use

To use UpdateCheckerNotifier, you need to import it and create an instance. Then, you can call the updateNotification() method to check if there are updates available for your app.

import { UpdateCheckerNotifier } from 'electron-update-checker-notifier';

const notifier = new UpdateCheckerNotifier();
notifier.updateNotification();

Options

You can pass options to the updateNotification() method to customize its behavior.

repository (Optional): Your app repository on GitHub. If not specified, it will use the repository defined in your app's package.json file.

token (Optional): The access token to the GitHub API.

debug (Optional, default: false): Allows checking for updates during development.

enablePreRelease (Optional, default: false): Notify pre-release version.

enableNewVersionAvailableDialog (Optional, default: true): Notifies when there are new versions available, otherwise remains silent.

enableLatestVersionDialog (Optional, default: false): Notifies when you are already running the latest version.

enableErrorDialog (Optional, default: false): Notifies when an error occurs.

language (Optional, default: Language.EN): The language used for log messages and notifications.

logger (Optional): The logger. You can pass a logger such as electron-log, winston, or other with the following interfaces: { info(), warn(), error() }. Set to null if you wish to disable logging.

Events

UpdateCheckerNotifier emits several events that you can listen to for information about the update process.

checking-for-update: Emitted when the update check process begins.

update-available: Emitted when there is a new version available for download.

update-not-available: Emitted when there are no new updates available.

this-is-last-update: Emitted when the update check determines that the current version of your app is the last available version.

error: Emitted when an error occurs during the update check process.

You can listen to these events as follows:

notifier.on('checking-for-update', () => {
  console.log('Checking for updates...');
});

notifier.on('update-available', (info: UpdateInfo) => {
  console.log(`A new version (${info.version}) is available for download!`);
});

notifier.on('update-not-available', (info: UpdateInfo) => {
  console.log('There are no new updates available.');
});

notifier.on('this-is-last-update', (info: UpdateInfo) => {
  console.log('This is the latest update available.: ', info);
});

notifier.on('error', (error: Error) => {
  console.error(`An error has occurred: ${error}`);
});

The UpdateInfo object is passed as an argument to the event handler and contains information about the current and latest available version of your application.

Example

Here is a full example of how to use UpdateCheckerNotifier in an Electron application:

import { updateCheckerNotifier, Language } from 'electron-update-checker-notifier';

updateCheckerNotifier.repository = 'user/repo'
updateCheckerNotifier.token = 'my-github-token'
updateCheckerNotifier.debug = true
updateCheckerNotifier.enablePreRelease = true
updateCheckerNotifier.enableNewVersionAvailableDialog = true
updateCheckerNotifier.enableLatestVersionDialog = true
updateCheckerNotifier.enableErrorDialog = true
updateCheckerNotifier.language = Language.PT_BR
updateCheckerNotifier.logger = log

updateCheckerNotifier.updateNotification();

import { UpdateCheckerNotifier, Language } from 'electron-update-checker-notifier';

const notifier = new UpdateCheckerNotifier();

notifier.updateNotification({
  repository: 'user/repo',
  token: 'my-github-token',
  debug: true,
  enablePreRelease = true,
  enableNewVersionAvailableDialog: true,
  enableLatestVersionDialog: true,
  enableErrorDialog: true,
  language: Language.PT_BR,
  logger: log,
});

notifier.on('update-available', (info: UpdateInfo) => {
  console.log(`A new version (${info.version}) is available for download!`);
});

notifier.on('error', (error: Error) => {
  console.error(`An error has occurred: ${error}`);
});

Contribution

If you want to contribute to this project, follow these steps:

Fork the repository
Create your branch
Commit your changes
Push on the branch
Create a pull request

Acknowledgments

I would like to thank the following developers for the work done on the project electron-update-notifier

Thank you for your dedication and contribution to the community.

License

This project is licensed under the MIT license. See the LICENSE file for more details.

In Portuguese

UpdateCheckerNotifier

É um projeto que busca novas atualizações do aplicativo a partir do repositório do GitHub e notifica o usuário sobre essas atualizações. O objetivo é manter o usuário informado sobre as versões mais recentes de seu software e possibilitar a atualização de maneira simples e rápida.

Funcionalidades

Verifica a versão mais recente do aplicativo no repositório do Github.
Exibi uma notificação para o usuário quando uma nova atualização estiver disponível.
Gerenciamento de eventos para personalização da verificação de atualizações e exibição de notificações.
Possibilidade de escolher o idioma usado para as mensagens de log e notificações.

Configuração de idioma

Você pode escolher o idioma que será utilizado usado para as mensagens de log e notificações adicionando a seguinte opção à chamada do método updateNotification:

import { updateCheckerNotifier, Language } from 'electron-update-checker-notifier';

updateCheckerNotifier.language = Language.PT_BR;

updateCheckerNotifier.updateNotification();

import { UpdateCheckerNotifier, Language } from 'electron-update-checker-notifier';

const notifier = new UpdateCheckerNotifier();

notifier.updateNotification({
  language: Language.PT_BR,
});

Os idiomas atualmente suportados são:

en-US (Inglês - Estados Unidos)
pt-BR (Português - Brasil)

Instalação

npm install electron-update-checker-notifier

Uso

Para usar UpdateCheckerNotifier, você precisa importá-lo e criar uma instância. Em seguida, você pode chamar o método updateNotification() para verificar se há atualizações disponíveis para o seu aplicativo.

import { UpdateCheckerNotifier } from 'electron-update-checker-notifier';

const notifier = new UpdateCheckerNotifier();
notifier.updateNotification();

Opções

Você pode passar opções para o método updateNotification() para personalizar o comportamento.

repository (opcional): O repositório do seu aplicativo no GitHub. Se não for especificado, ele usará o repositório definido no arquivo package.json do seu aplicativo.

token (opcional): O token de acesso à API do GitHub.

debug (opcional, padrão: false): Permite verificar atualizações durante o desenvolvimento.

enablePreRelease (opcional, padrão: false): Notifica versão de pré-lançamento

enableNewVersionAvailableDialog (opcional, padrão: true): Notifica quando houver novas versões disponíveis, caso contrário, permanece silencioso.

enableLatestVersionDialog (opcional, padrão: false): Notifica quando você já está executando a versão mais recente.

enableErrorDialog (opcional, padrão: false): Notifica quando um erro acontecer

language (opcional, padrão: Language.EN): O idioma usado para as mensagens de log e notificações.

logger (opcional): O registrador. Você pode passar um registrador como electron-log, winston ou outro com as seguintes interfaces: { info(), warn(), error() }. Defina como null se você desejar desativar o recurso de log.

Eventos

UpdateCheckerNotifier emite vários eventos que você pode ouvir para obter informações sobre o processo de atualização.

checking-for-update: Emitido quando o processo de verificação de atualização começa.

update-available: Emitido quando há uma nova versão disponível para download.

update-not-available: Emitido quando não há novas atualizações disponíveis.

this-is-last-update: Emitido quando quando a verificação de atualização determina que a versão atual do seu aplicativo é a última versão disponível.

error: Emitido quando ocorre um erro durante o processo de verificação de atualização.

Você pode ouvir esses eventos da seguinte maneira:

notifier.on('checking-for-update', () => {
  console.log('Verificando por atualizações...');
});

notifier.on('update-available', (info: UpdateInfo) => {
  console.log(`Uma nova versão (${info.version}) está disponível para download!`);
});

notifier.on('update-not-available', (info: UpdateInfo) => {
  console.log('Não há novas atualizações disponíveis.');
});

notifier.on('this-is-last-update', (info: UpdateInfo) => {
  console.log('Esta é a última atualização disponível: ', info);
});

notifier.on('error', (error: Error) => {
  console.error(`Ocorreu um erro: ${error}`);
});

O objeto UpdateInfo é passado como um argumento para o manipulador de eventos e contém informações sobre a versão atual e a última versão disponível do seu aplicativo.

Exemplo

Aqui está um exemplo completo de como usar UpdateCheckerNotifier em um aplicativo Electron:

import { updateCheckerNotifier, Language } from 'electron-update-checker-notifier';

updateCheckerNotifier.repository = 'user/repo'
updateCheckerNotifier.token = 'my-github-token'
updateCheckerNotifier.debug = true
updateCheckerNotifier.enablePreRelease = true
updateCheckerNotifier.enableNewVersionAvailableDialog = true
updateCheckerNotifier.enableLatestVersionDialog = true
updateCheckerNotifier.enableErrorDialog = true
updateCheckerNotifier.language = Language.PT_BR
updateCheckerNotifier.logger = log

updateCheckerNotifier.updateNotification();

import { UpdateCheckerNotifier, Language } from 'electron-update-checker-notifier';

const notifier = new UpdateCheckerNotifier();

notifier.updateNotification({
  repository: 'user/repo',
  token: 'my-github-token',
  debug: true,
  enablePreRelease = true,
  enableNewVersionAvailableDialog: true,
  enableLatestVersionDialog: true,
  enableErrorDialog: true,
  language: Language.PT_BR,
  logger: log,
});

notifier.on('update-available', (info: UpdateInfo) => {
  console.log(`Uma nova versão (${info.version}) está disponível para download!`);
});

notifier.on('error', (error: Error) => {
  console.error(`Ocorreu um erro: ${error}`);
});