Compose Multiplatform 中 macOS 应用分发命名的灵活配置

在 Compose Multiplatform 开发中，当为 macOS 平台构建桌面应用时，开发者经常需要对最终生成的 DMG 安装包和应用名称进行定制化配置。当前版本中存在一个值得注意的命名约束问题，本文将深入分析这个问题并提供解决方案。

问题背景

Compose Multiplatform 的桌面应用构建系统默认使用 packageName 和 packageVersion 两个参数来生成最终的 DMG 文件名和应用名称。例如，当配置如下时：

compose.desktop {
    application {
        nativeDistributions {
            targetFormats(TargetFormat.Dmg)
            packageName = "Foo"
            packageVersion = "1.0"
        }
    }
}

系统会生成名为 Foo-1.0.dmg 的安装包文件，并且在安装后会得到一个名为 Foo-1.0.app 的应用。

核心问题

开发者可能希望 DMG 文件名和应用名称能够独立配置。例如：

• 希望 DMG 文件名为 foo-x64.dmg
• 但应用名称保持为 Foo.app

当前系统将这两个名称绑定在一起，导致如果修改 packageName 为 foo-x64 来实现 DMG 文件名的定制，那么应用名称也会变成 foo-x64-1.0.app，这通常不是开发者期望的结果。

技术实现分析

在底层实现上，Compose Multiplatform 使用 JPackage 工具来打包 macOS 应用。JPackage 本身支持更细粒度的名称配置，但 Compose 的 DSL 目前没有将这些选项完全暴露出来。

解决方案

临时解决方案

目前可以通过添加自定义 Gradle 任务来重命名生成的 DMG 文件：

val renameDmg by tasks.registering(Copy::class) {
    group = "distribution"
    description = "Rename the DMG file"

    val packageReleaseDmg = tasks.named<AbstractJPackageTask>("packageReleaseDmg")
    val fromFile = packageReleaseDmg.map { task ->
        task.destinationDir.asFile.get().toPath().listDirectoryEntries("Foo*.dmg").single()
    }

    from(fromFile)
    into(fromFile.map { it.parent })
    rename { "foo-bar.dmg" }
}

这个方案虽然可行，但属于后期处理，不是最优雅的解决方案。

未来改进方向

理想的解决方案是 Compose Multiplatform 能够提供独立的配置项，例如：

nativeDistributions {
    targetFormats(TargetFormat.Dmg)
    
    // 应用相关名称
    packageName = "Foo"
    packageVersion = "1.0"
    
    // 分发文件相关名称
    distributionName = "foo-x64"
}

这样就能实现分发文件名和应用名称的独立控制。

最佳实践建议

在当前版本下，建议开发者：

1. 优先保持 packageName 为应用的真实名称
2. 如果必须修改分发文件名，使用上述重命名方案
3. 考虑在 CI/CD 流程中添加重命名步骤
4. 关注 Compose Multiplatform 的更新，等待官方支持此功能

总结

Compose Multiplatform 的 macOS 分发命名配置目前存在一定的局限性，但通过合理的变通方案可以满足大多数开发需求。理解这个问题的本质有助于开发者更好地规划应用的分发策略，并为未来的功能更新做好准备。