phonegap / phonegap-app-desktop

PhoneGap Desktop App
Apache License 2.0
840 stars 312 forks source link

**NOTE: The Phonegap Desktop App is a deprecated project. We advise users to move over to Apache Cordova tooling.

Phonegap Desktop App

Build Status

Quick Start - Developer Mode

  1. Run npm install from the root of this project to set up the project dependencies
  2. cd into the www folder and run npm install for the app dependencies
  3. cd .. back to the root and run npm run reload to start up the live reload server for live code updates
  4. Run electron www from the root folder or electron . from the www folder

NOTE: Steps 1 & 2 only need to be done if you've never run a local build or when the dependencies are updated.

Build Setup for macOS & Windows

# install grunt cli
$ [sudo] npm install -g grunt-cli

# install dev dependencies
$ npm install

# Create a fork of the phonegap-app-desktop repository.
# Clone your fork of the repository.
# Navigate to project folder on your local machine.
# Follow instructions in the Build Commands section.

Windows Gotchas

Once the build is complete, you will need to follow the instructions under Installation for Windows.

Build Commands

# builds development version
$ grunt

# builds release version
$ grunt release

Installation for Windows

If you are using the zip file to run the Desktop App, you will need to run the postInstall.bat file to install the required dependencies. The file is in ./build/PhoneGap-win32-ia32/resources/app.asar.unpacked/bin. Right click on the file and select "Run as administrator", once the script has finished running you will be able to use the app.