app-builder-lib

What is app-builder-lib?

The app-builder-lib npm package is a library designed to facilitate the building and packaging of applications, particularly Electron applications. It provides a range of tools and utilities to streamline the process of creating distributable versions of your app for different platforms.

What are app-builder-lib's main functionalities?

Building Electron Applications

This feature allows you to build Electron applications for multiple platforms (macOS, Windows, Linux) using a single configuration object. The code sample demonstrates how to set up a basic build configuration and initiate the build process.

const { build } = require('app-builder-lib');

build({
  config: {
    appId: 'com.example.app',
    productName: 'ExampleApp',
    directories: {
      output: 'dist',
      buildResources: 'resources'
    },
    files: ['**/*'],
    mac: {
      target: 'dmg'
    },
    win: {
      target: 'nsis'
    },
    linux: {
      target: 'AppImage'
    }
  }
}).then(() => {
  console.log('Build successful!');
}).catch(err => {
  console.error('Build failed:', err);
});

Code Signing

This feature provides the ability to sign your application code, which is essential for distribution on certain platforms like Windows. The code sample shows how to sign an application using a certificate file.

const { sign } = require('app-builder-lib');

sign({
  path: 'path/to/your/app',
  platform: 'win32',
  certificateFile: 'path/to/certificate.pfx',
  certificatePassword: 'your-password'
}).then(() => {
  console.log('Code signing successful!');
}).catch(err => {
  console.error('Code signing failed:', err);
});

Auto-Update Integration

This feature allows you to integrate auto-update functionality into your application by publishing updates to a specified provider. The code sample demonstrates how to publish updates to a GitHub repository.

const { publish } = require('app-builder-lib');

publish({
  provider: 'github',
  owner: 'your-github-username',
  repo: 'your-repo-name',
  token: 'your-github-token'
}).then(() => {
  console.log('Publishing successful!');
}).catch(err => {
  console.error('Publishing failed:', err);
});

Other packages similar to app-builder-lib

electron-builder

electron-builder is a complete solution to package and build a ready-for-distribution Electron app for macOS, Windows, and Linux. It is similar to app-builder-lib in that it provides a comprehensive set of tools for building and packaging Electron applications. However, electron-builder is more widely used and has a larger community, which can be beneficial for support and finding resources.

electron-packager

electron-packager is a command-line tool and Node.js library that bundles Electron-based application source code with a renamed Electron executable and supporting files into folders ready for distribution. It is simpler and more lightweight compared to app-builder-lib, making it a good choice for smaller projects or those with less complex build requirements.

electron-forge

electron-forge is a complete tool for creating, publishing, and installing modern Electron applications. It aims to be a one-stop solution for getting your Electron app up and running. While it offers similar functionalities to app-builder-lib, it also includes features for scaffolding new projects and managing dependencies, making it a more holistic solution for Electron app development.

README

app-builder-lib

Various utilities. Used by electron-builder.