mirror of
https://github.com/Llewellynvdm/nativefier.git
synced 2024-09-22 01:29:02 +00:00
Added documentation
This commit is contained in:
parent
debc395599
commit
140c444a96
@ -1,7 +1,7 @@
|
|||||||
{
|
{
|
||||||
"name": "NativeFier",
|
"name": "Nativefier Placeholder",
|
||||||
"version": "0.0.1",
|
"version": "0.0.1",
|
||||||
"description": "Wrap single-page web apps natiely",
|
"description": "Placeholder for the nativefier cli to override with a target url",
|
||||||
"main": "main.js",
|
"main": "main.js",
|
||||||
"dependencies": {
|
"dependencies": {
|
||||||
"electron-prebuilt": "^0.29.1"
|
"electron-prebuilt": "^0.29.1"
|
||||||
|
124
readme.md
124
readme.md
@ -1,35 +1,35 @@
|
|||||||
# electron-packager
|
# Nativefier
|
||||||
|
|
||||||
Package your electron app in OS executables (.app, .exe, etc) via JS or CLI. Supports building Windows, Linux or Mac executables.
|
## Introduction
|
||||||
|
[![NPM](https://nodei.co/npm/nativefier.png)](https://nodei.co/npm/nativefier/)
|
||||||
|
|
||||||
*formerly known as atom-shell-packager*
|
Package and wraps a single-page web app in an [electron](http://electron.atom.io) OS executable (.app, .exe, etc) via the command line.
|
||||||
|
|
||||||
[![NPM](https://nodei.co/npm/electron-packager.png)](https://nodei.co/npm/electron-packager/)
|
Simply a fork with a small layer of abstraction on top of [electron-packager](https://github.com/maxogden/electron-packager) for the CLI.
|
||||||
|
|
||||||
[![Build Status](https://travis-ci.org/maxogden/electron-packager.svg?branch=master)](https://travis-ci.org/maxogden/electron-packager)
|
I did this because I was tired of having to `⌘-tab or alt-tab` to my browser and then search through the numerous tabs open when I was using [Whatsapp Web](http://web.whatsapp.com) or [Facebook Messenger](http://messenger.com).
|
||||||
|
|
||||||
### installation
|
## Installation
|
||||||
|
|
||||||
```
|
|
||||||
# for use in npm scripts
|
|
||||||
npm i electron-packager --save-dev
|
|
||||||
|
|
||||||
|
```bash
|
||||||
# for use from cli
|
# for use from cli
|
||||||
npm i electron-packager -g
|
npm install nativefier -g
|
||||||
```
|
```
|
||||||
|
|
||||||
### usage
|
## Usage
|
||||||
|
|
||||||
|
```css
|
||||||
|
Usage: nativefier <appname> --target=<url> --platform=<platform> --arch=<arch> --version=<version>
|
||||||
|
|
||||||
```
|
|
||||||
Usage: electron-packager <sourcedir> <appname> --platform=<platform> --arch=<arch> --version=<version>
|
|
||||||
|
|
||||||
Required options
|
Required options
|
||||||
|
|
||||||
|
appname name for the app
|
||||||
|
target target url for the single page app
|
||||||
platform all, or one or more of: linux, win32, darwin (comma-delimited if multiple)
|
platform all, or one or more of: linux, win32, darwin (comma-delimited if multiple)
|
||||||
arch all, ia32, x64
|
arch all, ia32, x64
|
||||||
version see https://github.com/atom/electron/releases
|
version see https://github.com/atom/electron/releases
|
||||||
|
|
||||||
Example electron-packager ./ FooBar --platform=darwin --arch=x64 --version=0.25.1
|
Example nativefier Messenger --target=http://messenger.com --platform=darwin --arch=x64 --version=0.28.2
|
||||||
|
|
||||||
Optional options
|
Optional options
|
||||||
|
|
||||||
@ -56,93 +56,17 @@ version-string should contain a hash of the application metadata to be embed
|
|||||||
- ProductVersion
|
- ProductVersion
|
||||||
- ProductName
|
- ProductName
|
||||||
- InternalName
|
- InternalName
|
||||||
|
|
||||||
|
|
||||||
```
|
```
|
||||||
|
|
||||||
This will:
|
See [electron-packager](https://github.com/maxogden/electron-packager) for more details.
|
||||||
|
## Examples
|
||||||
|
|
||||||
- Find or download the correct release of Electron
|
Creating a native wrapper of `http://messenger.com` for `OSX x64`:
|
||||||
- Use that version of electron to create a app in `<out>/<appname>-<platform>-<arch>`
|
|
||||||
|
|
||||||
You should be able to launch the app on the platform you built for. If not, check your settings and try again.
|
```bash
|
||||||
|
$ nativefier Messenger --platform=darwin --arch=x64 --version=0.29.1 --target='http://messenger.com' --overwrite
|
||||||
**Be careful** not to include node_modules you don't want into your final app. `electron-packager`, `electron-prebuilt` and `.git` will be ignored by default. You can use `--ignore` to ignore files and folders, e.g. `--ignore=node_modules/electron-packager` or `--ignore="node_modules/(electron-packager|electron-prebuilt)"`.
|
|
||||||
|
|
||||||
### API
|
|
||||||
```javascript
|
|
||||||
var packager = require('electron-packager')
|
|
||||||
packager(opts, function done (err, appPath) { })
|
|
||||||
```
|
```
|
||||||
#### packager(opts, callback)
|
|
||||||
|
|
||||||
##### opts
|
## Todo
|
||||||
**Required**
|
|
||||||
`dir` - *String*
|
|
||||||
The source directory.
|
|
||||||
|
|
||||||
`name` - *String*
|
- Set the app icon from a url in the CLI
|
||||||
The application name.
|
|
||||||
|
|
||||||
`platform` - *String*
|
|
||||||
Allowed values: *linux, win32, darwin, all*
|
|
||||||
Not required if `all` is used.
|
|
||||||
Arbitrary combinations of individual platforms are also supported via a comma-delimited string or array of strings.
|
|
||||||
|
|
||||||
`arch` - *String*
|
|
||||||
Allowed values: *ia32, x64, all*
|
|
||||||
Not required if `all` is used.
|
|
||||||
|
|
||||||
`version` - *String*
|
|
||||||
Electron version (without the 'v'). See https://github.com/atom/electron/releases
|
|
||||||
|
|
||||||
**Optional**
|
|
||||||
`all` - *Boolean*
|
|
||||||
Shortcut for `--arch=all --platform=all`
|
|
||||||
|
|
||||||
`out` - *String*
|
|
||||||
|
|
||||||
`icon` - *String*
|
|
||||||
|
|
||||||
`app-bundle-id` - *String*
|
|
||||||
|
|
||||||
`app-version` - *String*
|
|
||||||
|
|
||||||
`helper-bundle-id` - *String*
|
|
||||||
|
|
||||||
`ignore` - *String*
|
|
||||||
|
|
||||||
`prune` - *Boolean*
|
|
||||||
|
|
||||||
`overwrite` - *Boolean*
|
|
||||||
|
|
||||||
`asar` - *Boolean*
|
|
||||||
|
|
||||||
`sign` - *String*
|
|
||||||
|
|
||||||
`version-string` - *Object*
|
|
||||||
Object hash of application metadata to embed into the executable (Windows only):
|
|
||||||
* `CompanyName`
|
|
||||||
* `LegalCopyright`
|
|
||||||
* `FileDescription`
|
|
||||||
* `OriginalFilename`
|
|
||||||
* `FileVersion`
|
|
||||||
* `ProductVersion`
|
|
||||||
* `ProductName`
|
|
||||||
* `InternalName`
|
|
||||||
|
|
||||||
##### callback
|
|
||||||
|
|
||||||
`err` - *Error*
|
|
||||||
Contains errors if any.
|
|
||||||
|
|
||||||
`appPath` - *String*
|
|
||||||
Path to the newly created application.
|
|
||||||
|
|
||||||
### Building windows apps from non-windows platforms
|
|
||||||
|
|
||||||
If you run this on windows and you want to set the icon for your app using the `--icon` option, it requires running a thing called `rcedit.exe` (via [this](https://github.com/atom/node-rcedit)), which means you will need to install `wine` and have it available in your path. To do this on Mac OS you can `brew install wine`.
|
|
||||||
|
|
||||||
### related
|
|
||||||
|
|
||||||
- [grunt-electron](https://github.com/sindresorhus/grunt-electron) - grunt plugin for electron-packager
|
|
@ -2,12 +2,13 @@ Usage: nativefier <appname> --target=<url> --platform=<platform> --arch=<arch> -
|
|||||||
|
|
||||||
Required options
|
Required options
|
||||||
|
|
||||||
|
appname name for the app
|
||||||
target target url for the single page app
|
target target url for the single page app
|
||||||
platform all, or one or more of: linux, win32, darwin (comma-delimited if multiple)
|
platform all, or one or more of: linux, win32, darwin (comma-delimited if multiple)
|
||||||
arch all, ia32, x64
|
arch all, ia32, x64
|
||||||
version see https://github.com/atom/electron/releases
|
version see https://github.com/atom/electron/releases
|
||||||
|
|
||||||
Example electron-packager FooBar --target=http://messenger.com --platform=darwin --arch=x64 --version=0.28.2
|
Example nativefier Messenger --target=http://messenger.com --platform=darwin --arch=x64 --version=0.28.2
|
||||||
|
|
||||||
Optional options
|
Optional options
|
||||||
|
|
||||||
|
Loading…
Reference in New Issue
Block a user