Compose Desktop体验

2020-12-17 14:18:12 浏览数 (1)

最近 JetBarin 公司发布了 Compose Desktop[1]。是的,你没听错,就是 Google 用于 Android 上的 Compose[2]

Jetpack Compose 是用于构建原生 Android 界面的新工具包。Jetpack Compose 使用更少的代码、强大的工具和直观的 Kotlin API 简化并加快了 Android 上的界面开发。

而现在,就可以编写同样的 UI 层代码,然后运行到 Android 和 Desktop 了。不难发现,这是 kotlin 一直在搞的套路,多平台共享代码。

使用了 Skia 进行硬件加速( 就是 Flutter 使用的 Skia ),可以与 AWT 和 Swing 进行互操作。

让我们先来一个 Hello World 试试水。

新建 Compose 项目

你可以更新到最新的 idea 2020.3,或者从 Github[3] 上拉取它的模板。这里我选择使用 idea。

在 kotlin 选项中找到 JetBrains Compose ,选择 Desktop uses Kotlin。

创建完成后等待 gradle 依赖下载。

但是在这里会出现问题,运行时报下面的错。

org/jetbrains/kotlin/cli/common/PropertiesKt org.jetbrains.kotlin.cli.common.PropertiesKt Try: Run with --stacktrace option to get the stack trace. Run with --info or --debug option to get more log output. Run with --scan to get full insights.

经过排查,这是由 Gradle 和 java 14 引起的,Gradle 6.6 的版本会引起该问题,可以将 gradle 更改到 6.7 或者 6.5 重新进行构建。我这里修改到 6.5.1

目前 compose 的版本为 113 , 而通过 idea 创建的 版本为 63,所以更新版本。

以下为官方的 gradle.kts 配置

代码语言:javascript复制
import org.jetbrains.compose.compose
import org.jetbrains.compose.desktop.application.dsl.TargetFormat
import org.jetbrains.kotlin.gradle.tasks.KotlinCompile

plugins {
    kotlin("jvm") version "1.4.0"
    // __UPDATE_COMPOSE_VERSION_MARKER__
    id("org.jetbrains.compose") version (System.getenv("COMPOSE_TEMPLATE_COMPOSE_VERSION") ?: "0.1.0-build113")
}


group = "me.young"
version = "1.0-SNAPSHOT"

dependencies {
    implementation(compose.desktop.currentOs)
}

compose.desktop {
    application {
        mainClass = "MainKt"

        nativeDistributions {
            targetFormats(TargetFormat.Dmg, TargetFormat.Msi, TargetFormat.Deb)
            packageName = "KotlinJvmComposeDesktopApplication"
        }
    }
}
repositories {
    jcenter()
    maven("https://maven.pkg.jetbrains.space/public/p/compose/dev")
}

运行

打开 main.kt, 运行 main 函数。

看样子还行,还是熟悉的界面 JavaFx , 还是熟悉的味道 Material Design 。让我们来瞅瞅代码。

代码语言:javascript复制
fun main() = Window {
    var text by remember { mutableStateOf("Hello, World!") }

    MaterialTheme {
        Button(onClick = {
            text = "Hello, Desktop!"
        }) {
            Text(text)
        }
    }
}

通过通过点击按钮,来更改 text,从而来刷新界面。基本和其他声明式 UI ,大同小异,比如 flutter,swiftUI 等。

基本使用控件使用可以参考 androidx.compose[4] 文档。

针对桌面做了一些扩展,比如鼠标,键盘事件,系统的原生通知,系统的托盘菜单。

具体文档可以参考官方 JetBrains/compose-jb[5] 仓库

打包

开发完成的应用可以直接打包为平台可执行文件。我使用的是 windows 平台。通过 packageMsi 命令打包为 exe 应用。

这里会下载 wix3[6]

这里可能会出现下载失败,如果下载失败,请手动到 Github 下载 wix311-binaries.zip。然后将文件命名为 wix311.zip 放在 build/wixToolset 下,重新运行 packageMsi 。

当你认为你要编译成功时, Gradle 再次报错。

������������, �����˴������MSI ��װ�����: � 汾 �ַ��������� MSI ���� [1.0-SNAPSHOT] �޸�����: �������¹������ô��������� "win.msi.productVersion"��https://msdn.microsoft.com/en-us/library/aa370859(v=VS.85).aspx��

夺命 � 错,打开连接一看,好像是指定版本有问题, 微软要求版本必须按照 major.minor.build 这样的方式进行指定,而且 major 的范围是 0-255,minor 的范围是 0-255,最后的 build 的范围是 0-65535 。

在 Gradle 中添加版本号。

代码语言:javascript复制
nativeDistributions {
    targetFormats(TargetFormat.Dmg, TargetFormat.Msi, TargetFormat.Deb)
    packageName = "Hello World"
    version = "0.1.0"
}

更新 gradle 后重新 packageMsi。

仍旧是报错。这次是 IO 异常。

在 Gradle 中添加新的配置 vendor 。

代码语言:javascript复制
nativeDistributions {
    targetFormats(TargetFormat.Dmg, TargetFormat.Msi, TargetFormat.Deb)
    packageName = "Hello World"
    version = "0.1.0"
    vendor = "Example vendor"
}

经历了一番波折后终于可以打包成功。

打包后的 msi 在 buildcomposebinariesmainmsiHello World-0.1.0.msi。

一个简单的 Hello World 大小在 40 mb 左右。

总结

目前来说,项目还有很多 bug,毕竟才 Alpha,而且官方文档也有错误。例如打包这一块,很多问题需要自己摸索。

例如中文输入法的输入的情况下报错。

Exception in thread "AWT-EventQueue-0 @coroutine#2" java.lang.NullPointerException: event.text must not be null。

图标显示问题,在我这里显示一个黑框框。

但是,jvm 上的 GUI 技术有了新的发展未尝不是一件好事,可以一处编写,多端运行。

参考资料

compose-jb[7]

JetBrains/compose-jb[8]

androidx.compose[9]

Jetpack Compose 基础知识[10]

参考资料

[1]

Compose Desktop: https://www.jetbrains.com/lp/compose/

[2]

Compose: https://developer.android.com/jetpack/compose?hl=zh-cn

[3]

Github: https://github.com/JetBrains/compose-jb/tree/master/templates/desktop-template

[4]

androidx.compose: https://developer.android.com/reference/kotlin/androidx/compose/ui/package-summary?hl=zh-cn

[5]

JetBrains/compose-jb: https://github.com/JetBrains/compose-jb

[6]

wix3: https://github.com/wixtoolset/wix3

[7]

compose-jb: https://www.jetbrains.com/lp/compose/

[8]

JetBrains/compose-jb: https://github.com/JetBrains/compose-jb

[9]

androidx.compose: https://developer.android.com/reference/kotlin/androidx/compose/ui/package-summary?hl=zh-cn

[10]

Jetpack Compose 基础知识: https://developer.android.com/jetpack/compose/tutorial

0 人点赞