app builder lib.Interface.MasConfiguration

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

登录助手权限文件的路径。当使用 App Sandbox 时，通常在继承的权限中的 com.apple.security.inherit 密钥无法被继承，因为登录助手是一个独立的执行文件。默认为为 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)[]

相对于应用目录的 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 文件。

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

默认值¶

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

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

继承自¶

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

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

继承自¶

MacConfiguration.requirements

sign?¶

readonly optional sign: null | string | CustomMacSign

用于签名应用 bundle 的自定义函数（或文件路径或模块 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 包中的自动更新。