原生分发

在这里，您将学习原生分发：如何为所有受支持的系统创建安装程序和软件包，以及如何使用与分发相同的设置在本地运行应用程序。

阅读以下内容以了解以下主题的详细信息：

什么是 Compose Multiplatform Gradle 插件？
基本任务详情（例如在本地运行应用程序）以及高级任务（如压缩和混淆）。
如何包含 JDK 模块并处理 ClassNotFoundException。
如何指定分发属性：软件包版本、JDK 版本、输出目录、启动器属性和元数据。
如何管理资源：使用资源库、JVM 资源加载或向打包后的应用程序添加文件。
如何自定义源集：使用 Gradle 源集、Kotlin JVM 目标或手动配置。
如何为每个操作系统指定应用程序图标。
特定于平台的选项，例如 Linux 上的软件包维护者电子邮件和 macOS 上 Apple App Store 的应用类别。
特定于 macOS 的配置：签名、公证和 Info.plist。

Gradle 插件

本指南主要侧重于使用 Compose Multiplatform Gradle 插件打包 Compose 应用程序。 org.jetbrains.compose 插件提供了用于基本打包、混淆和 macOS 代码签名的任务。

该插件简化了使用 jpackage 将应用程序打包成原生分发并在本地运行应用程序的过程。可分发的应用程序是自包含的、可安装的二进制文件，其中包含所有必要的 Java 运行时组件，无需在目标系统上安装 JDK。

为了减小软件包大小，Gradle 插件使用 jlink 工具，该工具可确保在可分发软件包中仅捆绑必要的 Java 模块。但是，您仍然必须配置 Gradle 插件以指定所需的模块。有关更多信息，请参阅包含 JDK 模块部分。

作为替代方案，您可以使用 Conveyor，这是一款非 JetBrains 开发的外部工具。 Conveyor 支持在线更新、跨平台构建和各种其他功能，但对于非开源项目需要许可证。有关更多信息，请参考 Conveyor 文档。

基本任务

Compose Multiplatform Gradle 插件中的基本可配置单元是 application（不要与已弃用的 Gradle application 插件混淆）。

application DSL 方法为一组最终二进制文件定义了共享配置，这意味着它允许您将一系列文件与 JDK 分发一起打包成各种格式的压缩二进制安装程序。

受支持的操作系统提供以下格式：

macOS：.dmg (TargetFormat.Dmg)、.pkg (TargetFormat.Pkg)
Windows：.exe (TargetFormat.Exe)、.msi (TargetFormat.Msi)
Linux：.deb (TargetFormat.Deb)、.rpm (TargetFormat.Rpm)

以下是具有基本桌面配置的 build.gradle.kts 文件示例：

kotlin

import org.jetbrains.compose.desktop.application.dsl.TargetFormat

plugins {
    kotlin("jvm")
    id("org.jetbrains.compose")
}

dependencies {
    implementation(compose.desktop.currentOs)
}

compose.desktop {
    application {
        mainClass = "example.MainKt"

        nativeDistributions {
            targetFormats(TargetFormat.Dmg, TargetFormat.Msi, TargetFormat.Exe)
        }
    }
}

构建项目时，插件会创建以下任务：

Gradle 任务	描述
`package<FormatName>`	将应用程序打包成相应的 `FormatName` 二进制文件。目前不支持跨平台编译 (Cross-compilation)，这意味着您只能使用相应的兼容操作系统来构建特定格式。例如，要构建 `.dmg` 二进制文件，必须在 macOS 上运行 `packageDmg` 任务。如果任何任务与当前操作系统不兼容，默认情况下会将其跳过。
`packageDistributionForCurrentOS`	聚合应用程序的所有打包任务。这是一个生命周期任务。
`packageUberJarForCurrentOS`	创建一个包含当前操作系统所有依赖项的单个 jar 文件。该任务要求将 `compose.desktop.currentOS` 用作 `compile`、`implementation` 或 `runtime` 依赖项。
`run`	从 `mainClass` 中指定的入口点在本地运行应用程序。`run` 任务启动具有完整运行时的非打包 JVM 应用程序。与创建具有精简运行时的紧凑二进制镜像相比，这种方法更快且更容易调试。要运行最终的二进制镜像，请改用 `runDistributable` 任务。
`createDistributable`	创建最终的应用程序镜像而不创建安装程序。
`runDistributable`	运行预打包的应用程序镜像。

所有可用任务都列在 Gradle 工具窗口中。执行任务后，Gradle 会在 ${project.buildDir}/compose/binaries 目录中生成输出二进制文件。

包含 JDK 模块

为了减小可分发文件的大小，Gradle 插件使用 jlink，它有助于仅捆绑必要的 JDK 模块。

目前，Gradle 插件不会自动确定必要的 JDK 模块。虽然这不会导致编译问题，但在运行时未能提供必要的模块可能会导致 ClassNotFoundException。

如果在运行打包后的应用程序或 runDistributable 任务时遇到 ClassNotFoundException，您可以使用 modules DSL 方法包含额外的 JDK 模块：

kotlin

compose.desktop {
    application {
        nativeDistributions {
            modules("java.sql")
            // 或者：includeAllModules = true
        }
    }
}

您可以手动指定所需的模块，或者运行 suggestModules。suggestModules 任务使用 jdeps 静态分析工具来确定可能缺失的模块。请注意，该工具的输出可能不完整或列出不必要的模块。

如果可分发文件的大小不是关键因素并且可以忽略，您可以选择通过使用 includeAllModules DSL 属性来包含所有运行时模块。

指定分发属性

软件包版本

原生分发软件包必须具有特定的软件包版本。要指定软件包版本，您可以使用以下 DSL 属性，按优先级从高到低排列：

nativeDistributions.<os>.<packageFormat>PackageVersion 为单个软件包格式指定版本。
nativeDistributions.<os>.packageVersion 为单个目标操作系统指定版本。
nativeDistributions.packageVersion 为所有软件包指定版本。

在 macOS 上，您还可以使用以下 DSL 属性指定构建版本，同样按优先级从高到低排列：

nativeDistributions.macOS.<packageFormat>PackageBuildVersion 为单个软件包格式指定构建版本。
nativeDistributions.macOS.packageBuildVersion 为所有 macOS 软件包指定构建版本。

如果您不指定构建版本，Gradle 会改用软件包版本。有关 macOS 上版本控制的更多信息，请参阅 CFBundleShortVersionString 和 CFBundleVersion 文档。

以下是按优先级顺序指定软件包版本的模板：

kotlin

compose.desktop {
    application {
        nativeDistributions {
            // 所有软件包的版本
            packageVersion = "..." 
          
            macOS {
              // 所有 macOS 软件包的版本
              packageVersion = "..."
              // 仅限 dmg 软件包的版本
              dmgPackageVersion = "..." 
              // 仅限 pkg 软件包的版本
              pkgPackageVersion = "..." 
              
              // 所有 macOS 软件包的构建版本
              packageBuildVersion = "..."
              // 仅限 dmg 软件包的构建版本
              dmgPackageBuildVersion = "..." 
              // 仅限 pkg 软件包的构建版本
              pkgPackageBuildVersion = "..." 
            }
            windows {
              // 所有 Windows 软件包的版本
              packageVersion = "..."  
              // 仅限 msi 软件包的版本
              msiPackageVersion = "..."
              // 仅限 exe 软件包的版本
              exePackageVersion = "..." 
            }
            linux {
              // 所有 Linux 软件包的版本
              packageVersion = "..."
              // 仅限 deb 软件包的版本
              debPackageVersion = "..."
              // 仅限 rpm 软件包的版本
              rpmPackageVersion = "..."
            }
        }
    }
}

定义软件包版本时，请遵循以下规则：

文件类型	版本格式	详情
`dmg`, `pkg`	`MAJOR[.MINOR][.PATCH]`	`MAJOR` 是非负整数 `MINOR` 是可选的非负整数 `PATCH` 是可选的非负整数
`msi`, `exe`	`MAJOR.MINOR.BUILD`	`MAJOR` 是最大值为 255 的非负整数 `MINOR` 是最大值为 255 的非负整数 `BUILD` 是最大值为 65535 的非负整数
`deb`	`[EPOCH:]UPSTREAM_VERSION[-DEBIAN_REVISION]`	`EPOCH` 是可选的非负整数 `UPSTREAM_VERSION`：只能包含字母数字和 `.`、`+`、`-`、`~` 字符必须以数字开头 `DEBIAN_REVISION`：可选只能包含字母数字和 `.`、`+`、`~` 字符有关更多详细信息，请参阅 Debian 文档。
`rpm`	任意格式	版本不得包含 `-`（连字符）字符。

JDK 版本

该插件使用 jpackage，这需要不低于 JDK 17 的 JDK 版本。指定 JDK 版本时，请确保至少满足以下要求之一：

JAVA_HOME 环境变量指向兼容的 JDK 版本。

通过 DSL 设置 javaHome 属性：

kotlin

compose.desktop {
    application {
        javaHome = System.getenv("JDK_17")
    }
}

输出目录

要为原生分发使用自定义输出目录，请按如下所示配置 outputBaseDir 属性：

kotlin

compose.desktop {
    application {
        nativeDistributions {
            outputBaseDir.set(project.layout.buildDirectory.dir("customOutputDir"))
        }
    }
}

启动器属性

要定制应用程序启动过程，您可以自定义以下属性：

属性	描述
`mainClass`	包含 `main` 方法的类的完全限定名称。
`args`	应用程序 `main` 方法的参数。
`jvmArgs`	应用程序 JVM 的参数。

以下是一个配置示例：

kotlin

compose.desktop {
    application {
        mainClass = "MainKt"
        args += listOf("-customArgument")
        jvmArgs += listOf("-Xmx2G")
    }
}

元数据

在 nativeDistributions DSL 块中，您可以配置以下属性：

属性	描述	默认值
`packageName`	应用程序名称。	Gradle 项目的名称
`packageVersion`	应用程序版本。	Gradle 项目的版本
`description`	应用程序描述。	无
`copyright`	应用程序版权信息。	无
`vendor`	应用程序厂商。	无
`licenseFile`	应用程序许可证文件。	无

以下是一个配置示例：

kotlin

compose.desktop {
    application {
        nativeDistributions {
            packageName = "ExampleApp"
            packageVersion = "0.1-SNAPSHOT"
            description = "Compose Multiplatform App"
            copyright = "© 2024 My Name. All rights reserved."
            vendor = "Example vendor"
            licenseFile.set(project.file("LICENSE.txt"))
        }
    }
}

管理资源

要打包和加载资源，您可以使用 Compose Multiplatform 资源库、JVM 资源加载，或向打包后的应用程序添加文件。

资源库

为项目设置资源最直接的方法是使用资源库。通过资源库，您可以在所有受支持平台的通用代码中访问资源。详情请参阅多平台资源。

JVM 资源加载

用于桌面的 Compose Multiplatform 在 JVM 平台上运行，这意味着您可以使用 java.lang.Class API 从 .jar 文件加载资源。您可以通过 Class::getResource 或 Class::getResourceAsStream 访问 src/main/resources 目录中的文件。

向打包后的应用程序添加文件

在某些情况下，从 .jar 文件加载资源可能不太实际，例如，当您拥有特定于目标的资源，并且需要仅在 macOS 软件包中包含文件而在 Windows 软件包中不包含时。

在这种情况下，您可以配置 Gradle 插件在安装目录中包含额外的资源文件。使用 DSL 指定根资源目录如下：

kotlin

compose.desktop {
    application {
        mainClass = "MainKt"
        nativeDistributions {
            targetFormats(TargetFormat.Dmg, TargetFormat.Msi, TargetFormat.Deb)
            packageVersion = "1.0.0"

            appResourcesRootDir.set(project.layout.projectDirectory.dir("resources"))
        }
    }
}

在上面的示例中，根资源目录被定义为 <PROJECT_DIR>/resources。

Gradle 插件将按以下方式包含资源子目录中的文件：

通用资源： 位于 <RESOURCES_ROOT_DIR>/common 中的文件将包含在所有软件包中，无论目标操作系统或架构如何。
特定于操作系统的资源： 位于 <RESOURCES_ROOT_DIR>/<OS_NAME> 中的文件将仅包含在为特定操作系统构建的软件包中。<OS_NAME> 的有效值为：windows、macos 和 linux。
特定于操作系统和架构的资源： 位于 <RESOURCES_ROOT_DIR>/<OS_NAME>-<ARCH_NAME> 中的文件将仅包含在为特定操作系统和 CPU 架构组合构建的软件包中。<ARCH_NAME> 的有效值为：x64 和 arm64。例如，<RESOURCES_ROOT_DIR>/macos-arm64 中的文件将仅包含在专为 Apple 芯片 Mac 准备的软件包中。

您可以使用 compose.application.resources.dir 系统属性访问包含的资源：

kotlin

import java.io.File

val resourcesDir = File(System.getProperty("compose.application.resources.dir"))

fun main() {
    println(resourcesDir.resolve("resource.txt").readText())
}

自定义源集

如果您使用 org.jetbrains.kotlin.jvm 或 org.jetbrains.kotlin.multiplatform 插件，可以依赖默认配置：

使用 org.jetbrains.kotlin.jvm 的配置包含来自 main 源集的内容。
使用 org.jetbrains.kotlin.multiplatform 的配置包含来自单个 JVM 目标的内容。如果您定义了多个 JVM 目标，则默认配置将被禁用。在这种情况下，您需要手动配置插件，或指定单个目标（见下文）。

如果默认配置含糊不清或不足，您可以通过几种方式自定义它：

使用 Gradle 源集：

plugins {
    kotlin("jvm")
    id("org.jetbrains.compose")
}
val customSourceSet = sourceSets.create("customSourceSet")
compose.desktop {
    application {
        from(customSourceSet)
    }
}

使用 Kotlin JVM 目标：

plugins {
    kotlin("multiplatform")
    id("org.jetbrains.compose")
} 
kotlin {
    jvm("customJvmTarget") {}
}
compose.desktop {
    application {
        from(kotlin.targets["customJvmTarget"])
    }
}

手动配置：

使用 disableDefaultConfiguration 禁用默认设置。
使用 fromFiles 指定要包含的文件。
指定 mainJar 文件属性以指向包含主类的 .jar 文件。
使用 dependsOn 向所有插件任务添加任务依赖项。

compose.desktop {
    application {
        disableDefaultConfiguration()
        fromFiles(project.fileTree("libs/") { include("**/*.jar") })
        mainJar.set(project.file("main.jar"))
        dependsOn("mainJarTask")
    }
}

应用程序图标

确保您的应用程序图标具有以下特定于操作系统的格式：

macOS 使用 .icns
Windows 使用 .ico
Linux 使用 .png

kotlin

compose.desktop {
    application {
        nativeDistributions {
            macOS {
                iconFile.set(project.file("icon.icns"))
            }
            windows {
                iconFile.set(project.file("icon.ico"))
            }
            linux {
                iconFile.set(project.file("icon.png"))
            }
        }
    }
}

特定于平台的选项

可以使用相应的 DSL 块配置特定于平台的设置：

compose.desktop {
    application {
        nativeDistributions {
            macOS {
                // macOS 的选项
            }
            windows {
                // Windows 的选项
            }
            linux {
                // Linux 的选项
            }
        }
    }
}

下表描述了所有受支持的特定于平台的选项。不建议使用未记录的属性。

平台	选项	描述
所有平台	`iconFile.set(File("PATH_TO_ICON"))`	指定应用程序特定平台图标的路径。有关详情，请参阅应用程序图标部分。
	`packageVersion = "1.0.0"`	设置特定平台的软件包版本。有关详情，请参阅软件包版本部分。
	`installationPath = "PATH_TO_INST_DIR"`	指定默认安装目录的绝对或相对路径。在 Windows 上，您还可以使用 `dirChooser = true` 来允许在安装过程中自定义路径。
Linux	`packageName = "custom-package-name"`	覆盖默认应用程序名称。
	`debMaintainer = "maintainer@example.com"`	指定软件包维护者的电子邮件。
	`menuGroup = "my-example-menu-group"`	为应用程序定义菜单组。
	`appRelease = "1"`	设置 rpm 软件包的发布值或 deb 软件包的修订值。
	`appCategory = "CATEGORY"`	为 rpm 软件包分配组值或为 deb 软件包分配节值。
	`rpmLicenseType = "TYPE_OF_LICENSE"`	指示 rpm 软件包的许可证类型。
	`debPackageVersion = "DEB_VERSION"`	设置 deb 特定的软件包版本。有关详情，请参阅软件包版本部分。
	`rpmPackageVersion = "RPM_VERSION"`	设置 rpm 特定的软件包版本。有关详情，请参阅软件包版本部分。
macOS	`bundleID`	指定唯一的应用程序标识符，只能包含字母数字字符 (`A-Z`, `a-z`, `0-9`)、连字符 (`-`) 和句点 (`.`)。建议使用反向 DNS 表示法 (`com.mycompany.myapp`)。
	`packageName`	应用程序的名称。
	`dockName`	在菜单栏、“关于 <App>”菜单项和程序坞中显示的应用程序名称。默认值为 `packageName`。
	`minimumSystemVersion`	运行应用程序所需的最低 macOS 版本。有关详情，请参阅 `LSMinimumSystemVersion`。
	`signing`, `notarization`, `provisioningProfile`, `runtimeProvisioningProfile`	请参阅为 macOS 签名和公证分发版教程。
	`appStore = true`	指定是否为 Apple App Store 构建并签名应用程序。需要至少 JDK 17。
	`appCategory`	Apple App Store 的应用类别。为 App Store 构建时，默认值为 `public.app-category.utilities`，否则为 `Unknown`。有关有效类别的列表，请参阅 `LSApplicationCategoryType`。
	`entitlementsFile.set(File("PATH_ENT"))`	指定包含签名时使用的权利文件的路径。当您提供自定义文件时，请务必添加 Java 应用程序所需的权利。有关为 App Store 构建时使用的默认文件，请参阅 sandbox.plist。请注意，此默认文件可能会根据您的 JDK 版本而有所不同。如果未指定文件，插件将使用 `jpackage` 提供的默认权利。有关详情，请参阅为 macOS 签名和公证分发版教程。
	`runtimeEntitlementsFile.set(File("PATH_R_ENT"))`	指定包含签名 JVM 运行时所使用的权利文件的路径。当您提供自定义文件时，请务必添加 Java 应用程序所需的权利。有关为 App Store 构建时使用的默认文件，请参阅 sandbox.plist。请注意，此默认文件可能会根据您的 JDK 版本而有所不同。如果未指定文件，插件将使用 `jpackage` 提供的默认权利。有关详情，请参阅为 macOS 签名和公证分发版教程。
	`dmgPackageVersion = "DMG_VERSION"`	设置 DMG 特定的软件包版本。有关详情，请参阅软件包版本部分。
	`pkgPackageVersion = "PKG_VERSION"`	设置 PKG 特定的软件包版本。有关详情，请参阅软件包版本部分。
	`packageBuildVersion = "DMG_VERSION"`	设置软件包构建版本。有关详情，请参阅软件包版本部分。
	`dmgPackageBuildVersion = "DMG_VERSION"`	设置 DMG 特定的软件包构建版本。有关详情，请参阅软件包版本部分。
	`pkgPackageBuildVersion = "PKG_VERSION"`	设置 PKG 特定的软件包构建版本。有关详情，请参阅软件包版本部分。
	`infoPlist`	请参阅 macOS 上的 `Info.plist` 部分。
Windows	`console = true`	为应用程序添加控制台启动器。
	`dirChooser = true`	允许在安装过程中自定义安装路径。
	`perUserInstall = true`	允许按用户安装应用程序。
	`menuGroup = "start-menu-group"`	将应用程序添加到指定的“开始”菜单组。
	`upgradeUuid = "UUID"`	指定一个唯一 ID，当存在比已安装版本更新的版本时，允许用户通过安装程序更新应用程序。对于单个应用程序，该值必须保持不变。有关详情，请参阅如何生成 GUID。
	`msiPackageVersion = "MSI_VERSION"`	设置 MSI 特定的软件包版本。有关详情，请参阅软件包版本部分。
	`exePackageVersion = "EXE_VERSION"`	设置 EXE 特定的软件包版本。有关详情，请参阅软件包版本部分。

macOS 特定的配置

macOS 上的签名和公证

现代 macOS 版本不允许用户执行从互联网下载的未经签名的应用程序。如果您尝试运行此类应用程序，您将遇到以下错误：“YourApp 已损坏，无法打开。您应该弹出磁盘镜像”。

要了解如何为您的应用程序签名和公证，请参阅我们的教程。

macOS 上的信息属性列表

虽然 DSL 支持基本的特定于平台的自定义，但仍可能存在超出所提供功能的情况。如果您需要指定 DSL 中未体现的 Info.plist 值，您可以包含一段原始 XML 作为权宜之计。此 XML 将被附加到应用程序的 Info.plist 中。

示例：深度链接

在 build.gradle.kts 文件中定义自定义 URL 方案：

compose.desktop {
    application {
        mainClass = "MainKt"
        nativeDistributions {
            targetFormats(TargetFormat.Dmg)
            packageName = "Deep Linking Example App"
            macOS {
                bundleID = "org.jetbrains.compose.examples.deeplinking"
                infoPlist {
                    extraKeysRawXml = macExtraPlistKeys
                }
            }
        }
    }
}

val macExtraPlistKeys: String
    get() = """
      <key>CFBundleURLTypes</key>
      <array>
        <dict>
          <key>CFBundleURLName</key>
          <string>Example deep link</string>
          <key>CFBundleURLSchemes</key>
          <array>
            <string>compose</string>
          </array>
        </dict>
      </array>
    """

使用 java.awt.Desktop 类在 src/main/main.kt 文件中设置 URI 处理程序：

import androidx.compose.material.MaterialTheme
import androidx.compose.material.Text
import androidx.compose.runtime.getValue
import androidx.compose.runtime.mutableStateOf
import androidx.compose.runtime.setValue
import androidx.compose.ui.window.singleWindowApplication
import java.awt.Desktop

fun main() {
    var text by mutableStateOf("Hello, World!")

    try {
        Desktop.getDesktop().setOpenURIHandler { event ->
            text = "Open URI: " + event.uri
        }
    } catch (e: UnsupportedOperationException) {
        println("setOpenURIHandler is unsupported")
    }

    singleWindowApplication {
        MaterialTheme {
            Text(text)
        }
    }
}

执行 runDistributable 任务：./gradlew runDistributable。

结果，像 compose://foo/bar 这样的链接现在可以从浏览器重定向到您的应用程序。

压缩与混淆

Compose Multiplatform Gradle 插件包含对 ProGuard 的内置支持。 ProGuard 是一款用于代码压缩和混淆的开源工具。

对于每个默认打包任务（不含 ProGuard），Gradle 插件都提供了一个对应的 release 任务（包含 ProGuard）：

Gradle 任务	描述
默认：`createDistributable` Release：`createReleaseDistributable`	创建包含捆绑 JDK 和资源的应用程序镜像。
默认：`runDistributable` Release：`runReleaseDistributable`	运行包含捆绑 JDK 和资源的应用程序镜像。
默认：`run` Release：`runRelease`	使用 Gradle JDK 运行非打包的应用程序 `.jar`。
默认：`package<FORMAT_NAME>` Release：`packageRelease<FORMAT_NAME>`	将应用程序镜像打包成 `<FORMAT_NAME>` 文件。
默认：`packageDistributionForCurrentOS` Release：`packageReleaseDistributionForCurrentOS`	将应用程序镜像打包成与当前操作系统兼容的格式。
默认：`packageUberJarForCurrentOS` Release：`packageReleaseUberJarForCurrentOS`	将应用程序镜像打包成一个 uber (fat) `.jar`。
默认：`notarize<FORMAT_NAME>` Release：`notarizeRelease<FORMAT_NAME>`	上传 `<FORMAT_NAME>` 应用程序镜像以进行公证（仅限 macOS）。
默认：`checkNotarizationStatus` Release：`checkReleaseNotarizationStatus`	检查公证是否成功（仅限 macOS）。

默认配置启用了一些预定义的 ProGuard 规则：

应用程序镜像已被压缩，这意味着未使用的类已被移除。
compose.desktop.application.mainClass 被用作入口点。
包含了几条 keep 规则，以确保 Compose 运行时保持正常功能。

在大多数情况下，您不需要任何额外配置即可获得压缩后的应用程序。但是，ProGuard 可能无法跟踪字节码中的某些用法，例如，当通过反射使用类时。如果您遇到仅在 ProGuard 处理后出现的问题，您可能需要添加自定义规则。

要指定自定义配置文件，请按如下方式使用 DSL：

kotlin

compose.desktop {
    application {
        buildTypes.release.proguard {
            configurationFiles.from(project.file("compose-desktop.pro"))
        }
    }
}

有关 ProGuard 规则和配置选项的更多信息，请参阅 Guardsquare 手册。

混淆默认是禁用的。要启用它，请通过 Gradle DSL 设置以下属性：

kotlin

compose.desktop {
    application {
        buildTypes.release.proguard {
            obfuscate.set(true)
        }
    }
}

ProGuard 的优化默认是启用的。要禁用它们，请通过 Gradle DSL 设置以下属性：

kotlin

compose.desktop {
    application {
        buildTypes.release.proguard {
            optimize.set(false)
        }
    }
}

生成 uber JAR 默认是禁用的，ProGuard 会为每个输入 .jar 生成对应的 .jar 文件。要启用它，请通过 Gradle DSL 设置以下属性：

kotlin

compose.desktop {
    application {
        buildTypes.release.proguard {
            joinOutputJars.set(true)
        }
    }
}

下一步

探索关于桌面组件的教程。

原生分发 ​

Gradle 插件 ​

基本任务 ​

包含 JDK 模块 ​

指定分发属性 ​

软件包版本 ​

JDK 版本 ​

输出目录 ​

启动器属性 ​

元数据 ​

管理资源 ​

资源库 ​

JVM 资源加载 ​

向打包后的应用程序添加文件 ​

自定义源集 ​

应用程序图标 ​

特定于平台的选项 ​

macOS 特定的配置 ​

macOS 上的签名和公证 ​

macOS 上的信息属性列表 ​

示例：深度链接 ​

压缩与混淆 ​

下一步 ​

原生分发

Gradle 插件

基本任务

包含 JDK 模块

指定分发属性

软件包版本

JDK 版本

输出目录

启动器属性

元数据

管理资源

资源库

JVM 资源加载

向打包后的应用程序添加文件

自定义源集

应用程序图标

特定于平台的选项

macOS 特定的配置

macOS 上的签名和公证

macOS 上的信息属性列表

示例：深度链接

压缩与混淆

下一步