diff --git a/main/functions/allOfficialArchsForPlatformAndVersion.html b/main/functions/allOfficialArchsForPlatformAndVersion.html index 26a16902..075f00c9 100644 --- a/main/functions/allOfficialArchsForPlatformAndVersion.html +++ b/main/functions/allOfficialArchsForPlatformAndVersion.html @@ -1 +1 @@ -allOfficialArchsForPlatformAndVersion | @electron/packager

Function allOfficialArchsForPlatformAndVersion

\ No newline at end of file +allOfficialArchsForPlatformAndVersion | @electron/packager

Function allOfficialArchsForPlatformAndVersion

\ No newline at end of file diff --git a/main/functions/packager.html b/main/functions/packager.html index 358e3f82..133cb1cf 100644 --- a/main/functions/packager.html +++ b/main/functions/packager.html @@ -10,4 +10,4 @@

Parameters

Returns Promise<string[]>

A Promise containing the paths to the newly created application bundles.

-
\ No newline at end of file +
\ No newline at end of file diff --git a/main/functions/serialHooks.html b/main/functions/serialHooks.html index 032d41ee..689acd2d 100644 --- a/main/functions/serialHooks.html +++ b/main/functions/serialHooks.html @@ -3,4 +3,4 @@ If you need the functions called serially, you can use the serialHooks utility function:

const { packager, serialHooks } = require('@electron/packager')

packager({
// ...
afterCopy: [serialHooks([
(buildPath, electronVersion, platform, arch, callback) => {
setTimeout(() => {
console.log('first function')
callback()
}, 1000)
},
(buildPath, electronVersion, platform, arch, callback) => {
console.log('second function')
callback()
}
])],
// ...
})
-

Parameters

Returns ((...serialHookParams) => Promise<void>)

\ No newline at end of file +

Parameters

Returns ((...serialHookParams) => Promise<void>)

\ No newline at end of file diff --git a/main/interfaces/ComboOptions.html b/main/interfaces/ComboOptions.html index 991e6d36..a6670e88 100644 --- a/main/interfaces/ComboOptions.html +++ b/main/interfaces/ComboOptions.html @@ -1,5 +1,5 @@ ComboOptions | @electron/packager

Interface ComboOptions

Options passed to the packager() function.

-
interface ComboOptions {
    afterAsar?: HookFunction[];
    afterComplete?: HookFunction[];
    afterCopy?: HookFunction[];
    afterCopyExtraResources?: HookFunction[];
    afterExtract?: HookFunction[];
    afterFinalizePackageTargets?: FinalizePackageTargetsHookFunction[];
    afterInitialize?: HookFunction[];
    afterPrune?: HookFunction[];
    all?: boolean;
    appBundleId?: string;
    appCategoryType?: string;
    appCopyright?: string;
    appVersion?: string;
    arch: string | string[];
    asar?: boolean | CreateOptions;
    beforeAsar?: HookFunction[];
    beforeCopy?: HookFunction[];
    beforeCopyExtraResources?: HookFunction[];
    buildVersion?: string;
    darwinDarkModeSupport?: boolean;
    derefSymlinks?: boolean;
    dir: string;
    download?: ElectronDownloadRequestOptions;
    electronVersion?: string;
    electronZipDir?: string;
    executableName?: string;
    extendHelperInfo?: string | {
        [property: string]: any;
    };
    extendInfo?: string | {
        [property: string]: any;
    };
    extraResource?: string | string[];
    helperBundleId?: string;
    icon?: string;
    ignore?: RegExp | (string | RegExp)[] | IgnoreFunction;
    junk?: boolean;
    name?: string;
    osxNotarize?: NotaryToolCredentials;
    osxSign?: true | OsxSignOptions;
    osxUniversal?: OsxUniversalOptions;
    out?: string;
    overwrite?: boolean;
    platform: string | string[];
    prebuiltAsar?: string;
    protocols?: MacOSProtocol[];
    prune?: boolean;
    quiet?: boolean;
    tmpdir?: string | false;
    usageDescription?: {
        [property: string]: string;
    };
    win32metadata?: Win32MetadataOptions;
    windowsSign?: true | WindowsSignOptions;
}

Hierarchy (view full)

Other

interface ComboOptions {
    afterAsar?: HookFunction[];
    afterComplete?: HookFunction[];
    afterCopy?: HookFunction[];
    afterCopyExtraResources?: HookFunction[];
    afterExtract?: HookFunction[];
    afterFinalizePackageTargets?: FinalizePackageTargetsHookFunction[];
    afterInitialize?: HookFunction[];
    afterPrune?: HookFunction[];
    all?: boolean;
    appBundleId?: string;
    appCategoryType?: string;
    appCopyright?: string;
    appVersion?: string;
    arch: string | string[];
    asar?: boolean | CreateOptions;
    beforeAsar?: HookFunction[];
    beforeCopy?: HookFunction[];
    beforeCopyExtraResources?: HookFunction[];
    buildVersion?: string;
    darwinDarkModeSupport?: boolean;
    derefSymlinks?: boolean;
    dir: string;
    download?: ElectronDownloadRequestOptions;
    electronVersion?: string;
    electronZipDir?: string;
    executableName?: string;
    extendHelperInfo?: string | {
        [property: string]: any;
    };
    extendInfo?: string | {
        [property: string]: any;
    };
    extraResource?: string | string[];
    helperBundleId?: string;
    icon?: string;
    ignore?: RegExp | (string | RegExp)[] | IgnoreFunction;
    junk?: boolean;
    name?: string;
    osxNotarize?: NotaryToolCredentials;
    osxSign?: true | OsxSignOptions;
    osxUniversal?: OsxUniversalOptions;
    out?: string;
    overwrite?: boolean;
    platform: string | string[];
    prebuiltAsar?: string;
    protocols?: MacOSProtocol[];
    prune?: boolean;
    quiet?: boolean;
    tmpdir?: string | false;
    usageDescription?: {
        [property: string]: string;
    };
    win32metadata?: Win32MetadataOptions;
    windowsSign?: true | WindowsSignOptions;
}

Hierarchy (view full)

Other

afterAsar?: HookFunction[]

Functions to be called after your app directory has been packaged into an .asar file.

Note: afterAsar will only be called if the asar option is set.

-
afterComplete?: HookFunction[]

Functions to be called after the packaged application has been moved to the final directory.

-
afterCopy?: HookFunction[]

Functions to be called after your app directory has been copied to a temporary directory.

+
afterComplete?: HookFunction[]

Functions to be called after the packaged application has been moved to the final directory.

+
afterCopy?: HookFunction[]

Functions to be called after your app directory has been copied to a temporary directory.

Note: afterCopy will not be called if the prebuiltAsar option is set.

-
afterCopyExtraResources?: HookFunction[]

Functions to be called after the files specified in the extraResource option have been copied.

-
afterExtract?: HookFunction[]

Functions to be called after the prebuilt Electron binary has been extracted to a temporary directory.

-
afterFinalizePackageTargets?: FinalizePackageTargetsHookFunction[]

Functions to be called after the final matrix of platform/arch combination is determined. Use this to +

afterCopyExtraResources?: HookFunction[]

Functions to be called after the files specified in the extraResource option have been copied.

+
afterExtract?: HookFunction[]

Functions to be called after the prebuilt Electron binary has been extracted to a temporary directory.

+
afterFinalizePackageTargets?: FinalizePackageTargetsHookFunction[]

Functions to be called after the final matrix of platform/arch combination is determined. Use this to learn what archs/platforms packager is targetting when you pass "all" as a value.

-
afterInitialize?: HookFunction[]
afterPrune?: HookFunction[]

Functions to be called after Node module pruning has been applied to the application.

+
afterInitialize?: HookFunction[]
afterPrune?: HookFunction[]

Functions to be called after Node module pruning has been applied to the application.

Note: None of these functions will be called if the prune option is false or the prebuiltAsar option is set.

-
all?: boolean

When true, sets both arch and platform to all.

-
appBundleId?: string
appCopyright?: string

The human-readable copyright line for the app. Maps to the LegalCopyright metadata +

all?: boolean

When true, sets both arch and platform to all.

+
appBundleId?: string
appCopyright?: string

The human-readable copyright line for the app. Maps to the LegalCopyright metadata property on Windows, and NSHumanReadableCopyright on macOS.

-
appVersion?: string

The release version of the application.

+
appVersion?: string

The release version of the application.

By default the version property in the package.json is used, but it can be overridden with this argument. If neither are provided, the version of Electron will be used. Maps to the ProductVersion metadata property on Windows, and CFBundleShortVersionString on macOS.

-
arch: string | string[]

The target system architecture(s) to build for.

+
arch: string | string[]

The target system architecture(s) to build for.

Not required if the all option is set. If arch is set to all, all supported architectures for the target platforms specified by platform will be built. Arbitrary combinations of individual architectures are also supported via a comma-delimited @@ -83,7 +83,7 @@

  • arm64 (Linux: Electron 1.8.0 and above; Windows: 6.0.8 and above; macOS: 11.0.0-beta.1 and above)
  • mips64el (Electron 1.8.2-beta.5 to 1.8.8)
  • -
    asar?: boolean | CreateOptions

    Whether to package the application's source code into an archive, using Electron's +

    asar?: boolean | CreateOptions

    Whether to package the application's source code into an archive, using Electron's archive format. Reasons why you may want to enable this feature include mitigating issues around long path names on Windows, slightly speeding up require, and concealing your source code from cursory inspection. When the value @@ -107,18 +107,18 @@

  • asar.unpackDir = path.join('**', '{sub_dir1/sub_sub_dir,sub_dir2}', '**', '*') will unpack the directories /<dir>/sub_dir1/sub_sub_dir and /<dir>/sub_dir2 and their subdirectories.
  • Note: asar will have no effect if the prebuiltAsar option is set.

    -
    beforeAsar?: HookFunction[]

    Functions to be called before your app directory is packaged into an .asar file.

    +
    beforeAsar?: HookFunction[]

    Functions to be called before your app directory is packaged into an .asar file.

    Note: beforeAsar will only be called if the asar option is set.

    -
    beforeCopy?: HookFunction[]

    Functions to be called before your app directory is copied to a temporary directory.

    +
    beforeCopy?: HookFunction[]

    Functions to be called before your app directory is copied to a temporary directory.

    Note: beforeCopy will not be called if the prebuiltAsar option is set.

    -
    beforeCopyExtraResources?: HookFunction[]

    Functions to be called before the files specified in the extraResource option are copied.

    -
    buildVersion?: string

    The build version of the application. Defaults to the value of the appVersion option. +

    beforeCopyExtraResources?: HookFunction[]

    Functions to be called before the files specified in the extraResource option are copied.

    +
    buildVersion?: string

    The build version of the application. Defaults to the value of the appVersion option. Maps to the FileVersion metadata property on Windows, and CFBundleVersion on macOS.

    -
    derefSymlinks?: boolean

    Whether symlinks should be dereferenced during the copying of the application source. +

    derefSymlinks?: boolean

    Whether symlinks should be dereferenced during the copying of the application source. Defaults to true.

    Note: derefSymlinks will have no effect if the prebuiltAsar option is set.

    -
    dir: string

    The source directory.

    -
    download?: ElectronDownloadRequestOptions

    If present, passes custom options to @electron/get. See +

    dir: string

    The source directory.

    +
    download?: ElectronDownloadRequestOptions

    If present, passes custom options to @electron/get. See the module for option descriptions, proxy support, and defaults. Supported parameters include, but are not limited to:

      @@ -126,26 +126,26 @@
    • mirrorOptions (Object): Options to override the default Electron download location.

    Note: download sub-options will have no effect if the electronZipDir option is set.

    -
    electronVersion?: string

    The Electron version with which the app is built (without the leading 'v') - for example, +

    electronVersion?: string

    The Electron version with which the app is built (without the leading 'v') - for example, 1.4.13. See Electron releases for valid versions. If omitted, it

    • will use the version of the nearest local installation of electron or electron-nightly
    • defined in package.json in either devDependencies or dependencies.
    -
    electronZipDir?: string

    The local path to a directory containing Electron ZIP files for Electron Packager to unzip, instead +

    electronZipDir?: string

    The local path to a directory containing Electron ZIP files for Electron Packager to unzip, instead of downloading them. The ZIP filenames should be in the same format as the ones downloaded from the Electron releases site.

    Note: Setting this option prevents the download sub-options from being used, as the functionality gets skipped over.

    -
    executableName?: string

    The name of the executable file, sans file extension. Defaults to the value for the name +

    executableName?: string

    The name of the executable file, sans file extension. Defaults to the value for the name option. For darwin or mas target platforms, this does not affect the name of the .app folder - this will use the name option instead.

    -
    extraResource?: string | string[]

    One or more files to be copied directly into the app's Contents/Resources directory for +

    extraResource?: string | string[]

    One or more files to be copied directly into the app's Contents/Resources directory for macOS target platforms, and the resources directory for other target platforms. The resources directory can be referenced in the packaged app via the process.resourcesPath value.

    -
    icon?: string

    The local path to the icon file, if the target platform supports setting embedding an icon.

    +
    icon?: string

    The local path to the icon file, if the target platform supports setting embedding an icon.

    Currently you must look for conversion tools in order to supply an icon in the format required by the platform:

    • macOS: .icns
    • @@ -157,7 +157,7 @@

    If the file extension is omitted, it is auto-completed to the correct extension based on the platform, including when [[platform|platform: 'all']] is in effect.

    -
    ignore?: RegExp | (string | RegExp)[] | IgnoreFunction

    One or more additional regular expression +

    ignore?: RegExp | (string | RegExp)[] | IgnoreFunction

    One or more additional regular expression patterns which specify which files to ignore when copying files to create the app bundle(s). The regular expressions are matched against the absolute path of a given file/directory to be copied.

    Please note that glob patterns will not work.

    @@ -179,21 +179,21 @@

    Note: Node modules specified in devDependencies are ignored by default, via the prune option.

    Note: ignore will have no effect if the prebuiltAsar option is set.

    -
    junk?: boolean

    Ignores system junk files when copying the Electron app, +

    junk?: boolean

    Ignores system junk files when copying the Electron app, regardless of the ignore option.

    Note: junk will have no effect if the prebuiltAsar option is set.

    -
    name?: string

    The application name. If omitted, it will use the productName or name value from the +

    name?: string

    The application name. If omitted, it will use the productName or name value from the nearest package.json.

    Regardless of source, characters in the Electron app name which are not allowed in all target platforms' filenames (e.g., /), will be replaced by hyphens (-).

    -
    osxUniversal?: OsxUniversalOptions

    Used to provide custom options to the internal call to @electron/universal when building a macOS +

    osxUniversal?: OsxUniversalOptions

    Used to provide custom options to the internal call to @electron/universal when building a macOS app with the target architecture of "universal". Unused otherwise, providing a value does not imply a universal app is built.

    -
    out?: string

    The base directory where the finished package(s) are created.

    +
    out?: string

    The base directory where the finished package(s) are created.

    Defaults to the current working directory.

    -
    overwrite?: boolean

    Whether to replace an already existing output directory for a given platform (true) or +

    overwrite?: boolean

    Whether to replace an already existing output directory for a given platform (true) or skip recreating it (false). Defaults to false.

    -
    platform: string | string[]

    The target platform(s) to build for.

    +
    platform: string | string[]

    The target platform(s) to build for.

    Not required if the all option is set. If platform is set to all, all officially supported target platforms for the target architectures specified by the arch option will be built. Arbitrary combinations of individual platforms are also supported via a @@ -209,7 +209,7 @@

  • mas (macOS, specifically for submitting to the Mac App Store)
  • win32
  • -
    prebuiltAsar?: string

    The path to a prebuilt ASAR file.

    +
    prebuiltAsar?: string

    The path to a prebuilt ASAR file.

    Note: Setting this option prevents the following options from being used, as the functionality gets skipped over:

    -
    prune?: boolean

    Walks the node_modules dependency tree to remove all of the packages specified in the +

    prune?: boolean

    Walks the node_modules dependency tree to remove all of the packages specified in the devDependencies section of package.json from the outputted Electron app.

    Defaults to true.

    Note: prune will have no effect if the prebuiltAsar option is set.

    -
    quiet?: boolean

    If true, disables printing informational and warning messages to the console when +

    quiet?: boolean

    If true, disables printing informational and warning messages to the console when packaging the application. This does not disable errors.

    Defaults to false.

    -
    tmpdir?: string | false

    The base directory to use as a temporary directory. Set to false to disable use of a +

    tmpdir?: string | false

    The base directory to use as a temporary directory. Set to false to disable use of a temporary directory. Defaults to the system's temporary directory.

    -

    Windows

    win32metadata?: Win32MetadataOptions

    Application metadata to embed into the Windows executable.

    -
    windowsSign?: true | WindowsSignOptions

    If present, signs Windows binary files. +

    Windows

    win32metadata?: Win32MetadataOptions

    Application metadata to embed into the Windows executable.

    +
    windowsSign?: true | WindowsSignOptions

    If present, signs Windows binary files. When the value is true, pass default configuration to the signing module. See @electron/windows-sign for sub-option descriptions and their defaults.

    -

    macOS

    appCategoryType?: string

    The application category type, as shown in the Finder via View → Arrange by Application +

    macOS

    appCategoryType?: string

    The application category type, as shown in the Finder via View → Arrange by Application Category when viewing the Applications directory.

    For example, app-category-type=public.app-category.developer-tools will set the application category to Developer Tools.

    Valid values are listed in Apple's documentation.

    -
    darwinDarkModeSupport?: boolean

    Forces support for Mojave (macOS 10.14) dark mode in your packaged app. This sets the +

    darwinDarkModeSupport?: boolean

    Forces support for Mojave (macOS 10.14) dark mode in your packaged app. This sets the NSRequiresAquaSystemAppearance key to false in your app's Info.plist. For more information, see the Electron documentation and the Apple developer documentation.

    -
    extendHelperInfo?: string | {
        [property: string]: any;
    }

    When the value is a string, specifies the filename of a plist file. Its contents are merged +

    extendHelperInfo?: string | {
        [property: string]: any;
    }

    When the value is a string, specifies the filename of a plist file. Its contents are merged into all the Helper apps' Info.plist files. When the value is an Object, it specifies an already-parsed plist data structure that is merged into all the Helper apps' Info.plist files.

    @@ -253,7 +253,7 @@
  • electron or electron-nightly, but are overridden by other options such as appVersion or appBundleId.
  • -

    Type declaration

    • [property: string]: any
    extendInfo?: string | {
        [property: string]: any;
    }

    When the value is a string, specifies the filename of a plist file. Its contents are merged +

    Type declaration

    • [property: string]: any
    extendInfo?: string | {
        [property: string]: any;
    }

    When the value is a string, specifies the filename of a plist file. Its contents are merged into the app's Info.plist. When the value is an Object, it specifies an already-parsed plist data structure that is merged into the app's Info.plist.

    @@ -262,12 +262,12 @@
  • electron or electron-nightly, but are overridden by other options such as appVersion or appBundleId.
  • -

    Type declaration

    • [property: string]: any
    helperBundleId?: string

    The bundle identifier to use in the application helper's Info.plist.

    -
    osxNotarize?: NotaryToolCredentials

    If present, notarizes macOS target apps when the host platform is macOS and Xcode is installed. +

    Type declaration

    • [property: string]: any
    helperBundleId?: string

    The bundle identifier to use in the application helper's Info.plist.

    +
    osxNotarize?: NotaryToolCredentials

    If present, notarizes macOS target apps when the host platform is macOS and Xcode is installed. See @electron/notarize for option descriptions, such as how to use appleIdPassword safely or obtain an API key.

    Requires the osxSign option to be set.

    -
    osxSign?: true | OsxSignOptions

    If present, signs macOS target apps when the host platform is macOS and Xcode is installed. +

    osxSign?: true | OsxSignOptions

    If present, signs macOS target apps when the host platform is macOS and Xcode is installed. When the value is true, pass default configuration to the signing module. See @electron/osx-sign for sub-option descriptions and their defaults. Options include, but are not limited to:

    @@ -275,8 +275,8 @@
  • identity (string): The identity used when signing the package via codesign.
  • binaries (array): Path to additional binaries that will be signed along with built-ins of Electron/
  • -
    protocols?: MacOSProtocol[]

    The URL protocol schemes associated with the Electron app.

    -
    usageDescription?: {
        [property: string]: string;
    }

    Human-readable descriptions of how the Electron app uses certain macOS features. These are displayed +

    protocols?: MacOSProtocol[]

    The URL protocol schemes associated with the Electron app.

    +
    usageDescription?: {
        [property: string]: string;
    }

    Human-readable descriptions of how the Electron app uses certain macOS features. These are displayed in the App Store. A non-exhaustive list of available properties:

    • Camera - required for media access API usage in macOS Catalina
    • @@ -287,4 +287,4 @@

      Example:

      {
      usageDescription: {
      Camera: 'Needed for video calls',
      Microphone: 'Needed for voice calls'
      }
      }
      -

    Type declaration

    • [property: string]: string
    \ No newline at end of file +

    Type declaration

    \ No newline at end of file diff --git a/main/interfaces/DownloadOptions.html b/main/interfaces/DownloadOptions.html index 987c9dd8..2afefcac 100644 --- a/main/interfaces/DownloadOptions.html +++ b/main/interfaces/DownloadOptions.html @@ -1,4 +1,4 @@ -DownloadOptions | @electron/packager

    Interface DownloadOptions

    interface DownloadOptions {
        afterAsar?: HookFunction[];
        afterComplete?: HookFunction[];
        afterCopy?: HookFunction[];
        afterCopyExtraResources?: HookFunction[];
        afterExtract?: HookFunction[];
        afterFinalizePackageTargets?: FinalizePackageTargetsHookFunction[];
        afterInitialize?: HookFunction[];
        afterPrune?: HookFunction[];
        all?: boolean;
        appBundleId?: string;
        appCategoryType?: string;
        appCopyright?: string;
        appVersion?: string;
        arch: string | string[];
        artifactName: string;
        asar?: boolean | CreateOptions;
        beforeAsar?: HookFunction[];
        beforeCopy?: HookFunction[];
        beforeCopyExtraResources?: HookFunction[];
        buildVersion?: string;
        darwinDarkModeSupport?: boolean;
        derefSymlinks?: boolean;
        dir: string;
        download?: ElectronDownloadRequestOptions;
        electronVersion?: string;
        electronZipDir?: string;
        executableName?: string;
        extendHelperInfo?: string | {
            [property: string]: any;
        };
        extendInfo?: string | {
            [property: string]: any;
        };
        extraResource?: string | string[];
        helperBundleId?: string;
        icon?: string;
        ignore?: RegExp | (string | RegExp)[] | IgnoreFunction;
        junk?: boolean;
        name?: string;
        osxNotarize?: NotaryToolCredentials;
        osxSign?: true | OsxSignOptions;
        osxUniversal?: OsxUniversalOptions;
        out?: string;
        overwrite?: boolean;
        platform: string | string[];
        prebuiltAsar?: string;
        protocols?: MacOSProtocol[];
        prune?: boolean;
        quiet?: boolean;
        tmpdir?: string | false;
        usageDescription?: {
            [property: string]: string;
        };
        version: string;
        win32metadata?: Win32MetadataOptions;
        windowsSign?: true | WindowsSignOptions;
    }

    Hierarchy

    • OptionsWithRequiredArchAndPlatform
      • DownloadOptions

    Other

    afterAsar? +DownloadOptions | @electron/packager

    Interface DownloadOptions

    interface DownloadOptions {
        afterAsar?: HookFunction[];
        afterComplete?: HookFunction[];
        afterCopy?: HookFunction[];
        afterCopyExtraResources?: HookFunction[];
        afterExtract?: HookFunction[];
        afterFinalizePackageTargets?: FinalizePackageTargetsHookFunction[];
        afterInitialize?: HookFunction[];
        afterPrune?: HookFunction[];
        all?: boolean;
        appBundleId?: string;
        appCategoryType?: string;
        appCopyright?: string;
        appVersion?: string;
        arch: string | string[];
        artifactName: string;
        asar?: boolean | CreateOptions;
        beforeAsar?: HookFunction[];
        beforeCopy?: HookFunction[];
        beforeCopyExtraResources?: HookFunction[];
        buildVersion?: string;
        darwinDarkModeSupport?: boolean;
        derefSymlinks?: boolean;
        dir: string;
        download?: ElectronDownloadRequestOptions;
        electronVersion?: string;
        electronZipDir?: string;
        executableName?: string;
        extendHelperInfo?: string | {
            [property: string]: any;
        };
        extendInfo?: string | {
            [property: string]: any;
        };
        extraResource?: string | string[];
        helperBundleId?: string;
        icon?: string;
        ignore?: RegExp | (string | RegExp)[] | IgnoreFunction;
        junk?: boolean;
        name?: string;
        osxNotarize?: NotaryToolCredentials;
        osxSign?: true | OsxSignOptions;
        osxUniversal?: OsxUniversalOptions;
        out?: string;
        overwrite?: boolean;
        platform: string | string[];
        prebuiltAsar?: string;
        protocols?: MacOSProtocol[];
        prune?: boolean;
        quiet?: boolean;
        tmpdir?: string | false;
        usageDescription?: {
            [property: string]: string;
        };
        version: string;
        win32metadata?: Win32MetadataOptions;
        windowsSign?: true | WindowsSignOptions;
    }

    Hierarchy

    • OptionsWithRequiredArchAndPlatform
      • DownloadOptions

    Other

    afterAsar?: HookFunction[]

    Functions to be called after your app directory has been packaged into an .asar file.

    Note: afterAsar will only be called if the asar option is set.

    -
    afterComplete?: HookFunction[]

    Functions to be called after the packaged application has been moved to the final directory.

    -
    afterCopy?: HookFunction[]

    Functions to be called after your app directory has been copied to a temporary directory.

    +
    afterComplete?: HookFunction[]

    Functions to be called after the packaged application has been moved to the final directory.

    +
    afterCopy?: HookFunction[]

    Functions to be called after your app directory has been copied to a temporary directory.

    Note: afterCopy will not be called if the prebuiltAsar option is set.

    -
    afterCopyExtraResources?: HookFunction[]

    Functions to be called after the files specified in the extraResource option have been copied.

    -
    afterExtract?: HookFunction[]

    Functions to be called after the prebuilt Electron binary has been extracted to a temporary directory.

    -
    afterFinalizePackageTargets?: FinalizePackageTargetsHookFunction[]

    Functions to be called after the final matrix of platform/arch combination is determined. Use this to +

    afterCopyExtraResources?: HookFunction[]

    Functions to be called after the files specified in the extraResource option have been copied.

    +
    afterExtract?: HookFunction[]

    Functions to be called after the prebuilt Electron binary has been extracted to a temporary directory.

    +
    afterFinalizePackageTargets?: FinalizePackageTargetsHookFunction[]

    Functions to be called after the final matrix of platform/arch combination is determined. Use this to learn what archs/platforms packager is targetting when you pass "all" as a value.

    -
    afterInitialize?: HookFunction[]
    afterPrune?: HookFunction[]

    Functions to be called after Node module pruning has been applied to the application.

    +
    afterInitialize?: HookFunction[]
    afterPrune?: HookFunction[]

    Functions to be called after Node module pruning has been applied to the application.

    Note: None of these functions will be called if the prune option is false or the prebuiltAsar option is set.

    -
    all?: boolean

    When true, sets both arch and platform to all.

    -
    appBundleId?: string
    appCopyright?: string

    The human-readable copyright line for the app. Maps to the LegalCopyright metadata +

    all?: boolean

    When true, sets both arch and platform to all.

    +
    appBundleId?: string
    appCopyright?: string

    The human-readable copyright line for the app. Maps to the LegalCopyright metadata property on Windows, and NSHumanReadableCopyright on macOS.

    -
    appVersion?: string

    The release version of the application.

    +
    appVersion?: string

    The release version of the application.

    By default the version property in the package.json is used, but it can be overridden with this argument. If neither are provided, the version of Electron will be used. Maps to the ProductVersion metadata property on Windows, and CFBundleShortVersionString on macOS.

    -
    arch: string | string[]
    artifactName: string
    asar?: boolean | CreateOptions

    Whether to package the application's source code into an archive, using Electron's +

    arch: string | string[]
    artifactName: string
    asar?: boolean | CreateOptions

    Whether to package the application's source code into an archive, using Electron's archive format. Reasons why you may want to enable this feature include mitigating issues around long path names on Windows, slightly speeding up require, and concealing your source code from cursory inspection. When the value @@ -92,18 +92,18 @@

  • asar.unpackDir = path.join('**', '{sub_dir1/sub_sub_dir,sub_dir2}', '**', '*') will unpack the directories /<dir>/sub_dir1/sub_sub_dir and /<dir>/sub_dir2 and their subdirectories.
  • Note: asar will have no effect if the prebuiltAsar option is set.

    -
    beforeAsar?: HookFunction[]

    Functions to be called before your app directory is packaged into an .asar file.

    +
    beforeAsar?: HookFunction[]

    Functions to be called before your app directory is packaged into an .asar file.

    Note: beforeAsar will only be called if the asar option is set.

    -
    beforeCopy?: HookFunction[]

    Functions to be called before your app directory is copied to a temporary directory.

    +
    beforeCopy?: HookFunction[]

    Functions to be called before your app directory is copied to a temporary directory.

    Note: beforeCopy will not be called if the prebuiltAsar option is set.

    -
    beforeCopyExtraResources?: HookFunction[]

    Functions to be called before the files specified in the extraResource option are copied.

    -
    buildVersion?: string

    The build version of the application. Defaults to the value of the appVersion option. +

    beforeCopyExtraResources?: HookFunction[]

    Functions to be called before the files specified in the extraResource option are copied.

    +
    buildVersion?: string

    The build version of the application. Defaults to the value of the appVersion option. Maps to the FileVersion metadata property on Windows, and CFBundleVersion on macOS.

    -
    derefSymlinks?: boolean

    Whether symlinks should be dereferenced during the copying of the application source. +

    derefSymlinks?: boolean

    Whether symlinks should be dereferenced during the copying of the application source. Defaults to true.

    Note: derefSymlinks will have no effect if the prebuiltAsar option is set.

    -
    dir: string

    The source directory.

    -
    download?: ElectronDownloadRequestOptions

    If present, passes custom options to @electron/get. See +

    dir: string

    The source directory.

    +
    download?: ElectronDownloadRequestOptions

    If present, passes custom options to @electron/get. See the module for option descriptions, proxy support, and defaults. Supported parameters include, but are not limited to:

      @@ -111,26 +111,26 @@
    • mirrorOptions (Object): Options to override the default Electron download location.

    Note: download sub-options will have no effect if the electronZipDir option is set.

    -
    electronVersion?: string

    The Electron version with which the app is built (without the leading 'v') - for example, +

    electronVersion?: string

    The Electron version with which the app is built (without the leading 'v') - for example, 1.4.13. See Electron releases for valid versions. If omitted, it

    • will use the version of the nearest local installation of electron or electron-nightly
    • defined in package.json in either devDependencies or dependencies.
    -
    electronZipDir?: string

    The local path to a directory containing Electron ZIP files for Electron Packager to unzip, instead +

    electronZipDir?: string

    The local path to a directory containing Electron ZIP files for Electron Packager to unzip, instead of downloading them. The ZIP filenames should be in the same format as the ones downloaded from the Electron releases site.

    Note: Setting this option prevents the download sub-options from being used, as the functionality gets skipped over.

    -
    executableName?: string

    The name of the executable file, sans file extension. Defaults to the value for the name +

    executableName?: string

    The name of the executable file, sans file extension. Defaults to the value for the name option. For darwin or mas target platforms, this does not affect the name of the .app folder - this will use the name option instead.

    -
    extraResource?: string | string[]

    One or more files to be copied directly into the app's Contents/Resources directory for +

    extraResource?: string | string[]

    One or more files to be copied directly into the app's Contents/Resources directory for macOS target platforms, and the resources directory for other target platforms. The resources directory can be referenced in the packaged app via the process.resourcesPath value.

    -
    icon?: string

    The local path to the icon file, if the target platform supports setting embedding an icon.

    +
    icon?: string

    The local path to the icon file, if the target platform supports setting embedding an icon.

    Currently you must look for conversion tools in order to supply an icon in the format required by the platform:

    • macOS: .icns
    • @@ -142,7 +142,7 @@

    If the file extension is omitted, it is auto-completed to the correct extension based on the platform, including when [[platform|platform: 'all']] is in effect.

    -
    ignore?: RegExp | (string | RegExp)[] | IgnoreFunction

    One or more additional regular expression +

    ignore?: RegExp | (string | RegExp)[] | IgnoreFunction

    One or more additional regular expression patterns which specify which files to ignore when copying files to create the app bundle(s). The regular expressions are matched against the absolute path of a given file/directory to be copied.

    Please note that glob patterns will not work.

    @@ -164,21 +164,21 @@

    Note: Node modules specified in devDependencies are ignored by default, via the prune option.

    Note: ignore will have no effect if the prebuiltAsar option is set.

    -
    junk?: boolean

    Ignores system junk files when copying the Electron app, +

    junk?: boolean

    Ignores system junk files when copying the Electron app, regardless of the ignore option.

    Note: junk will have no effect if the prebuiltAsar option is set.

    -
    name?: string

    The application name. If omitted, it will use the productName or name value from the +

    name?: string

    The application name. If omitted, it will use the productName or name value from the nearest package.json.

    Regardless of source, characters in the Electron app name which are not allowed in all target platforms' filenames (e.g., /), will be replaced by hyphens (-).

    -
    osxUniversal?: OsxUniversalOptions

    Used to provide custom options to the internal call to @electron/universal when building a macOS +

    osxUniversal?: OsxUniversalOptions

    Used to provide custom options to the internal call to @electron/universal when building a macOS app with the target architecture of "universal". Unused otherwise, providing a value does not imply a universal app is built.

    -
    out?: string

    The base directory where the finished package(s) are created.

    +
    out?: string

    The base directory where the finished package(s) are created.

    Defaults to the current working directory.

    -
    overwrite?: boolean

    Whether to replace an already existing output directory for a given platform (true) or +

    overwrite?: boolean

    Whether to replace an already existing output directory for a given platform (true) or skip recreating it (false). Defaults to false.

    -
    platform: string | string[]
    prebuiltAsar?: string

    The path to a prebuilt ASAR file.

    +
    platform: string | string[]
    prebuiltAsar?: string

    The path to a prebuilt ASAR file.

    Note: Setting this option prevents the following options from being used, as the functionality gets skipped over:

    -
    prune?: boolean

    Walks the node_modules dependency tree to remove all of the packages specified in the +

    prune?: boolean

    Walks the node_modules dependency tree to remove all of the packages specified in the devDependencies section of package.json from the outputted Electron app.

    Defaults to true.

    Note: prune will have no effect if the prebuiltAsar option is set.

    -
    quiet?: boolean

    If true, disables printing informational and warning messages to the console when +

    quiet?: boolean

    If true, disables printing informational and warning messages to the console when packaging the application. This does not disable errors.

    Defaults to false.

    -
    tmpdir?: string | false

    The base directory to use as a temporary directory. Set to false to disable use of a +

    tmpdir?: string | false

    The base directory to use as a temporary directory. Set to false to disable use of a temporary directory. Defaults to the system's temporary directory.

    -
    version: string

    Windows

    win32metadata?: Win32MetadataOptions

    Application metadata to embed into the Windows executable.

    -
    windowsSign?: true | WindowsSignOptions

    If present, signs Windows binary files. +

    version: string

    Windows

    win32metadata?: Win32MetadataOptions

    Application metadata to embed into the Windows executable.

    +
    windowsSign?: true | WindowsSignOptions

    If present, signs Windows binary files. When the value is true, pass default configuration to the signing module. See @electron/windows-sign for sub-option descriptions and their defaults.

    -

    macOS

    appCategoryType?: string

    The application category type, as shown in the Finder via View → Arrange by Application +

    macOS

    appCategoryType?: string

    The application category type, as shown in the Finder via View → Arrange by Application Category when viewing the Applications directory.

    For example, app-category-type=public.app-category.developer-tools will set the application category to Developer Tools.

    Valid values are listed in Apple's documentation.

    -
    darwinDarkModeSupport?: boolean

    Forces support for Mojave (macOS 10.14) dark mode in your packaged app. This sets the +

    darwinDarkModeSupport?: boolean

    Forces support for Mojave (macOS 10.14) dark mode in your packaged app. This sets the NSRequiresAquaSystemAppearance key to false in your app's Info.plist. For more information, see the Electron documentation and the Apple developer documentation.

    -
    extendHelperInfo?: string | {
        [property: string]: any;
    }

    When the value is a string, specifies the filename of a plist file. Its contents are merged +

    extendHelperInfo?: string | {
        [property: string]: any;
    }

    When the value is a string, specifies the filename of a plist file. Its contents are merged into all the Helper apps' Info.plist files. When the value is an Object, it specifies an already-parsed plist data structure that is merged into all the Helper apps' Info.plist files.

    @@ -222,7 +222,7 @@
  • electron or electron-nightly, but are overridden by other options such as appVersion or appBundleId.
  • -

    Type declaration

    • [property: string]: any
    extendInfo?: string | {
        [property: string]: any;
    }

    When the value is a string, specifies the filename of a plist file. Its contents are merged +

    Type declaration

    • [property: string]: any
    extendInfo?: string | {
        [property: string]: any;
    }

    When the value is a string, specifies the filename of a plist file. Its contents are merged into the app's Info.plist. When the value is an Object, it specifies an already-parsed plist data structure that is merged into the app's Info.plist.

    @@ -231,12 +231,12 @@
  • electron or electron-nightly, but are overridden by other options such as appVersion or appBundleId.
  • -

    Type declaration

    • [property: string]: any
    helperBundleId?: string

    The bundle identifier to use in the application helper's Info.plist.

    -
    osxNotarize?: NotaryToolCredentials

    If present, notarizes macOS target apps when the host platform is macOS and Xcode is installed. +

    Type declaration

    • [property: string]: any
    helperBundleId?: string

    The bundle identifier to use in the application helper's Info.plist.

    +
    osxNotarize?: NotaryToolCredentials

    If present, notarizes macOS target apps when the host platform is macOS and Xcode is installed. See @electron/notarize for option descriptions, such as how to use appleIdPassword safely or obtain an API key.

    Requires the osxSign option to be set.

    -
    osxSign?: true | OsxSignOptions

    If present, signs macOS target apps when the host platform is macOS and Xcode is installed. +

    osxSign?: true | OsxSignOptions

    If present, signs macOS target apps when the host platform is macOS and Xcode is installed. When the value is true, pass default configuration to the signing module. See @electron/osx-sign for sub-option descriptions and their defaults. Options include, but are not limited to:

    @@ -244,8 +244,8 @@
  • identity (string): The identity used when signing the package via codesign.
  • binaries (array): Path to additional binaries that will be signed along with built-ins of Electron/
  • -
    protocols?: MacOSProtocol[]

    The URL protocol schemes associated with the Electron app.

    -
    usageDescription?: {
        [property: string]: string;
    }

    Human-readable descriptions of how the Electron app uses certain macOS features. These are displayed +

    protocols?: MacOSProtocol[]

    The URL protocol schemes associated with the Electron app.

    +
    usageDescription?: {
        [property: string]: string;
    }

    Human-readable descriptions of how the Electron app uses certain macOS features. These are displayed in the App Store. A non-exhaustive list of available properties:

    • Camera - required for media access API usage in macOS Catalina
    • @@ -256,4 +256,4 @@

      Example:

      {
      usageDescription: {
      Camera: 'Needed for video calls',
      Microphone: 'Needed for voice calls'
      }
      }
      -

    Type declaration

    • [property: string]: string
    \ No newline at end of file +

    Type declaration

    • [property: string]: string
    \ No newline at end of file diff --git a/main/interfaces/MacOSProtocol.html b/main/interfaces/MacOSProtocol.html index ce81d7dd..e850a407 100644 --- a/main/interfaces/MacOSProtocol.html +++ b/main/interfaces/MacOSProtocol.html @@ -1,8 +1,8 @@ MacOSProtocol | @electron/packager

    Interface MacOSProtocol

    Defines URL protocol schemes to be used on macOS.

    -
    interface MacOSProtocol {
        name: string;
        schemes: string[];
    }

    Properties

    interface MacOSProtocol {
        name: string;
        schemes: string[];
    }

    Properties

    Properties

    name: string

    The descriptive name. Maps to the CFBundleURLName metadata property.

    -
    schemes: string[]

    One or more protocol schemes associated with the app. For example, specifying myapp +

    schemes: string[]

    One or more protocol schemes associated with the app. For example, specifying myapp would cause URLs such as myapp://path to be opened with the app. Maps to the CFBundleURLSchemes metadata property.

    -
    \ No newline at end of file +
    \ No newline at end of file diff --git a/main/interfaces/Options.html b/main/interfaces/Options.html index 6152d23d..8ac7f937 100644 --- a/main/interfaces/Options.html +++ b/main/interfaces/Options.html @@ -1,5 +1,5 @@ Options | @electron/packager

    Interface Options

    Options passed to the packager() function.

    -
    interface Options {
        afterAsar?: HookFunction[];
        afterComplete?: HookFunction[];
        afterCopy?: HookFunction[];
        afterCopyExtraResources?: HookFunction[];
        afterExtract?: HookFunction[];
        afterFinalizePackageTargets?: FinalizePackageTargetsHookFunction[];
        afterInitialize?: HookFunction[];
        afterPrune?: HookFunction[];
        all?: boolean;
        appBundleId?: string;
        appCategoryType?: string;
        appCopyright?: string;
        appVersion?: string;
        arch?: string | string[];
        asar?: boolean | CreateOptions;
        beforeAsar?: HookFunction[];
        beforeCopy?: HookFunction[];
        beforeCopyExtraResources?: HookFunction[];
        buildVersion?: string;
        darwinDarkModeSupport?: boolean;
        derefSymlinks?: boolean;
        dir: string;
        download?: ElectronDownloadRequestOptions;
        electronVersion?: string;
        electronZipDir?: string;
        executableName?: string;
        extendHelperInfo?: string | {
            [property: string]: any;
        };
        extendInfo?: string | {
            [property: string]: any;
        };
        extraResource?: string | string[];
        helperBundleId?: string;
        icon?: string;
        ignore?: RegExp | (string | RegExp)[] | IgnoreFunction;
        junk?: boolean;
        name?: string;
        osxNotarize?: NotaryToolCredentials;
        osxSign?: true | OsxSignOptions;
        osxUniversal?: OsxUniversalOptions;
        out?: string;
        overwrite?: boolean;
        platform?: string | string[];
        prebuiltAsar?: string;
        protocols?: MacOSProtocol[];
        prune?: boolean;
        quiet?: boolean;
        tmpdir?: string | false;
        usageDescription?: {
            [property: string]: string;
        };
        win32metadata?: Win32MetadataOptions;
        windowsSign?: true | WindowsSignOptions;
    }

    Hierarchy (view full)

    Other

    interface Options {
        afterAsar?: HookFunction[];
        afterComplete?: HookFunction[];
        afterCopy?: HookFunction[];
        afterCopyExtraResources?: HookFunction[];
        afterExtract?: HookFunction[];
        afterFinalizePackageTargets?: FinalizePackageTargetsHookFunction[];
        afterInitialize?: HookFunction[];
        afterPrune?: HookFunction[];
        all?: boolean;
        appBundleId?: string;
        appCategoryType?: string;
        appCopyright?: string;
        appVersion?: string;
        arch?: string | string[];
        asar?: boolean | CreateOptions;
        beforeAsar?: HookFunction[];
        beforeCopy?: HookFunction[];
        beforeCopyExtraResources?: HookFunction[];
        buildVersion?: string;
        darwinDarkModeSupport?: boolean;
        derefSymlinks?: boolean;
        dir: string;
        download?: ElectronDownloadRequestOptions;
        electronVersion?: string;
        electronZipDir?: string;
        executableName?: string;
        extendHelperInfo?: string | {
            [property: string]: any;
        };
        extendInfo?: string | {
            [property: string]: any;
        };
        extraResource?: string | string[];
        helperBundleId?: string;
        icon?: string;
        ignore?: RegExp | (string | RegExp)[] | IgnoreFunction;
        junk?: boolean;
        name?: string;
        osxNotarize?: NotaryToolCredentials;
        osxSign?: true | OsxSignOptions;
        osxUniversal?: OsxUniversalOptions;
        out?: string;
        overwrite?: boolean;
        platform?: string | string[];
        prebuiltAsar?: string;
        protocols?: MacOSProtocol[];
        prune?: boolean;
        quiet?: boolean;
        tmpdir?: string | false;
        usageDescription?: {
            [property: string]: string;
        };
        win32metadata?: Win32MetadataOptions;
        windowsSign?: true | WindowsSignOptions;
    }

    Hierarchy (view full)

    Other

    afterAsar?: HookFunction[]

    Functions to be called after your app directory has been packaged into an .asar file.

    Note: afterAsar will only be called if the asar option is set.

    -
    afterComplete?: HookFunction[]

    Functions to be called after the packaged application has been moved to the final directory.

    -
    afterCopy?: HookFunction[]

    Functions to be called after your app directory has been copied to a temporary directory.

    +
    afterComplete?: HookFunction[]

    Functions to be called after the packaged application has been moved to the final directory.

    +
    afterCopy?: HookFunction[]

    Functions to be called after your app directory has been copied to a temporary directory.

    Note: afterCopy will not be called if the prebuiltAsar option is set.

    -
    afterCopyExtraResources?: HookFunction[]

    Functions to be called after the files specified in the extraResource option have been copied.

    -
    afterExtract?: HookFunction[]

    Functions to be called after the prebuilt Electron binary has been extracted to a temporary directory.

    -
    afterFinalizePackageTargets?: FinalizePackageTargetsHookFunction[]

    Functions to be called after the final matrix of platform/arch combination is determined. Use this to +

    afterCopyExtraResources?: HookFunction[]

    Functions to be called after the files specified in the extraResource option have been copied.

    +
    afterExtract?: HookFunction[]

    Functions to be called after the prebuilt Electron binary has been extracted to a temporary directory.

    +
    afterFinalizePackageTargets?: FinalizePackageTargetsHookFunction[]

    Functions to be called after the final matrix of platform/arch combination is determined. Use this to learn what archs/platforms packager is targetting when you pass "all" as a value.

    -
    afterInitialize?: HookFunction[]
    afterPrune?: HookFunction[]

    Functions to be called after Node module pruning has been applied to the application.

    +
    afterInitialize?: HookFunction[]
    afterPrune?: HookFunction[]

    Functions to be called after Node module pruning has been applied to the application.

    Note: None of these functions will be called if the prune option is false or the prebuiltAsar option is set.

    -
    all?: boolean

    When true, sets both arch and platform to all.

    -
    appBundleId?: string
    appCopyright?: string

    The human-readable copyright line for the app. Maps to the LegalCopyright metadata +

    all?: boolean

    When true, sets both arch and platform to all.

    +
    appBundleId?: string
    appCopyright?: string

    The human-readable copyright line for the app. Maps to the LegalCopyright metadata property on Windows, and NSHumanReadableCopyright on macOS.

    -
    appVersion?: string

    The release version of the application.

    +
    appVersion?: string

    The release version of the application.

    By default the version property in the package.json is used, but it can be overridden with this argument. If neither are provided, the version of Electron will be used. Maps to the ProductVersion metadata property on Windows, and CFBundleShortVersionString on macOS.

    -
    arch?: string | string[]

    The target system architecture(s) to build for.

    +
    arch?: string | string[]

    The target system architecture(s) to build for.

    Not required if the all option is set. If arch is set to all, all supported architectures for the target platforms specified by platform will be built. Arbitrary combinations of individual architectures are also supported via a comma-delimited @@ -83,7 +83,7 @@

  • arm64 (Linux: Electron 1.8.0 and above; Windows: 6.0.8 and above; macOS: 11.0.0-beta.1 and above)
  • mips64el (Electron 1.8.2-beta.5 to 1.8.8)
  • -
    asar?: boolean | CreateOptions

    Whether to package the application's source code into an archive, using Electron's +

    asar?: boolean | CreateOptions

    Whether to package the application's source code into an archive, using Electron's archive format. Reasons why you may want to enable this feature include mitigating issues around long path names on Windows, slightly speeding up require, and concealing your source code from cursory inspection. When the value @@ -107,18 +107,18 @@

  • asar.unpackDir = path.join('**', '{sub_dir1/sub_sub_dir,sub_dir2}', '**', '*') will unpack the directories /<dir>/sub_dir1/sub_sub_dir and /<dir>/sub_dir2 and their subdirectories.
  • Note: asar will have no effect if the prebuiltAsar option is set.

    -
    beforeAsar?: HookFunction[]

    Functions to be called before your app directory is packaged into an .asar file.

    +
    beforeAsar?: HookFunction[]

    Functions to be called before your app directory is packaged into an .asar file.

    Note: beforeAsar will only be called if the asar option is set.

    -
    beforeCopy?: HookFunction[]

    Functions to be called before your app directory is copied to a temporary directory.

    +
    beforeCopy?: HookFunction[]

    Functions to be called before your app directory is copied to a temporary directory.

    Note: beforeCopy will not be called if the prebuiltAsar option is set.

    -
    beforeCopyExtraResources?: HookFunction[]

    Functions to be called before the files specified in the extraResource option are copied.

    -
    buildVersion?: string

    The build version of the application. Defaults to the value of the appVersion option. +

    beforeCopyExtraResources?: HookFunction[]

    Functions to be called before the files specified in the extraResource option are copied.

    +
    buildVersion?: string

    The build version of the application. Defaults to the value of the appVersion option. Maps to the FileVersion metadata property on Windows, and CFBundleVersion on macOS.

    -
    derefSymlinks?: boolean

    Whether symlinks should be dereferenced during the copying of the application source. +

    derefSymlinks?: boolean

    Whether symlinks should be dereferenced during the copying of the application source. Defaults to true.

    Note: derefSymlinks will have no effect if the prebuiltAsar option is set.

    -
    dir: string

    The source directory.

    -
    download?: ElectronDownloadRequestOptions

    If present, passes custom options to @electron/get. See +

    dir: string

    The source directory.

    +
    download?: ElectronDownloadRequestOptions

    If present, passes custom options to @electron/get. See the module for option descriptions, proxy support, and defaults. Supported parameters include, but are not limited to:

      @@ -126,26 +126,26 @@
    • mirrorOptions (Object): Options to override the default Electron download location.

    Note: download sub-options will have no effect if the electronZipDir option is set.

    -
    electronVersion?: string

    The Electron version with which the app is built (without the leading 'v') - for example, +

    electronVersion?: string

    The Electron version with which the app is built (without the leading 'v') - for example, 1.4.13. See Electron releases for valid versions. If omitted, it

    • will use the version of the nearest local installation of electron or electron-nightly
    • defined in package.json in either devDependencies or dependencies.
    -
    electronZipDir?: string

    The local path to a directory containing Electron ZIP files for Electron Packager to unzip, instead +

    electronZipDir?: string

    The local path to a directory containing Electron ZIP files for Electron Packager to unzip, instead of downloading them. The ZIP filenames should be in the same format as the ones downloaded from the Electron releases site.

    Note: Setting this option prevents the download sub-options from being used, as the functionality gets skipped over.

    -
    executableName?: string

    The name of the executable file, sans file extension. Defaults to the value for the name +

    executableName?: string

    The name of the executable file, sans file extension. Defaults to the value for the name option. For darwin or mas target platforms, this does not affect the name of the .app folder - this will use the name option instead.

    -
    extraResource?: string | string[]

    One or more files to be copied directly into the app's Contents/Resources directory for +

    extraResource?: string | string[]

    One or more files to be copied directly into the app's Contents/Resources directory for macOS target platforms, and the resources directory for other target platforms. The resources directory can be referenced in the packaged app via the process.resourcesPath value.

    -
    icon?: string

    The local path to the icon file, if the target platform supports setting embedding an icon.

    +
    icon?: string

    The local path to the icon file, if the target platform supports setting embedding an icon.

    Currently you must look for conversion tools in order to supply an icon in the format required by the platform:

    • macOS: .icns
    • @@ -157,7 +157,7 @@

    If the file extension is omitted, it is auto-completed to the correct extension based on the platform, including when [[platform|platform: 'all']] is in effect.

    -
    ignore?: RegExp | (string | RegExp)[] | IgnoreFunction

    One or more additional regular expression +

    ignore?: RegExp | (string | RegExp)[] | IgnoreFunction

    One or more additional regular expression patterns which specify which files to ignore when copying files to create the app bundle(s). The regular expressions are matched against the absolute path of a given file/directory to be copied.

    Please note that glob patterns will not work.

    @@ -179,21 +179,21 @@

    Note: Node modules specified in devDependencies are ignored by default, via the prune option.

    Note: ignore will have no effect if the prebuiltAsar option is set.

    -
    junk?: boolean

    Ignores system junk files when copying the Electron app, +

    junk?: boolean

    Ignores system junk files when copying the Electron app, regardless of the ignore option.

    Note: junk will have no effect if the prebuiltAsar option is set.

    -
    name?: string

    The application name. If omitted, it will use the productName or name value from the +

    name?: string

    The application name. If omitted, it will use the productName or name value from the nearest package.json.

    Regardless of source, characters in the Electron app name which are not allowed in all target platforms' filenames (e.g., /), will be replaced by hyphens (-).

    -
    osxUniversal?: OsxUniversalOptions

    Used to provide custom options to the internal call to @electron/universal when building a macOS +

    osxUniversal?: OsxUniversalOptions

    Used to provide custom options to the internal call to @electron/universal when building a macOS app with the target architecture of "universal". Unused otherwise, providing a value does not imply a universal app is built.

    -
    out?: string

    The base directory where the finished package(s) are created.

    +
    out?: string

    The base directory where the finished package(s) are created.

    Defaults to the current working directory.

    -
    overwrite?: boolean

    Whether to replace an already existing output directory for a given platform (true) or +

    overwrite?: boolean

    Whether to replace an already existing output directory for a given platform (true) or skip recreating it (false). Defaults to false.

    -
    platform?: string | string[]

    The target platform(s) to build for.

    +
    platform?: string | string[]

    The target platform(s) to build for.

    Not required if the all option is set. If platform is set to all, all officially supported target platforms for the target architectures specified by the arch option will be built. Arbitrary combinations of individual platforms are also supported via a @@ -209,7 +209,7 @@

  • mas (macOS, specifically for submitting to the Mac App Store)
  • win32
  • -
    prebuiltAsar?: string

    The path to a prebuilt ASAR file.

    +
    prebuiltAsar?: string

    The path to a prebuilt ASAR file.

    Note: Setting this option prevents the following options from being used, as the functionality gets skipped over:

    -
    prune?: boolean

    Walks the node_modules dependency tree to remove all of the packages specified in the +

    prune?: boolean

    Walks the node_modules dependency tree to remove all of the packages specified in the devDependencies section of package.json from the outputted Electron app.

    Defaults to true.

    Note: prune will have no effect if the prebuiltAsar option is set.

    -
    quiet?: boolean

    If true, disables printing informational and warning messages to the console when +

    quiet?: boolean

    If true, disables printing informational and warning messages to the console when packaging the application. This does not disable errors.

    Defaults to false.

    -
    tmpdir?: string | false

    The base directory to use as a temporary directory. Set to false to disable use of a +

    tmpdir?: string | false

    The base directory to use as a temporary directory. Set to false to disable use of a temporary directory. Defaults to the system's temporary directory.

    -

    Windows

    win32metadata?: Win32MetadataOptions

    Application metadata to embed into the Windows executable.

    -
    windowsSign?: true | WindowsSignOptions

    If present, signs Windows binary files. +

    Windows

    win32metadata?: Win32MetadataOptions

    Application metadata to embed into the Windows executable.

    +
    windowsSign?: true | WindowsSignOptions

    If present, signs Windows binary files. When the value is true, pass default configuration to the signing module. See @electron/windows-sign for sub-option descriptions and their defaults.

    -

    macOS

    appCategoryType?: string

    The application category type, as shown in the Finder via View → Arrange by Application +

    macOS

    appCategoryType?: string

    The application category type, as shown in the Finder via View → Arrange by Application Category when viewing the Applications directory.

    For example, app-category-type=public.app-category.developer-tools will set the application category to Developer Tools.

    Valid values are listed in Apple's documentation.

    -
    darwinDarkModeSupport?: boolean

    Forces support for Mojave (macOS 10.14) dark mode in your packaged app. This sets the +

    darwinDarkModeSupport?: boolean

    Forces support for Mojave (macOS 10.14) dark mode in your packaged app. This sets the NSRequiresAquaSystemAppearance key to false in your app's Info.plist. For more information, see the Electron documentation and the Apple developer documentation.

    -
    extendHelperInfo?: string | {
        [property: string]: any;
    }

    When the value is a string, specifies the filename of a plist file. Its contents are merged +

    extendHelperInfo?: string | {
        [property: string]: any;
    }

    When the value is a string, specifies the filename of a plist file. Its contents are merged into all the Helper apps' Info.plist files. When the value is an Object, it specifies an already-parsed plist data structure that is merged into all the Helper apps' Info.plist files.

    @@ -253,7 +253,7 @@
  • electron or electron-nightly, but are overridden by other options such as appVersion or appBundleId.
  • -

    Type declaration

    • [property: string]: any
    extendInfo?: string | {
        [property: string]: any;
    }

    When the value is a string, specifies the filename of a plist file. Its contents are merged +

    Type declaration

    • [property: string]: any
    extendInfo?: string | {
        [property: string]: any;
    }

    When the value is a string, specifies the filename of a plist file. Its contents are merged into the app's Info.plist. When the value is an Object, it specifies an already-parsed plist data structure that is merged into the app's Info.plist.

    @@ -262,12 +262,12 @@
  • electron or electron-nightly, but are overridden by other options such as appVersion or appBundleId.
  • -

    Type declaration

    • [property: string]: any
    helperBundleId?: string

    The bundle identifier to use in the application helper's Info.plist.

    -
    osxNotarize?: NotaryToolCredentials

    If present, notarizes macOS target apps when the host platform is macOS and Xcode is installed. +

    Type declaration

    • [property: string]: any
    helperBundleId?: string

    The bundle identifier to use in the application helper's Info.plist.

    +
    osxNotarize?: NotaryToolCredentials

    If present, notarizes macOS target apps when the host platform is macOS and Xcode is installed. See @electron/notarize for option descriptions, such as how to use appleIdPassword safely or obtain an API key.

    Requires the osxSign option to be set.

    -
    osxSign?: true | OsxSignOptions

    If present, signs macOS target apps when the host platform is macOS and Xcode is installed. +

    osxSign?: true | OsxSignOptions

    If present, signs macOS target apps when the host platform is macOS and Xcode is installed. When the value is true, pass default configuration to the signing module. See @electron/osx-sign for sub-option descriptions and their defaults. Options include, but are not limited to:

    @@ -275,8 +275,8 @@
  • identity (string): The identity used when signing the package via codesign.
  • binaries (array): Path to additional binaries that will be signed along with built-ins of Electron/
  • -
    protocols?: MacOSProtocol[]

    The URL protocol schemes associated with the Electron app.

    -
    usageDescription?: {
        [property: string]: string;
    }

    Human-readable descriptions of how the Electron app uses certain macOS features. These are displayed +

    protocols?: MacOSProtocol[]

    The URL protocol schemes associated with the Electron app.

    +
    usageDescription?: {
        [property: string]: string;
    }

    Human-readable descriptions of how the Electron app uses certain macOS features. These are displayed in the App Store. A non-exhaustive list of available properties:

    • Camera - required for media access API usage in macOS Catalina
    • @@ -287,4 +287,4 @@

      Example:

      {
      usageDescription: {
      Camera: 'Needed for video calls',
      Microphone: 'Needed for voice calls'
      }
      }
      -

    Type declaration

    • [property: string]: string
    \ No newline at end of file +

    Type declaration

    • [property: string]: string
    \ No newline at end of file diff --git a/main/interfaces/Win32MetadataOptions.html b/main/interfaces/Win32MetadataOptions.html index 4fd5714b..be0fa66a 100644 --- a/main/interfaces/Win32MetadataOptions.html +++ b/main/interfaces/Win32MetadataOptions.html @@ -1,5 +1,5 @@ Win32MetadataOptions | @electron/packager

    Interface Win32MetadataOptions

    A collection of application metadata to embed into the Windows executable.

    -
    interface Win32MetadataOptions {
        CompanyName?: string;
        FileDescription?: string;
        InternalName?: string;
        OriginalFilename?: string;
        ProductName?: string;
        application-manifest?: string;
        requested-execution-level?: "asInvoker" | "highestAvailable" | "requireAdministrator";
    }

    Properties

    interface Win32MetadataOptions {
        CompanyName?: string;
        FileDescription?: string;
        InternalName?: string;
        OriginalFilename?: string;
        ProductName?: string;
        application-manifest?: string;
        requested-execution-level?: "asInvoker" | "highestAvailable" | "requireAdministrator";
    }

    Properties

    CompanyName?: string

    Defaults to the author name from the nearest package.json.

    -
    FileDescription?: string

    Defaults to either productName or name from the nearest package.json.

    -
    InternalName?: string

    Defaults to either productName or name from the nearest package.json.

    -
    OriginalFilename?: string

    Defaults to the renamed Electron .exe file.

    -
    ProductName?: string

    Defaults to either productName or name from the nearest package.json.

    -
    application-manifest?: string

    Path to a local manifest file.

    +
    FileDescription?: string

    Defaults to either productName or name from the nearest package.json.

    +
    InternalName?: string

    Defaults to either productName or name from the nearest package.json.

    +
    OriginalFilename?: string

    Defaults to the renamed Electron .exe file.

    +
    ProductName?: string

    Defaults to either productName or name from the nearest package.json.

    +
    application-manifest?: string

    Path to a local manifest file.

    See MSDN for more details.

    -
    requested-execution-level?: "asInvoker" | "highestAvailable" | "requireAdministrator"

    See MSDN for details.

    -
    \ No newline at end of file +
    requested-execution-level?: "asInvoker" | "highestAvailable" | "requireAdministrator"

    See MSDN for details.

    +
    \ No newline at end of file diff --git a/main/interfaces/WindowsSignOptions.html b/main/interfaces/WindowsSignOptions.html index f59a89ab..ef7988cd 100644 --- a/main/interfaces/WindowsSignOptions.html +++ b/main/interfaces/WindowsSignOptions.html @@ -1,4 +1,4 @@ WindowsSignOptions | @electron/packager

    Interface WindowsSignOptions

    See the documentation for @electron/windows-sign for details.

    -
    interface WindowsSignOptions {
        continueOnError?: boolean;
    }

    Hierarchy

    • Omit<WindowsInternalSignOptions, "appDirectory">
      • WindowsSignOptions

    Properties

    Properties

    continueOnError?: boolean
    \ No newline at end of file +
    interface WindowsSignOptions {
        continueOnError?: boolean;
    }

    Hierarchy

    • Omit<WindowsInternalSignOptions, "appDirectory">
      • WindowsSignOptions

    Properties

    Properties

    continueOnError?: boolean
    \ No newline at end of file diff --git a/main/types/ArchOption.html b/main/types/ArchOption.html index 4581f75b..6f30e7c6 100644 --- a/main/types/ArchOption.html +++ b/main/types/ArchOption.html @@ -1 +1 @@ -ArchOption | @electron/packager

    Type alias ArchOption

    ArchOption: TargetArch | "all"
    \ No newline at end of file +ArchOption | @electron/packager

    Type alias ArchOption

    ArchOption: TargetArch | "all"
    \ No newline at end of file diff --git a/main/types/FinalizePackageTargetsHookFunction.html b/main/types/FinalizePackageTargetsHookFunction.html index a756bfeb..9a45375a 100644 --- a/main/types/FinalizePackageTargetsHookFunction.html +++ b/main/types/FinalizePackageTargetsHookFunction.html @@ -1 +1 @@ -FinalizePackageTargetsHookFunction | @electron/packager

    Type alias FinalizePackageTargetsHookFunction

    FinalizePackageTargetsHookFunction: ((targets, callback) => void)

    Type declaration

    \ No newline at end of file +FinalizePackageTargetsHookFunction | @electron/packager

    Type alias FinalizePackageTargetsHookFunction

    FinalizePackageTargetsHookFunction: ((targets, callback) => void)

    Type declaration

    \ No newline at end of file diff --git a/main/types/HookFunction.html b/main/types/HookFunction.html index f6cf5492..b94ef6c9 100644 --- a/main/types/HookFunction.html +++ b/main/types/HookFunction.html @@ -7,4 +7,4 @@

    For real-world examples of HookFunctions, see the list of related plugins.

    -

    Type declaration

    \ No newline at end of file +

    Type declaration

    \ No newline at end of file diff --git a/main/types/HookFunctionErrorCallback.html b/main/types/HookFunctionErrorCallback.html index aa2ac1f2..640ca0aa 100644 --- a/main/types/HookFunctionErrorCallback.html +++ b/main/types/HookFunctionErrorCallback.html @@ -1 +1 @@ -HookFunctionErrorCallback | @electron/packager

    Type alias HookFunctionErrorCallback

    HookFunctionErrorCallback: ((err?) => void)

    Type declaration

      • (err?): void
      • Parameters

        • Optional err: Error | null

        Returns void

    \ No newline at end of file +HookFunctionErrorCallback | @electron/packager

    Type alias HookFunctionErrorCallback

    HookFunctionErrorCallback: ((err?) => void)

    Type declaration

      • (err?): void
      • Parameters

        • Optional err: Error | null

        Returns void

    \ No newline at end of file diff --git a/main/types/IgnoreFunc.html b/main/types/IgnoreFunc.html index c19697e1..2d14dc44 100644 --- a/main/types/IgnoreFunc.html +++ b/main/types/IgnoreFunc.html @@ -1 +1 @@ -IgnoreFunc | @electron/packager

    Type alias IgnoreFunc

    IgnoreFunc: ((platform, arch) => boolean)

    Type declaration

      • (platform, arch): boolean
      • Parameters

        • platform: string
        • arch: string

        Returns boolean

    \ No newline at end of file +IgnoreFunc | @electron/packager

    Type alias IgnoreFunc

    IgnoreFunc: ((platform, arch) => boolean)

    Type declaration

      • (platform, arch): boolean
      • Parameters

        • platform: string
        • arch: string

        Returns boolean

    \ No newline at end of file diff --git a/main/types/IgnoreFunction.html b/main/types/IgnoreFunction.html index c553e40e..5be6ef1a 100644 --- a/main/types/IgnoreFunction.html +++ b/main/types/IgnoreFunction.html @@ -1,4 +1,4 @@ IgnoreFunction | @electron/packager

    Type alias IgnoreFunction

    IgnoreFunction: ((path) => boolean)

    A predicate function that, given an absolute file path, returns true if the file should be ignored, or false if the file should be kept. This does not use any of the default ignored files/directories listed for the ignore option.

    -

    Type declaration

      • (path): boolean
      • Parameters

        • path: string

        Returns boolean

    \ No newline at end of file +

    Type declaration

      • (path): boolean
      • Parameters

        • path: string

        Returns boolean

    \ No newline at end of file diff --git a/main/types/MakeUniversalOpts.html b/main/types/MakeUniversalOpts.html index 718583da..3aaed703 100644 --- a/main/types/MakeUniversalOpts.html +++ b/main/types/MakeUniversalOpts.html @@ -1 +1 @@ -MakeUniversalOpts | @electron/packager

    Type alias MakeUniversalOpts

    MakeUniversalOpts: Parameters<typeof makeUniversalApp>[0]
    \ No newline at end of file +MakeUniversalOpts | @electron/packager

    Type alias MakeUniversalOpts

    MakeUniversalOpts: Parameters<typeof makeUniversalApp>[0]
    \ No newline at end of file diff --git a/main/types/OfficialArch.html b/main/types/OfficialArch.html index da4fc9b5..cf415f46 100644 --- a/main/types/OfficialArch.html +++ b/main/types/OfficialArch.html @@ -1,3 +1,3 @@ OfficialArch | @electron/packager

    Type alias OfficialArch

    OfficialArch: "ia32" | "x64" | "armv7l" | "arm64" | "mips64el" | "universal"

    Architectures that have been supported by the official Electron prebuilt binaries, past and present.

    -
    \ No newline at end of file +
    \ No newline at end of file diff --git a/main/types/OfficialPlatform.html b/main/types/OfficialPlatform.html index 9f64c4ba..cf797971 100644 --- a/main/types/OfficialPlatform.html +++ b/main/types/OfficialPlatform.html @@ -1,2 +1,2 @@ OfficialPlatform | @electron/packager

    Type alias OfficialPlatform

    OfficialPlatform: "linux" | "win32" | "darwin" | "mas"

    Platforms that have been supported by the official Electron prebuilt binaries, past and present.

    -
    \ No newline at end of file +
    \ No newline at end of file diff --git a/main/types/OsxSignOptions.html b/main/types/OsxSignOptions.html index 5dbe94b5..3cbce7d7 100644 --- a/main/types/OsxSignOptions.html +++ b/main/types/OsxSignOptions.html @@ -1,2 +1,2 @@ OsxSignOptions | @electron/packager

    Type alias OsxSignOptions

    OsxSignOptions: Omit<OSXInternalSignOptions, "app" | "binaries" | "platform" | "version">

    See the documentation for @electron/osx-sign for details.

    -
    \ No newline at end of file +
    \ No newline at end of file diff --git a/main/types/OsxUniversalOptions.html b/main/types/OsxUniversalOptions.html index fe3303c2..de115e5d 100644 --- a/main/types/OsxUniversalOptions.html +++ b/main/types/OsxUniversalOptions.html @@ -1,3 +1,3 @@ OsxUniversalOptions | @electron/packager

    Type alias OsxUniversalOptions

    OsxUniversalOptions: Omit<MakeUniversalOpts, "x64AppPath" | "arm64AppPath" | "outAppPath" | "force">

    See the documentation for @electron/universal for details.

    -
    \ No newline at end of file +
    \ No newline at end of file diff --git a/main/types/PlatformOption.html b/main/types/PlatformOption.html index 1640a96f..26f30abb 100644 --- a/main/types/PlatformOption.html +++ b/main/types/PlatformOption.html @@ -1 +1 @@ -PlatformOption | @electron/packager

    Type alias PlatformOption

    PlatformOption: TargetPlatform | "all"
    \ No newline at end of file +PlatformOption | @electron/packager

    Type alias PlatformOption

    PlatformOption: TargetPlatform | "all"
    \ No newline at end of file diff --git a/main/types/SupportedArch.html b/main/types/SupportedArch.html index f0efaebe..0eca6fc9 100644 --- a/main/types/SupportedArch.html +++ b/main/types/SupportedArch.html @@ -1,3 +1,3 @@ SupportedArch | @electron/packager

    Type alias SupportedArch

    SupportedArch: OfficialArch | "all"

    Architecture values that we actually support out of the box (not considering unofficial values provided in download.mirrorOptions).

    -
    \ No newline at end of file +
    \ No newline at end of file diff --git a/main/types/SupportedPlatform.html b/main/types/SupportedPlatform.html index 8c78958f..607e91ec 100644 --- a/main/types/SupportedPlatform.html +++ b/main/types/SupportedPlatform.html @@ -1,3 +1,3 @@ SupportedPlatform | @electron/packager

    Type alias SupportedPlatform

    SupportedPlatform: OfficialPlatform | "all"

    Platform values that we actually support out of the box (not considering unofficial values provided in download.mirrorOptions).

    -
    \ No newline at end of file +
    \ No newline at end of file diff --git a/main/types/TargetArch.html b/main/types/TargetArch.html index f6d6a330..308b5db3 100644 --- a/main/types/TargetArch.html +++ b/main/types/TargetArch.html @@ -1 +1 @@ -TargetArch | @electron/packager

    Type alias TargetArch

    TargetArch: OfficialArch | string
    \ No newline at end of file +TargetArch | @electron/packager

    Type alias TargetArch

    TargetArch: OfficialArch | string
    \ No newline at end of file diff --git a/main/types/TargetDefinition.html b/main/types/TargetDefinition.html index d0644723..c92302c4 100644 --- a/main/types/TargetDefinition.html +++ b/main/types/TargetDefinition.html @@ -1 +1 @@ -TargetDefinition | @electron/packager

    Type alias TargetDefinition

    TargetDefinition: {
        arch: TargetArch;
        platform: TargetPlatform;
    }

    Type declaration

    \ No newline at end of file +TargetDefinition | @electron/packager

    Type alias TargetDefinition

    TargetDefinition: {
        arch: TargetArch;
        platform: TargetPlatform;
    }

    Type declaration

    \ No newline at end of file diff --git a/main/types/TargetPlatform.html b/main/types/TargetPlatform.html index 337c1e57..a96dec68 100644 --- a/main/types/TargetPlatform.html +++ b/main/types/TargetPlatform.html @@ -1 +1 @@ -TargetPlatform | @electron/packager

    Type alias TargetPlatform

    TargetPlatform: OfficialPlatform | string
    \ No newline at end of file +TargetPlatform | @electron/packager

    Type alias TargetPlatform

    TargetPlatform: OfficialPlatform | string
    \ No newline at end of file