November's Paddleball Marathon
Unleash awesomeness. Private packages, team management tools, and powerful integrations. Get started with npm Orgs »

electron-asar-hot-updater

0.0.3 • Public • Published

electron-asar-hot-updater

NPM

What it is

A NodeJs module for Electron, that handles app.asar updates. Reconstruction of electron-asar-updater

How it works (Read this first)

  • EAU (Electron Asar Updater) was built upon Electron Application Updater to handle the process of updating the app.asar file inside an Electron app ; it simply replaces the app.asar file (at /resources/) with the new one called "update.asar"!
  • The check for "updates" must by triggered by the application. EAU doesn't make any kind of periodic checks on its own.
  • EAU talks to an API (let's call it so) to tell it if there is a new update.
    • The API receives a request from EAU with the client's current version of the application (must be specified inside the application package.json file).
    • The API then responds with the new update, ... or simply false to abort.
    • If there's an update available the API should respond with the source for this update update.asar file.
    • EAU then downloads the .asar file, deletes the old app.asar and renames the update.asar to app.asar.

But why ? (use cases)


Installation

$ npm install --save electron-asar-hot-updater

Now, inside the main.js file, call it like this:

const { app, dialog } = require('electron');
const EAU = require('electron-asar-hot-updater');
 
app.on('ready', function () {
  // Initiate the module
  EAU.init({
    'api': 'http://...', // The API EAU will talk to
    'server': false // Where to check. true: server side, false: client side, default: true.
  });
 
  EAU.check(function (error, last, body) {
    if (error) {
      if (error === 'no_update_available') { return false; }
      dialog.showErrorBox('info', error)
      return false
    }
 
    EAU.progress(function (state) {
      // The state is an object that looks like this:
      // {
      //     percent: 0.5,               
      //     speed: 554732,              
      //     size: {
      //         total: 90044871,        
      //         transferred: 27610959   
      //     },
      //     time: {
      //         elapsed: 36.235,        
      //         remaining: 81.403       
      //     }
      // }
    })
 
    EAU.download(function (error) {
      if (error) {
        dialog.showErrorBox('info', error)
        return false
      }
      dialog.showErrorBox('info', 'App updated successfully! Restart it please.')
    })
 
  })
})

The update server

The server can return the version details, for example

const express = require('express')
var bodyParser = require('body-parser');
const app = express()
 
app.use(bodyParser.json());
app.use(bodyParser.urlencoded({ extended: false }));
 
var desktop_app_version = '1.0.0';
var desktop_app_URL = 'http://127.0.0.1:8083/update.asar' // or ../update.zip
 
app.post('/update', function (req, res) {
  if(req.body && req.body.current != desktop_app_version){ // check for server side
    res.write(JSON.stringify( {"last": desktop_app_version, "source": desktop_app_URL} ).replace(/[\/]/g, '\\/') );
  }else{
    res.write(JSON.stringify( {"last": desktop_app_version} ).replace(/[\/]/g, '\\/') );
  }
  res.end();
});
 
app.listen(3000)
console.log('run port: 3000')

Or you can return version information for client to check

app.post('/update', function (req, res) {
  res.write(JSON.stringify( {
    "name": "app",
    "version": "0.0.1",
    "asar": "http://127.0.0.1:8083/update.asar",
    "info": "1.fix bug\n2.feat..."
  } ).replace(/[\/]/g, '\\/') );
  res.end();
});

If you use a zip file, the plug-in will unzip the file after downloading it, which will make your update file smaller, but you must make sure that update.asar is at the root of the zip package:

── update.zip
   └── update.asar

License

😃 if you have any comments or wish to contribute to this project, you are welcome to submit Issues or PR.

MIT - yansenlei

install

npm i electron-asar-hot-updater

Downloadsweekly downloads

10

version

0.0.3

license

MIT

homepage

github.com

repository

Gitgithub

last publish

collaborators

  • avatar
Report a vulnerability