electron builder.Interface.MasConfiguration

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

覆盖¶

MacConfiguration.entitlements

entitlementsInherit?¶

readonly optional entitlementsInherit: null | string

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

覆盖¶

MacConfiguration.entitlementsInherit

entitlementsLoginHelper?¶

readonly optional entitlementsLoginHelper: null | string

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

继承自¶

MacConfiguration.entitlementsLoginHelper

executableName?¶

readonly optional executableName: null | string

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

继承自¶

MacConfiguration.executableName

extendInfo?¶

readonly optional extendInfo: any

Info.plist 的额外条目。

继承自¶

MacConfiguration.extendInfo

extraDistFiles?¶

readonly optional extraDistFiles: null | string | string[]

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

继承自¶

MacConfiguration.extraDistFiles

extraFiles?¶

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

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

继承自¶

MacConfiguration.extraFiles

extraResources?¶

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

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

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

继承自¶

MacConfiguration.extraResources

fileAssociations?¶

readonly optional fileAssociations: FileAssociation | FileAssociation[]

文件关联。

继承自¶

MacConfiguration.fileAssociations

files?¶

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

相对于 app 目录的 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 可以是文件，您可以使用它在打包时重命名文件。

继承自¶

MacConfiguration.files

forceCodeSigning?¶

readonly optional forceCodeSigning: boolean

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

继承自¶

MacConfiguration.forceCodeSigning

gatekeeperAssess?¶

readonly optional gatekeeperAssess: boolean

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

默认值¶

false

继承自¶

MacConfiguration.gatekeeperAssess

generateUpdatesFilesForAllChannels?¶

readonly optional generateUpdatesFilesForAllChannels: boolean

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

默认值¶

false

继承自¶

MacConfiguration.generateUpdatesFilesForAllChannels

hardenedRuntime?¶

readonly optional hardenedRuntime: boolean

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

默认值¶

true

继承自¶

MacConfiguration.hardenedRuntime

helperBundleId?¶

readonly optional helperBundleId: null | string

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

默认值¶

${appBundleIdentifier}.helper

继承自¶

MacConfiguration.helperBundleId

helperEHBundleId?¶

readonly optional helperEHBundleId: null | string

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

默认值¶

${appBundleIdentifier}.helper.EH

继承自¶

MacConfiguration.helperEHBundleId

helperGPUBundleId?¶

readonly optional helperGPUBundleId: null | string

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

默认值¶

${appBundleIdentifier}.helper.GPU

继承自¶

MacConfiguration.helperGPUBundleId

helperNPBundleId?¶

readonly optional helperNPBundleId: null | string

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

默认值¶

${appBundleIdentifier}.helper.NP

继承自¶

MacConfiguration.helperNPBundleId

helperPluginBundleId?¶

readonly optional helperPluginBundleId: null | string

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

默认值¶

${appBundleIdentifier}.helper.Plugin

继承自¶

MacConfiguration.helperPluginBundleId

helperRendererBundleId?¶

readonly optional helperRendererBundleId: null | string

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

默认值¶

${appBundleIdentifier}.helper.Renderer

继承自¶

MacConfiguration.helperRendererBundleId

icon?¶

readonly optional icon: null | string

应用程序图标的路径。

默认值¶

build/icon.icns

继承自¶

MacConfiguration.icon

identity?¶

readonly optional identity: null | string

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

继承自¶

MacConfiguration.identity

mergeASARs?¶

readonly optional mergeASARs: boolean

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

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

默认值¶

true

继承自¶

MacConfiguration.mergeASARs

minimumSystemVersion?¶

readonly optional minimumSystemVersion: null | string

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

继承自¶

MacConfiguration.minimumSystemVersion

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）

继承自¶

MacConfiguration.notarize

preAutoEntitlements?¶

readonly optional preAutoEntitlements: boolean

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

默认值¶

true

继承自¶

MacConfiguration.preAutoEntitlements

protocols?¶

readonly optional protocols: Protocol | Protocol[]

URL 协议方案。

继承自¶

MacConfiguration.protocols

provisioningProfile?¶

readonly optional provisioningProfile: null | string

用于签名的 provisioning profile 路径，可以是绝对路径或相对于应用根目录的路径。

继承自¶

MacConfiguration.provisioningProfile

publish?¶

optional publish: Publish

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

继承自¶

MacConfiguration.publish

releaseInfo?¶

readonly optional releaseInfo: ReleaseInfo

发布信息。专为命令行使用而设计

-c.releaseInfo.releaseNotes="new features"

继承自¶

MacConfiguration.releaseInfo

requirements?¶

readonly optional requirements: null | string

签名中使用的 requirements 文件路径。不适用于 MAS。

继承自¶

MacConfiguration.requirements

sign?¶

readonly optional sign: null | string | CustomMacSign

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

继承自¶

MacConfiguration.sign

signIgnore?¶

readonly optional signIgnore: null | string | string[]

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

继承自¶

MacConfiguration.signIgnore

singleArchFiles?¶

readonly optional singleArchFiles: null | string

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

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

继承自¶

MacConfiguration.singleArchFiles

strictVerify?¶

readonly optional strictVerify: boolean

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

默认值¶

true

继承自¶

MacConfiguration.strictVerify

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 包中的自动更新。