create-dmg 项目常见问题解决方案

create-dmg 项目常见问题解决方案

create-dmg Create a good-looking DMG for your macOS app in seconds 项目地址: https://gitcode.com/gh_mirrors/cr/create-dmg

项目基础介绍

create-dmg 是一个用于快速创建美观的 macOS DMG 文件的工具。它旨在简化 macOS 应用程序的发布流程，用户只需提供应用程序的路径，create-dmg 就会自动生成一个带有自定义图标和布局的 DMG 文件。该项目主要使用 JavaScript 编写，依赖于 Node.js 环境运行。

新手使用注意事项及解决方案

1. Node.js 版本问题

问题描述：create-dmg 要求 Node.js 版本至少为 18 或更高。如果用户系统中安装的 Node.js 版本过低，可能会导致安装或运行失败。

解决步骤：

1. 检查 Node.js 版本：

   node -v
   

   如果版本低于 18，需要升级 Node.js。

2. 升级 Node.js：

   • 使用 Node.js 版本管理工具（如 nvm）升级：

     nvm install 18
     nvm use 18
     

   • 或者从 Node.js 官方网站下载并安装最新版本。

2. DMG 文件名冲突

问题描述：如果生成的 DMG 文件名与已存在的文件名冲突，create-dmg 默认不会覆盖现有文件，可能会导致生成失败。

解决步骤：

1. 检查目标目录： 在运行 create-dmg 命令前，检查目标目录是否已存在同名 DMG 文件。

2. 使用 --overwrite 选项： 在命令中添加 --overwrite 选项以覆盖现有文件：

   create-dmg --overwrite 'Lungo.app'
   

3. 代码签名问题

问题描述：create-dmg 会尝试自动对生成的 DMG 文件进行代码签名，但如果用户没有开发者证书，代码签名可能会失败。

解决步骤：

1. 检查代码签名状态： 运行 create-dmg 命令后，查看输出信息，确认代码签名是否成功。

2. 手动设置代码签名身份： 如果自动签名失败，可以使用 --identity 选项手动设置代码签名身份：

   create-dmg --identity="Developer ID Application: Your Name (Team ID)" 'Lungo.app'
   

3. 忽略代码签名： 如果不需要代码签名，可以忽略此步骤，生成的 DMG 文件仍然可以使用，但建议在发布前进行代码签名。

通过以上步骤，新手用户可以更好地理解和使用 create-dmg 项目，避免常见问题。

create-dmg Create a good-looking DMG for your macOS app in seconds 项目地址: https://gitcode.com/gh_mirrors/cr/create-dmg