scale-serial-reader

An Electron app that utilizes Serialport to read from a serial-usb scale and then inject the data into a webpage.

Originally cloned from electron-serialport

This is a minimal Electron application based on the Quick Start Guide within the Electron documentation.

A basic Electron application needs just these files:

• package.json - Points to the app's main file and lists its details and dependencies.
• main.js - Starts the app and creates a browser window to render HTML. This is the app's main process.
• index.html - A web page to render. This is the app's renderer process.

You can learn more about each of these components within the Quick Start Guide.

To Use

To clone and run this repository you'll need Git and Node.js (which comes with npm) installed on your computer. From your command line:

# Clone this repository
git clone https://github.com/electron/electron-quick-start
# Go into the repository
cd electron-quick-start
# Install dependencies
npm install
# Run the app
npm start

To Package and Create Installer

If these commands are successful, the packaged app will be placed inside the dist folder.

# Package for Windows
npm run dist

This repo contains the bare minimum code to have an auto-updating Electron app using electron-updater with releases stored on GitHub.

If you can't use GitHub, you can use other providers:

• Complete electron-updater HTTP example
• Complete electron-updater from gitlab.com private repo example

NOTE: If you want to run through this whole process, you will need to fork this repo on GitHub and replace all instances of iffy with your GitHub username before doing the following steps.

1. For macOS, you will need a code-signing certificate.

   Install Xcode (from the App Store), then follow these instructions to make sure you have a "Mac Developer" certificate. If you'd like to export the certificate (for automated building, for instance) you can. You would then follow these instructions.

2. Adjust package.json if needed.

   By default, electron-updater will try to detect the GitHub settings (such as the repo name and owner) from reading the .git/config or from reading other attributes within package.json. If the auto-detected settings are not what you want, configure the publish property as follows:

    {
        ...
        "build": {
            "publish": [{
                "provider": "github",
                "owner": "iffy",
                "repo": "electron-updater-example"
            }],
            ...
        }
    }
   

3. Install necessary dependencies with:

    yarn
   

   or

    npm install
   

4. Generate a GitHub access token by going to https://github.com/settings/tokens/new. The access token should have the repo scope/permission. Once you have the token, assign it to an environment variable

   On macOS/linux:

    export GH_TOKEN="<YOUR_TOKEN_HERE>"
   

   On Windows, run in powershell:

    [Environment]::SetEnvironmentVariable("GH_TOKEN","<YOUR_TOKEN_HERE>","User")
   

   Make sure to restart IDE/Terminal to inherit latest env variable.

5. Publish for your platform with:

    build -p always
   

   or

    npm run publish
   

   If you want to publish for more platforms, edit the publish script in package.json. For instance, to build for Windows and macOS:

    ...
    "scripts": {
        "publish": "build --mac --win -p always"
    },
    ...
   

6. Release the release on GitHub by going to https://github.com/YOUR_GIT_HUB_USERNAME/electron-updater-example/releases, editing the release and clicking "Publish release."

7. Download and install the app from https://github.com/YOUR_GIT_HUB_USERNAME/electron-updater-example/releases.

8. Update the version in package.json, commit and push to GitHub.

9. Do steps 5 and 6 again.

10. Open the installed version of the app and see that it updates itself. Learn more about Electron and its API in the documentation.