123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596 |
- Usage: electron-packager <sourcedir> <appname> [options...]
- Required options
- sourcedir the base directory of the application source
- Examples: electron-packager ./
- electron-packager ./ --all
- Optional options
- appname the name of the app, if it needs to be different from the "productName" or "name"
- in the nearest package.json
- * All platforms *
- all equivalent to --platform=all --arch=all
- app-copyright human-readable copyright line for the app
- app-version release version to set for the app
- arch all, or one or more of: ia32, x64, armv7l, arm64, mips64el (comma-delimited if
- multiple). Defaults to the host arch
- asar whether to package the source code within your app into an archive. You can either
- pass --asar by itself to use the default configuration, OR use dot notation to
- configure a list of sub-properties, e.g. --asar.unpackDir=sub_dir - do not use
- --asar and its sub-properties simultaneously.
- Properties supported:
- - ordering: path to an ordering file for file packing
- - unpack: unpacks the files to the app.asar.unpacked directory whose filenames
- regex .match this string
- - unpackDir: unpacks the dir to the app.asar.unpacked directory whose names glob
- pattern or exactly match this string. It's relative to the <sourcedir>.
- build-version build version to set for the app
- download a list of sub-options to pass to electron-download. They are specified via dot
- notation, e.g., --download.cache=/tmp/cache
- Properties supported:
- - cache: directory of cached Electron downloads. Defaults to `$HOME/.electron`
- - mirror: alternate URL to download Electron zips
- - strictSSL: whether SSL certs are required to be valid when downloading
- Electron. Defaults to true, use --no-download.strictSSL to disable checks.
- electron-version the version of Electron that is being packaged, see
- https://github.com/electron/electron/releases
- executable-name the name of the executable file, sans file extension. Defaults to appname
- extra-resource a file to copy into the app's resources directory
- icon the local path to an icon file to use as the icon for the app.
- Note: Format depends on platform.
- ignore do not copy files into app whose filenames RegExp.match this string. See also:
- https://github.com/electron-userland/electron-packager/blob/master/docs/api.md#ignore
- and --no-prune. Can be specified multiple times
- no-deref-symlinks make sure symlinks are not dereferenced within the app source
- no-prune do not prune devDependencies from the packaged app
- out the dir to put the app into at the end. Defaults to current working dir
- overwrite if output directory for a platform already exists, replaces it rather than
- skipping it
- platform all, or one or more of: darwin, linux, mas, win32 (comma-delimited if multiple).
- Defaults to the host platform
- quiet Do not print informational or warning messages
- tmpdir temp directory. Defaults to system temp directory, use --no-tmpdir to disable
- use of a temporary directory.
- * darwin/mas target platforms only *
- app-bundle-id bundle identifier to use in the app plist
- app-category-type the application category type
- For example, `app-category-type=public.app-category.developer-tools` will set the
- application category to 'Developer Tools'.
- extend-info a plist file to merge into the app plist
- helper-bundle-id bundle identifier to use in the app helper plist
- osx-sign (OSX host platform only) Whether to sign the OSX app packages. You can either
- pass --osx-sign by itself to use the default configuration, or use dot notation
- to configure a list of sub-properties, e.g. --osx-sign.identity="My Name"
- Properties supported:
- - identity: should contain the identity to be used when running `codesign`
- - entitlements: the path to entitlements used in signing
- - entitlements-inherit: the path to the 'child' entitlements
- protocol URL protocol scheme to register the app as an opener of.
- For example, `--protocol=myapp` would register the app to open
- URLs such as `myapp://path`. This argument requires a `--protocol-name`
- argument to also be specified.
- protocol-name Descriptive name of URL protocol scheme specified via `--protocol`
- * win32 target platform only *
- win32metadata a list of sub-properties used to set the application metadata embedded into
- the executable. They are specified via dot notation,
- e.g. --win32metadata.CompanyName="Company Inc."
- or --win32metadata.ProductName="Product"
- Properties supported:
- - CompanyName (default: author name from nearest package.json)
- - FileDescription (default: appname)
- - OriginalFilename (default: renamed exe)
- - ProductName (default: appname)
- - InternalName (default: appname)
- - requested-execution-level (user, asInvoker, or requireAdministrator)
- - application-manifest
|