Flutter 2.x 含连字符项目名如何正确启用macOS桌面端支持

• 运行环境：Flutter 2.x，项目根路径为~/source/cruise-open，当前Shell处于base虚拟环境，关联ruby-2.7.2版本，项目对外正式固定名称为cruise-open
• 已尝试的接入操作：
  • 执行macOS桌面端开发开关命令：~/apps/flutter/bin/flutter config --enable-macos-desktop
  • 在项目根目录执行平台目录生成命令：~/apps/flutter/bin/flutter create .
  • 尝试带项目名参数执行生成命令：~/apps/flutter/bin/flutter create --project-name cruise-open .
• 报错信息：所有生成命令执行后均抛出"cruise-open" is not a valid Dart package name，提示需符合Dart包名命名规范（仅支持小写字母、数字、下划线开头，不允许包含连字符）
• 核心诉求：不改动项目对外固定的正式名称，确认能否不强制重命名项目完成macOS桌面端支持接入

完全不需要修改项目对外公开的正式名称、也不需要重命名项目根文件夹，仅需绕开flutter create命令的硬校验逻辑，即可完成macOS桌面端接入，不存在必须强制重命名项目的要求。

• 生成符合命名规范的临时工程：在项目目录外的临时路径执行flutter create命令，生成一个包名合规的临时项目，比如执行flutter create temp_macos_source，指定项目名为cruise_open（以下划线替换原名称中的连字符，通过命名校验）
• 拷贝macOS平台目录：将临时项目根目录下生成的整个macos文件夹，直接复制到现有cruise-open项目的根目录下
• 手动修正配置项匹配当前项目：
  • 打开拷贝目录下的macos/Runner/Info.plist，将CFBundleName、CFBundleDisplayName字段修改为对外正式名称cruise-open，保证应用安装后显示的名称和预期一致
  • 打开macos/Runner.xcodeproj/project.pbxproj，将文件内硬编码的临时包名、默认Bundle ID修改为项目本身安卓、iOS端已在使用的统一Bundle Identifier，保证全平台应用标识一致
  • 打开macos/Flutter/Generated.xcconfig，将文件内硬编码的临时工程路径手动修正为当前cruise-open项目的实际根目录路径
• 适配pubspec内部包名规则：打开项目根目录pubspec.yaml，将name字段从原来的cruise-open调整为符合Dart规范的cruise_open。该字段仅作为Dart代码内部的包引用标识，不会影响项目对外的文件夹名称、应用显示名称、公开仓库名称
• 验证运行：项目根目录执行flutter pub get完成依赖同步后，执行flutter run -d macos确认macOS端可以正常启动运行

• 之前执行flutter create --project-name cruise-open触发报错的原因是，该参数会强制校验Dart包名合法性，连字符属于硬校验拦截项，无论项目文件夹实际名称是什么，只要传入的项目名带连字符，就会直接终止命令执行，不会进入后续平台目录生成流程
• 手动拷贝macOS目录的操作，和通过flutter create直接生成的平台目录效果完全一致，不存在功能缺失或后续升级适配的问题
• 无需为了适配命令校验，将项目根文件夹重命名为带下划线的版本，项目对外的所有标识都可以保持原cruise-open不变

内容的提问来源于stack exchange，提问作者Dolphin