Electron-Vite-Vue项目苹果应用商店上架配置指南

前言

在Electron-Vite-Vue项目中，将应用打包并上架到苹果应用商店(Mac App Store)是一个需要特别注意配置的过程。本文将详细介绍如何正确配置相关文件，解决常见问题，并分享一些实用技巧。

关键配置文件解析

1. 签名与授权文件

在项目根目录的build文件夹下，需要创建以下四个关键文件：

1. notarize.js - 用于应用公证的脚本文件
2. entitlements.mas.plist - MAS(Mac App Store)专用的授权文件
3. entitlements.mas.inherit.plist - 继承的授权配置文件
4. MyApp.provisionprofile - 应用的分发配置文件

2. electron-builder配置

在electron-builder.json5中，需要针对mac和mas平台分别进行配置：

{
  "mac": {
    "entitlements": "build/entitlements.mac.plist",
    "target": ["dmg", "mas", "pkg"],
    "artifactName": "${productName}-Mac-${version}-Installer.${ext}",
    "entitlementsInherit": "build/entitlements.mas.inherit.plist",
    "extendInfo": {
      "NSCameraUsageDescription": "应用请求访问设备摄像头",
      "NSMicrophoneUsageDescription": "应用请求访问设备麦克风",
      "NSDocumentsFolderUsageDescription": "应用请求访问用户的文档文件夹",
      "NSDownloadsFolderUsageDescription": "应用请求访问用户的下载文件夹"
    }
  },
  "afterSign": "build/notarize.js",
  "mas": {
    "hardenedRuntime": false,
    "type": "distribution",
    "category": "public.app-category.utilities",
    "entitlements": "build/entitlements.mas.plist",
    "entitlementsInherit": "build/entitlements.mas.inherit.plist",
    "provisioningProfile": "build/MyApp.provisionprofile"
  }
}

常见问题解决方案

1. ES模块加载错误

当运行构建命令时，可能会遇到以下错误：

require() of ES Module not supported

这是因为项目配置了"type": "module"，而notarize.js被当作ES模块处理。解决方案有：

1. 将notarize.js重命名为notarize.cjs
2. 修改项目package.json中的"type": "module"为"type": "commonjs"
3. 使用动态导入import()替代require()

2. 代码签名问题

构建过程中可能出现签名警告：

skipped macOS application code signing

这表明系统找不到有效的"Developer ID Application"身份或自定义的非Apple代码签名证书。解决方案：

1. 确保已安装有效的开发者证书
2. 检查钥匙串访问中的证书是否有效
3. 确认Xcode中已正确配置开发者账号

最佳实践建议

1. 文件命名规范：保持配置文件的命名一致性，便于维护
2. 授权描述：所有权限请求都必须包含清晰的使用说明
3. 构建环境：确保本地开发环境与CI环境使用相同的证书配置
4. 测试验证：在提交到App Store前，使用TestFlight进行充分测试

总结

Electron-Vite-Vue项目上架苹果应用商店需要特别注意配置文件的完整性和正确性。通过合理配置签名、授权和构建选项，可以避免大多数上架过程中的问题。遇到问题时，应仔细阅读错误信息，并按照苹果开发者文档的要求进行调整。