electron builder.Interface.MacConfiguration

用于签署应用程序的授权文件的路径。如果存在，将使用 build/entitlements.mac.plist（这是推荐的设置方式）。MAS 授权在 mas 中指定。有关示例，请参阅 osx-sign 仓库中的此文件夹。请注意，如果未设置正确的授权，您的应用程序可能会崩溃，例如在带有 Electron 20+ 的 arm64 构建上，com.apple.security.cs.allow-jit。有关更多信息，请参阅 Electron 文档中的签署和公证 macOS 构建。

entitlementsInherit?¶

readonly optional entitlementsInherit: null | string

子授权的路径，这些授权继承用于签署发行版的框架和捆绑包的安全设置。如果存在，将使用 build/entitlements.mac.inherit.plist（这是推荐的设置方式）。有关示例，请参阅 osx-sign 仓库中的此文件夹。

此选项仅在提供 entitlements 进行签名时适用。

entitlementsLoginHelper?¶

readonly optional entitlementsLoginHelper: null | string

登录助手授权文件的路径。当使用 App Sandbox 时，通常位于继承的授权中的 com.apple.security.inherit 密钥无法继承，因为登录助手是独立的exe文件。默认为为 entitlements 提供的值。此选项仅在提供 entitlements 进行签名时适用。

executableName?¶

readonly optional executableName: null | string

可执行文件名。默认为 productName。

继承自¶

PlatformSpecificBuildOptions.executableName

extendInfo?¶

readonly optional extendInfo: any

Info.plist 的额外条目。

extraDistFiles?¶

readonly optional extraDistFiles: null | string | string[]

要放入归档文件中的额外文件。不适用于 tar.*。

extraFiles?¶

optional extraFiles: null | string | FileSet | (string | FileSet)[]

与 extraResources 相同，但复制到应用程序的内容目录（macOS 为 Contents，Linux 和 Windows 为根目录）。

继承自¶

PlatformSpecificBuildOptions.extraFiles

extraResources?¶

optional extraResources: null | string | FileSet | (string | FileSet)[]

相对于项目目录的 glob 模式，指定后，将匹配的文件或目录直接复制到应用程序的 resources 目录中（macOS 为 Contents/Resources，Linux 和 Windows 为 resources）。

文件模式（以及对 from 和 to 字段的支持）与 files 相同。

继承自¶

PlatformSpecificBuildOptions.extraResources

fileAssociations?¶

readonly optional fileAssociations: FileAssociation | FileAssociation[]

文件关联。

继承自¶

PlatformSpecificBuildOptions.fileAssociations

files?¶

optional files: null | string | FileSet | (string | FileSet)[]

相对于应用程序目录的 glob 模式，指定在复制文件以创建包时要包含哪些文件。

默认为

[
"**/*",
"!**/node_modules/*/{CHANGELOG.md,README.md,README,readme.md,readme}",
"!**/node_modules/*/{test,__tests__,tests,powered-test,example,examples}",
"!**/node_modules/*.d.ts",
"!**/node_modules/.bin",
"!**/*.{iml,o,hprof,orig,pyc,pyo,rbc,swp,csproj,sln,xproj}",
"!.editorconfig",
"!**/._*",
"!**/{.DS_Store,.git,.hg,.svn,CVS,RCS,SCCS,.gitignore,.gitattributes}",
"!**/{__pycache__,thumbs.db,.flowconfig,.idea,.vs,.nyc_output}",
"!**/{appveyor.yml,.travis.yml,circle.yml}",
"!**/{npm-debug.log,yarn.lock,.yarn-integrity,.yarn-metadata.json}"
]

在任何情况下都不会复制开发依赖项。您无需显式忽略它。默认情况下不忽略隐藏文件，但默认情况下会忽略所有应忽略的文件。

如果您的某些模式不是忽略模式（即不是以 ! 开头），则默认模式 **/* 不会添加到您的自定义模式中。在任何情况下，package.json 和 **/node_modules/**/*（仅复制生产依赖项）都会添加到您的自定义模式中。所有默认忽略项都会在任何情况下添加 - 如果您配置自己的模式，则无需重复它。

可以在平台选项（例如 mac 中）中指定。

您还可以通过使用 FileSet 对象而不是简单的 glob 模式来指定自定义源目录和目标目录。

[
{
 "from": "path/to/source",
 "to": "path/to/destination",
 "filter": ["**/*", "!foo/*.js"]
}
]

您可以在 from 和 to 字段中使用文件宏。from 和 to 可以是文件，您可以使用它在打包时重命名文件。

继承自¶

PlatformSpecificBuildOptions.files

forceCodeSigning?¶

readonly optional forceCodeSigning: boolean

如果应用程序未进行代码签名，是否失败。

继承自¶

PlatformSpecificBuildOptions.forceCodeSigning

gatekeeperAssess?¶

readonly optional gatekeeperAssess: boolean

是否让 @electron/osx-sign 验证签名。

默认¶

false

generateUpdatesFilesForAllChannels?¶

readonly optional generateUpdatesFilesForAllChannels: boolean

请参阅使用频道构建和发布。

默认¶

false

继承自¶

PlatformSpecificBuildOptions.generateUpdatesFilesForAllChannels

hardenedRuntime?¶

readonly optional hardenedRuntime: boolean

您的应用程序是否必须使用硬化运行时签名。

默认¶

true

helperBundleId?¶

readonly optional helperBundleId: null | string

要在应用程序助手的 plist 中使用的捆绑包标识符。

默认¶

${appBundleIdentifier}.helper

helperEHBundleId?¶

readonly optional helperEHBundleId: null | string

要在 EH 助手的 plist 中使用的捆绑包标识符。

默认¶

${appBundleIdentifier}.helper.EH

helperGPUBundleId?¶

readonly optional helperGPUBundleId: null | string

要在 GPU 助手的 plist 中使用的捆绑包标识符。

默认¶

${appBundleIdentifier}.helper.GPU

helperNPBundleId?¶

readonly optional helperNPBundleId: null | string

要在 NP 助手的 plist 中使用的捆绑包标识符。

默认¶

${appBundleIdentifier}.helper.NP

helperPluginBundleId?¶

readonly optional helperPluginBundleId: null | string

要在 Plugin 助手的 plist 中使用的捆绑包标识符。

默认¶

${appBundleIdentifier}.helper.Plugin

helperRendererBundleId?¶

readonly optional helperRendererBundleId: null | string

要在 Renderer 助手的 plist 中使用的捆绑包标识符。

默认¶

${appBundleIdentifier}.helper.Renderer

icon?¶

readonly optional icon: null | string

应用程序图标的路径。

默认¶

build/icon.icns

覆盖¶

PlatformSpecificBuildOptions.icon

identity?¶

readonly optional identity: null | string

签名时要使用的证书名称。考虑使用环境变量 CSC_LINK 或 CSC_NAME 而不是指定此选项。MAS 安装程序标识在 mas 中指定。

mergeASARs?¶

readonly optional mergeASARs: boolean

是否合并不同架构的 ASAR 文件。

除非为“通用”架构构建，否则此选项无效。

默认¶

true

minimumSystemVersion?¶

readonly optional minimumSystemVersion: null | string

应用程序运行所需的最低 macOS 版本。对应于 LSMinimumSystemVersion。

notarize?¶

readonly optional notarize: boolean

是否禁用 electron-builder 的 @electron/notarize 集成。

注意：为了激活公证步骤，您必须通过环境变量指定以下选项之一

APPLE_API_KEY、APPLE_API_KEY_ID 和 APPLE_API_ISSUER。
APPLE_ID、APPLE_APP_SPECIFIC_PASSWORD 和 APPLE_TEAM_ID
APPLE_KEYCHAIN 和 APPLE_KEYCHAIN_PROFILE

出于安全原因，建议使用第一个选项（请参阅 https://github.com/electron-userland/electron-builder/issues/7859）

preAutoEntitlements?¶

readonly optional preAutoEntitlements: boolean

是否启用来自 @electron/osx-sign 的授权自动化。

默认¶

true

protocols?¶

readonly optional protocols: Protocol | Protocol[]

URL 协议方案。

继承自¶

PlatformSpecificBuildOptions.protocols

provisioningProfile?¶

readonly optional provisioningProfile: null | string

用于签名时使用的配置文件路径，绝对路径或相对于应用程序根目录的路径。

publish?¶

optional publish: Publish

发布者配置。有关更多信息，请参阅自动更新。

继承自¶

PlatformSpecificBuildOptions.publish

releaseInfo?¶

readonly optional releaseInfo: ReleaseInfo

发布信息。适用于命令行用法

-c.releaseInfo.releaseNotes="new features"

继承自¶

PlatformSpecificBuildOptions.releaseInfo

requirements?¶

readonly optional requirements: null | string

需求文件的路径，用于签名。不适用于 MAS。

sign?¶

readonly optional sign: null | string | CustomMacSign

用于签署应用程序包的自定义函数（或文件路径或模块 ID）。

signIgnore?¶

readonly optional signIgnore: null | string | string[]

用于指示跳过签名文件的正则表达式或正则表达式数组。

singleArchFiles?¶

readonly optional singleArchFiles: null | string

允许存在于其中一个 ASAR 文件中，但不能存在于另一个 ASAR 文件中的路径的 Minimatch 模式。

除非为“通用”架构构建，否则此选项无效，并且仅当 mergeASARs 为 true 时适用。

strictVerify?¶

readonly optional strictVerify: boolean

是否让 @electron/osx-sign 验证内容。

默认¶

true

target?¶

readonly optional target: null | TargetConfiguration | MacOsTargetName | TargetConfiguration | MacOsTargetName[]

目标包类型：default、dmg、mas、mas-dev、pkg、7z、zip、tar.xz、tar.lz、tar.gz、tar.bz2、dir 列表。默认为 default（Squirrel.Mac 为 dmg 和 zip）。注意：Squirrel.Mac 自动更新机制需要同时启用 dmg 和 zip，即使仅使用 dmg 也是如此。禁用 zip 将破坏 dmg 包中的自动更新。

覆盖¶

PlatformSpecificBuildOptions.target

timestamp?¶

readonly optional timestamp: null | string

指定时间戳授权服务器的 URL

type?¶

readonly optional type: null | "distribution" | "development"

是否为开发或发行版签署应用程序。

默认¶

distribution

x64ArchFiles?¶

readonly optional x64ArchFiles: null | string

允许在两个 ASAR 文件中都作为 x64 二进制文件的路径的 Minimatch 模式

除非为“通用”架构构建，否则此选项无效，并且仅当 mergeASARs 为 true 时适用。