Slint Android Activity 后端android-activity深度解析架构、接入与构建部署指南【免费下载链接】slintSlint is an open-source declarative GUI toolkit to build native user interfaces for Rust, C, JavaScript, or Python apps.项目地址: https://gitcode.com/GitHub_Trending/sl/slint本文以 Slint 仓库中 internal/backends/android-activity/README.md 为核心结合该后端的 Rust 源码lib.rs、androidwindowadapter.rs、javahelper.rs、vsync.rs与 Java 辅助类实现系统讲解 Slint 在 Android 平台上的后端实现原理、slint::android模块的接入方式、Cargo 特性配置以及从源码构建、部署 APK 的完整流程。读完本文你将掌握如何在 Rust 应用中通过android_main入口初始化 Slint Android 后端理解其事件循环、触摸/键盘/输入法事件流转、系统深色模式与安全区适配等底层机制并能够独立完成cargo-apk构建与真机部署。一、认识 Slint 的 Android 后端i-slint-backend-android-activity是 Slint 项目的一个内部 crateinternal crate它实现了 Slint 在 Android 平台上的 backend即平台层。该 crate 依赖 android-activity crate 来完成应用初始化与事件处理android-activity 负责把原生 Android 的Activity生命周期、窗口与输入事件桥接到 Rust 侧而本后端则把这些事件翻译成 Slint 内部的WindowEvent并驱动渲染与事件循环。这个后端并不建议用户直接依赖而是通过 Slint 对外暴露的slint::android模块间接使用。对应的高层封装位于 api/rs/slint/android.rs其中明确指出Slint 使用 android-activity crate 作为后端并为了方便将 android-activity 的内容在slint::android::android_activity下重新导出。版本约束警告在深入使用之前必须先了解一个关键约束。README 特别强调该 crate 是internal性质的 crate它不遵循 semver 版本约定在Cargo.toml中只能使用精确版本锁定version x.y.z。这意味着它随时可能发生破坏性变更且依赖它的上层 crate如slint会以精确版本锁定方式引用用户代码不应直接依赖它做任何假设。二、后端整体架构与核心模块该 crate 源码结构非常清晰顶层入口是 internal/backends/android-activity/lib.rs由四个模块组成模块文件职责lib.rs平台入口AndroidPlatform、事件循环、剪贴板、事件代理androidwindowadapter.rs窗口适配器尺寸、渲染、输入事件触摸/按键/IME处理javahelper.rsJNI 桥接加载内嵌 dex 的SlintAndroidJavaHelper并调用 Java 方法vsync.rs基于 Android Choreographer 的 vsync 帧驱动用于动画节奏另外在java/目录下还有 SlintAndroidJavaHelper.java它负责所有需要在 UI 线程完成的 Android 系统集成工作输入法、剪贴板、安全区、返回键、光标手柄等。平台对象AndroidPlatformlib.rs 定义了核心结构体pub struct AndroidPlatform { app: AndroidApp, // android-activity 传入的应用对象 window: RcAndroidWindowAdapter, // 窗口适配器 event_listener: OptionBoxdyn Fn(PollEvent_), context: core::cell::OnceCelli_slint_core::SlintContextWeak, }它实现了i_slint_core::platform::Platformtrait向 Slint 提供窗口创建create_window_adapter、事件循环运行run_event_loop、事件循环代理new_event_loop_proxy、剪贴板读写set_clipboard_text/clipboard_text等平台能力。Rust 侧与 Java 侧的协作后端的一个显著特点是「Rust 为主、Java 为辅」所有 Slint 相关的渲染与事件处理都在 Rust 侧完成而涉及 Android 系统 API 的操作输入法编辑器、剪贴板、状态栏安全区、深色模式、系统字体缩放、返回键回调通过 JNI 调用一个内嵌在 dex 中的 Java 辅助类。javahelper.rs中通过include_bytes!在构建期把编译好的classes.dex内嵌进 cratejavahelper.rs运行时再用InMemoryDexClassLoaderAPI 26或DexClassLoader低版本写文件方式加载从而避免用户额外打包 Java 代码。三、快速上手编写第一个 Android 应用按照 api/rs/slint/android.rs 的模块文档一个最小可用的 Android 应用如下。1. 入口函数 android_main与使用 android-activity 的所有应用一样应用的入口是android_main函数它必须标注#[unsafe(no_mangle)]以保证符号导出#[cfg(target_os android)] #[unsafe(no_mangle)] fn android_main(app: slint::android::AndroidApp) { slint::android::init(app).unwrap(); // ... rest of your code ... slint::slint!{ export component MainWindow inherits Window { Text { text: Hello World; } } } MainWindow::new().unwrap().run().unwrap(); }slint::android::init(app)内部把AndroidPlatform::new(app)交给slint::platform::set_platform()注册为当前平台后端见 android.rs因此该函数必须在任何需要后端的 Slint 调用之前执行。2. Cargo.toml 配置android_main必须位于一个cdylib库中并且需要在slintcrate 上启用backend-android-activity-06特性[lib] crate-type [cdylib] [dependencies] slint { version 1.6, features [backend-android-activity-06] }3. 初始化带事件监听的版本如果希望感知 android-activity 的原始事件例如用于调试可以使用init_with_event_listener对应后端AndroidPlatform::new_with_event_listener见 lib.rs#[cfg(target_os android)] #[unsafe(no_mangle)] fn android_main(app: slint::android_activity::AndroidApp) { slint::android::init_with_event_listener( app, |event| { eprintln!(got event {event:?}) } ).unwrap(); // ... rest of your application ... }监听器接收的是android_activity::PollEvent后端会在run_event_loop的每次事件轮询后调用它见 lib.rs因此适合做事件级调试与埋点而不影响 Slint 自身的处理流程。四、构建与部署从源码到 APK构建 Rust Android 应用需要安装目标工具链可通过rustup添加。例如针对 AArch64 Androidrustup target add aarch64-linux-android同时确保本机已安装并配置好 Android NDK 与 SDK并设置以下环境变量ANDROID_HOMEAndroid SDK 所在目录通常为$HOME/Android/SdkANDROID_NDK_ROOTAndroid NDK 所在目录通常为$HOME/Android/Sdk/ndk/${NDK_VERSION}其中${NDK_VERSION}是你安装的 NDK 版本JAVA_HOMEjavac所在目录。如果javac已在$PATH中可省略否则可将其指向 Android Studio 自带的 JDK例如android-studio/jbr。推荐使用cargo-apkcargo 子命令负责构建、签名与部署 Rust 编写的 Android APKcargo install cargo-apk构建并运行cargo apk run --target aarch64-linux-android --lib需要说明的是Slint 并不强制绑定某个构建工具也可以使用其他同类工具如 xbuild完成构建只需保证最终产出标准的 Android 应用包即可。五、Cargo 特性features详解后端 crate 的能力由一组特性控制定义在 internal/backends/android-activity/Cargo.toml[features] game-activity [android-activity-06?/game-activity, android-activity-05?/game-activity] native-activity [android-activity-06?/native-activity, android-activity-05?/native-activity] aa-06 [android-activity-06, ndk-09] aa-05 [android-activity-05, ndk-08] unstable-wgpu-29 [i-slint-renderer-skia/unstable-wgpu-29] unstable-wgpu-30 [i-slint-renderer-skia/unstable-wgpu-30]含义说明aa-06/aa-05选择 android-activity 的 0.6 / 0.5 版本后者已标记为Deprecated两者互斥并分别配对ndk0.9 / 0.8。在slintcrate 侧backend-android-activity-06特性默认组合了native-activityaa-06见 api/rs/slint/Cargo.toml。native-activity/game-activity选择 Activity 的两种承载方式。native-activity使用传统的NativeActivitygame-activity则接入 Android 的 GameActivity。两者会显著影响输入法与软键盘的实现路径——在native-activity下软键盘的显示/隐藏无法走 android-activity 自带 API后端改用 JNI 手动调用 Java 侧的show_keyboard/hide_keyboard见 javahelper.rs。unstable-wgpu-29/unstable-wgpu-30将 Skia 渲染器切换到对应的 wgpu 版本后端。默认不带这两个特性时使用 OpenGL 渲染路径从源码看AndroidWindowAdapter::new会根据特性选择SkiaRenderer::default或default_wgpu_29/30见 androidwindowadapter.rs。另外slint::android模块还暴露了set_requested_graphics_api函数实现见 lib.rs用于在slint::android::init()之后请求特定的图形 API若在 init 之前调用会返回错误提示。六、事件循环与动画帧驱动原理Android 上的事件循环由run_event_loop承担lib.rs其核心是一个loopapp.poll_events(timeout, ...)结构计算下一次定时器更新的超时时间查询窗口是否有活跃动画若有则把 vsync 驱动置于「动画模式」若 vsync 线程尚未就绪或不可用则回退为周期性唤醒10ms 兜底保证动画不会停滞若存在request_redraw()产生的待重绘标记则把超时置为 0 以立即唤醒poll_events回调中依次执行update_timers_and_animations、process_event处理窗口事件、调用可选的事件监听器若事件处理返回Break则退出循环否则在有待重绘标记时执行do_render()。vsync 驱动Choreographer 的接入动画节奏不依赖固定轮询而是跟随屏幕刷新率。vsync.rs的模块注释vsync.rs解释了其设计动机Choreographer 的回调经由它获取时所在的ALooper派发而 android-activity 的poll_events会把ALOOPER_POLL_CALLBACK当作伪错误日志。为避免污染主循环后端专门起一个独立辅助线程在线程自己的 looper 上获取 Choreographer每帧 vsync 到达后用AndroidAppWaker唤醒主事件循环主循环随后推进动画并渲染。由于ndkcrate 未封装 Choreographervsync.rs直接通过 FFI 声明了AChoreographer_getInstance与AChoreographer_postFrameCallbackvsync.rs。Choreographer 自 API 24 引入而 Slint 的 Android 最低版本要求是 API 26因此这些符号总是可用。辅助线程还通过条件变量与主线程协作动画开启时逐帧唤醒动画停止后挂起退出时通过looper.wake()打断可能阻塞的 poll 以正常收尾。七、输入事件处理触摸、按键与输入法所有输入事件在AndroidWindowAdapter::process_inputs中处理androidwindowadapter.rs它从app.input_events_iter()迭代读取事件并翻译为 Slint 的WindowEvent。触摸与鼠标MotionAction::Down/Up/Move等被映射为 Slint 的Touch内部事件TouchPhase::Started/Ended/Moved支持多点触控PointerDown/PointerUp处理第二根手指ButtonPress/ButtonRelease被映射为PointerPressed/PointerReleased特别值得注意的细节在判断鼠标按键时源码刻意不使用action_button()API而是基于button_state()与上一次状态的异或来推算被切换的按键androidwindowadapter.rs因为前者依赖 NDK 33Android 13后者可运行在 Android 12 及更低版本上。按键与返回键map_key_code维护了一张完整的 AndroidKeycode→ Slint 键映射表androidwindowadapter.rs支持字母、数字、方向键、回车、退格、Shift/Ctrl/Alt/Meta、F1-F12 乃至数字小键盘等。Back键被映射为Key::Back。在 API 34 上返回事件改由OnBackInvokedDispatcher分发Java 侧注册回调后调用SlintAndroidJavaHelper.onBackInvoked()见 SlintAndroidJavaHelper.javaRust 侧先把它作为Key.Back的按下/释放事件对派发给 Slintjavahelper.rs若 Slint 未处理则回退到Activity.finish()保留「返回键关闭 Activity」的传统行为。输入法IME与文本编辑文本输入是 Android 后端最复杂的部分之一涉及 Rust 与 Java 的双向数据流Rust → Javaset_imm_data把文本内容、光标/锚点位置UTF-16 偏移、preedit 区间、光标矩形、输入类型标志等同步给 Java 侧其中InputTypeText/Search/Password/Number/Decimal会进一步细化为android.text.InputType的各类标志位包括首字母大写模式、自动纠错、自动补全javahelper.rs。Java → RustSlintInputView是一个自定义View通过BaseInputConnection与系统 IME 对接用户输入变化时回调updateText原生方法SlintAndroidJavaHelper.javaRust 侧再把它还原成UpdateComposition/CommitComposition内部键事件交给 Slintjavahelper.rs。此外Java 侧还实现了文本选择光标手柄InputHandle基于PopupWindow 系统textSelectHandle*主题资源与浮动操作菜单剪切/复制/粘贴/全选见 SlintAndroidJavaHelper.java。Rust 侧的长按检测由LongPressDetection计时器完成按下时启动long_press_timeout取自系统ViewConfiguration.getLongPressTimeout默认约 500ms见 lib.rs超时且手指位移不超过阈值10 逻辑像素时选中单词并弹出操作菜单androidwindowadapter.rs。八、系统集成能力深色模式、字体缩放、剪贴板与安全区该后端在bind_contextlib.rs中完成一系列与系统设置相关的初始化深色模式读取系统uiModeUI_MODE_NIGHT_NO0x10 /UI_MODE_NIGHT_YES0x20映射为 Slint 的ColorScheme::Light/Dark/Unknown并通过ctx.set_color_scheme生效当系统配置变化时Java 侧onConfigurationChanged回调setNightModeSlintAndroidJavaHelper.javaRust 侧同样更新配色方案并刷新 accent 色javahelper.rs。强调色accent color通过解析主题中的android.R.attr.colorAccent获取并设置为 Slint 的强调色SlintAndroidJavaHelper.java。系统字体缩放读取Configuration.fontScale乘以 Material Design 正文基准字号 14LP 得到默认字体大小font_scale_to_logical_lengthjavahelper.rs并通过set_platform_default_font_size应用系统字体缩放变化时也会动态更新且会跳过 0.0 或 NaN 等异常值以免覆盖已设置的正确值。剪贴板set_clipboard_text/clipboard_text通过 JNI 调用 Java 侧ClipboardManager实现SlintAndroidJavaHelper.java其中读取剪贴板时用FutureTask在 UI 线程执行并同步等待结果。安全区与虚拟键盘Java 侧在 API 30 使用WindowInsets精确计算状态栏、刘海屏与 IME 键盘的 insets在低版本则退化为getWindowVisibleDisplayFrame近似估算SlintAndroidJavaHelper.java。这些 insets 通过setInsets原生回调传回 Rustjavahelper.rs最终由update_window_insets计算虚拟键盘遮挡矩形并设置到 Slint 窗口androidwindowadapter.rs。非全屏模式下safe_area_inset也会让 Slint 的 safe-area 机制生效androidwindowadapter.rs。九、常见问题与注意事项必须使用精确版本锁定由于该 crate 不遵循 semver任何直接依赖都应写version x.y.z升级时需关注破坏性变更。#[unsafe(no_mangle)]不可省略android_main符号必须按名称导出否则系统无法找到应用入口见 android.rs。init()的调用时机slint::android::init必须在任何需要后端的 Slint API 之前调用set_requested_graphics_api同理必须在 init 之后使用。最低系统版本从 vsync 实现注释vsync.rs可以确认Slint 的 Android 最低要求为 API 26NDK 版本选择0.8/0.9与 android-activity 版本0.5/0.6通过特性绑定aa-05已弃用新项目应使用backend-android-activity-06。渲染后端选择默认使用 Skia OpenGL 路径如需 wgpu需启用unstable-wgpu-29/unstable-wgpu-30特性两者互斥。十、相关源码索引后端 README本主题核心文档internal/backends/android-activity/README.md平台入口与事件循环internal/backends/android-activity/lib.rs窗口适配器与输入处理internal/backends/android-activity/androidwindowadapter.rsJNI 桥接与 dex 加载internal/backends/android-activity/javahelper.rsvsync 帧驱动internal/backends/android-activity/vsync.rsJava 辅助类internal/backends/android-activity/java/SlintAndroidJavaHelper.java特性定义与依赖internal/backends/android-activity/Cargo.toml公开 APIslint::android模块api/rs/slint/android.rsslintcrate 特性组合api/rs/slint/Cargo.toml【免费下载链接】slintSlint is an open-source declarative GUI toolkit to build native user interfaces for Rust, C, JavaScript, or Python apps.项目地址: https://gitcode.com/GitHub_Trending/sl/slint创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
Slint Android Activity 后端（android-activity）深度解析：架构、接入与构建部署指南
Slint Android Activity 后端android-activity深度解析架构、接入与构建部署指南【免费下载链接】slintSlint is an open-source declarative GUI toolkit to build native user interfaces for Rust, C, JavaScript, or Python apps.项目地址: https://gitcode.com/GitHub_Trending/sl/slint本文以 Slint 仓库中 internal/backends/android-activity/README.md 为核心结合该后端的 Rust 源码lib.rs、androidwindowadapter.rs、javahelper.rs、vsync.rs与 Java 辅助类实现系统讲解 Slint 在 Android 平台上的后端实现原理、slint::android模块的接入方式、Cargo 特性配置以及从源码构建、部署 APK 的完整流程。读完本文你将掌握如何在 Rust 应用中通过android_main入口初始化 Slint Android 后端理解其事件循环、触摸/键盘/输入法事件流转、系统深色模式与安全区适配等底层机制并能够独立完成cargo-apk构建与真机部署。一、认识 Slint 的 Android 后端i-slint-backend-android-activity是 Slint 项目的一个内部 crateinternal crate它实现了 Slint 在 Android 平台上的 backend即平台层。该 crate 依赖 android-activity crate 来完成应用初始化与事件处理android-activity 负责把原生 Android 的Activity生命周期、窗口与输入事件桥接到 Rust 侧而本后端则把这些事件翻译成 Slint 内部的WindowEvent并驱动渲染与事件循环。这个后端并不建议用户直接依赖而是通过 Slint 对外暴露的slint::android模块间接使用。对应的高层封装位于 api/rs/slint/android.rs其中明确指出Slint 使用 android-activity crate 作为后端并为了方便将 android-activity 的内容在slint::android::android_activity下重新导出。版本约束警告在深入使用之前必须先了解一个关键约束。README 特别强调该 crate 是internal性质的 crate它不遵循 semver 版本约定在Cargo.toml中只能使用精确版本锁定version x.y.z。这意味着它随时可能发生破坏性变更且依赖它的上层 crate如slint会以精确版本锁定方式引用用户代码不应直接依赖它做任何假设。二、后端整体架构与核心模块该 crate 源码结构非常清晰顶层入口是 internal/backends/android-activity/lib.rs由四个模块组成模块文件职责lib.rs平台入口AndroidPlatform、事件循环、剪贴板、事件代理androidwindowadapter.rs窗口适配器尺寸、渲染、输入事件触摸/按键/IME处理javahelper.rsJNI 桥接加载内嵌 dex 的SlintAndroidJavaHelper并调用 Java 方法vsync.rs基于 Android Choreographer 的 vsync 帧驱动用于动画节奏另外在java/目录下还有 SlintAndroidJavaHelper.java它负责所有需要在 UI 线程完成的 Android 系统集成工作输入法、剪贴板、安全区、返回键、光标手柄等。平台对象AndroidPlatformlib.rs 定义了核心结构体pub struct AndroidPlatform { app: AndroidApp, // android-activity 传入的应用对象 window: RcAndroidWindowAdapter, // 窗口适配器 event_listener: OptionBoxdyn Fn(PollEvent_), context: core::cell::OnceCelli_slint_core::SlintContextWeak, }它实现了i_slint_core::platform::Platformtrait向 Slint 提供窗口创建create_window_adapter、事件循环运行run_event_loop、事件循环代理new_event_loop_proxy、剪贴板读写set_clipboard_text/clipboard_text等平台能力。Rust 侧与 Java 侧的协作后端的一个显著特点是「Rust 为主、Java 为辅」所有 Slint 相关的渲染与事件处理都在 Rust 侧完成而涉及 Android 系统 API 的操作输入法编辑器、剪贴板、状态栏安全区、深色模式、系统字体缩放、返回键回调通过 JNI 调用一个内嵌在 dex 中的 Java 辅助类。javahelper.rs中通过include_bytes!在构建期把编译好的classes.dex内嵌进 cratejavahelper.rs运行时再用InMemoryDexClassLoaderAPI 26或DexClassLoader低版本写文件方式加载从而避免用户额外打包 Java 代码。三、快速上手编写第一个 Android 应用按照 api/rs/slint/android.rs 的模块文档一个最小可用的 Android 应用如下。1. 入口函数 android_main与使用 android-activity 的所有应用一样应用的入口是android_main函数它必须标注#[unsafe(no_mangle)]以保证符号导出#[cfg(target_os android)] #[unsafe(no_mangle)] fn android_main(app: slint::android::AndroidApp) { slint::android::init(app).unwrap(); // ... rest of your code ... slint::slint!{ export component MainWindow inherits Window { Text { text: Hello World; } } } MainWindow::new().unwrap().run().unwrap(); }slint::android::init(app)内部把AndroidPlatform::new(app)交给slint::platform::set_platform()注册为当前平台后端见 android.rs因此该函数必须在任何需要后端的 Slint 调用之前执行。2. Cargo.toml 配置android_main必须位于一个cdylib库中并且需要在slintcrate 上启用backend-android-activity-06特性[lib] crate-type [cdylib] [dependencies] slint { version 1.6, features [backend-android-activity-06] }3. 初始化带事件监听的版本如果希望感知 android-activity 的原始事件例如用于调试可以使用init_with_event_listener对应后端AndroidPlatform::new_with_event_listener见 lib.rs#[cfg(target_os android)] #[unsafe(no_mangle)] fn android_main(app: slint::android_activity::AndroidApp) { slint::android::init_with_event_listener( app, |event| { eprintln!(got event {event:?}) } ).unwrap(); // ... rest of your application ... }监听器接收的是android_activity::PollEvent后端会在run_event_loop的每次事件轮询后调用它见 lib.rs因此适合做事件级调试与埋点而不影响 Slint 自身的处理流程。四、构建与部署从源码到 APK构建 Rust Android 应用需要安装目标工具链可通过rustup添加。例如针对 AArch64 Androidrustup target add aarch64-linux-android同时确保本机已安装并配置好 Android NDK 与 SDK并设置以下环境变量ANDROID_HOMEAndroid SDK 所在目录通常为$HOME/Android/SdkANDROID_NDK_ROOTAndroid NDK 所在目录通常为$HOME/Android/Sdk/ndk/${NDK_VERSION}其中${NDK_VERSION}是你安装的 NDK 版本JAVA_HOMEjavac所在目录。如果javac已在$PATH中可省略否则可将其指向 Android Studio 自带的 JDK例如android-studio/jbr。推荐使用cargo-apkcargo 子命令负责构建、签名与部署 Rust 编写的 Android APKcargo install cargo-apk构建并运行cargo apk run --target aarch64-linux-android --lib需要说明的是Slint 并不强制绑定某个构建工具也可以使用其他同类工具如 xbuild完成构建只需保证最终产出标准的 Android 应用包即可。五、Cargo 特性features详解后端 crate 的能力由一组特性控制定义在 internal/backends/android-activity/Cargo.toml[features] game-activity [android-activity-06?/game-activity, android-activity-05?/game-activity] native-activity [android-activity-06?/native-activity, android-activity-05?/native-activity] aa-06 [android-activity-06, ndk-09] aa-05 [android-activity-05, ndk-08] unstable-wgpu-29 [i-slint-renderer-skia/unstable-wgpu-29] unstable-wgpu-30 [i-slint-renderer-skia/unstable-wgpu-30]含义说明aa-06/aa-05选择 android-activity 的 0.6 / 0.5 版本后者已标记为Deprecated两者互斥并分别配对ndk0.9 / 0.8。在slintcrate 侧backend-android-activity-06特性默认组合了native-activityaa-06见 api/rs/slint/Cargo.toml。native-activity/game-activity选择 Activity 的两种承载方式。native-activity使用传统的NativeActivitygame-activity则接入 Android 的 GameActivity。两者会显著影响输入法与软键盘的实现路径——在native-activity下软键盘的显示/隐藏无法走 android-activity 自带 API后端改用 JNI 手动调用 Java 侧的show_keyboard/hide_keyboard见 javahelper.rs。unstable-wgpu-29/unstable-wgpu-30将 Skia 渲染器切换到对应的 wgpu 版本后端。默认不带这两个特性时使用 OpenGL 渲染路径从源码看AndroidWindowAdapter::new会根据特性选择SkiaRenderer::default或default_wgpu_29/30见 androidwindowadapter.rs。另外slint::android模块还暴露了set_requested_graphics_api函数实现见 lib.rs用于在slint::android::init()之后请求特定的图形 API若在 init 之前调用会返回错误提示。六、事件循环与动画帧驱动原理Android 上的事件循环由run_event_loop承担lib.rs其核心是一个loopapp.poll_events(timeout, ...)结构计算下一次定时器更新的超时时间查询窗口是否有活跃动画若有则把 vsync 驱动置于「动画模式」若 vsync 线程尚未就绪或不可用则回退为周期性唤醒10ms 兜底保证动画不会停滞若存在request_redraw()产生的待重绘标记则把超时置为 0 以立即唤醒poll_events回调中依次执行update_timers_and_animations、process_event处理窗口事件、调用可选的事件监听器若事件处理返回Break则退出循环否则在有待重绘标记时执行do_render()。vsync 驱动Choreographer 的接入动画节奏不依赖固定轮询而是跟随屏幕刷新率。vsync.rs的模块注释vsync.rs解释了其设计动机Choreographer 的回调经由它获取时所在的ALooper派发而 android-activity 的poll_events会把ALOOPER_POLL_CALLBACK当作伪错误日志。为避免污染主循环后端专门起一个独立辅助线程在线程自己的 looper 上获取 Choreographer每帧 vsync 到达后用AndroidAppWaker唤醒主事件循环主循环随后推进动画并渲染。由于ndkcrate 未封装 Choreographervsync.rs直接通过 FFI 声明了AChoreographer_getInstance与AChoreographer_postFrameCallbackvsync.rs。Choreographer 自 API 24 引入而 Slint 的 Android 最低版本要求是 API 26因此这些符号总是可用。辅助线程还通过条件变量与主线程协作动画开启时逐帧唤醒动画停止后挂起退出时通过looper.wake()打断可能阻塞的 poll 以正常收尾。七、输入事件处理触摸、按键与输入法所有输入事件在AndroidWindowAdapter::process_inputs中处理androidwindowadapter.rs它从app.input_events_iter()迭代读取事件并翻译为 Slint 的WindowEvent。触摸与鼠标MotionAction::Down/Up/Move等被映射为 Slint 的Touch内部事件TouchPhase::Started/Ended/Moved支持多点触控PointerDown/PointerUp处理第二根手指ButtonPress/ButtonRelease被映射为PointerPressed/PointerReleased特别值得注意的细节在判断鼠标按键时源码刻意不使用action_button()API而是基于button_state()与上一次状态的异或来推算被切换的按键androidwindowadapter.rs因为前者依赖 NDK 33Android 13后者可运行在 Android 12 及更低版本上。按键与返回键map_key_code维护了一张完整的 AndroidKeycode→ Slint 键映射表androidwindowadapter.rs支持字母、数字、方向键、回车、退格、Shift/Ctrl/Alt/Meta、F1-F12 乃至数字小键盘等。Back键被映射为Key::Back。在 API 34 上返回事件改由OnBackInvokedDispatcher分发Java 侧注册回调后调用SlintAndroidJavaHelper.onBackInvoked()见 SlintAndroidJavaHelper.javaRust 侧先把它作为Key.Back的按下/释放事件对派发给 Slintjavahelper.rs若 Slint 未处理则回退到Activity.finish()保留「返回键关闭 Activity」的传统行为。输入法IME与文本编辑文本输入是 Android 后端最复杂的部分之一涉及 Rust 与 Java 的双向数据流Rust → Javaset_imm_data把文本内容、光标/锚点位置UTF-16 偏移、preedit 区间、光标矩形、输入类型标志等同步给 Java 侧其中InputTypeText/Search/Password/Number/Decimal会进一步细化为android.text.InputType的各类标志位包括首字母大写模式、自动纠错、自动补全javahelper.rs。Java → RustSlintInputView是一个自定义View通过BaseInputConnection与系统 IME 对接用户输入变化时回调updateText原生方法SlintAndroidJavaHelper.javaRust 侧再把它还原成UpdateComposition/CommitComposition内部键事件交给 Slintjavahelper.rs。此外Java 侧还实现了文本选择光标手柄InputHandle基于PopupWindow 系统textSelectHandle*主题资源与浮动操作菜单剪切/复制/粘贴/全选见 SlintAndroidJavaHelper.java。Rust 侧的长按检测由LongPressDetection计时器完成按下时启动long_press_timeout取自系统ViewConfiguration.getLongPressTimeout默认约 500ms见 lib.rs超时且手指位移不超过阈值10 逻辑像素时选中单词并弹出操作菜单androidwindowadapter.rs。八、系统集成能力深色模式、字体缩放、剪贴板与安全区该后端在bind_contextlib.rs中完成一系列与系统设置相关的初始化深色模式读取系统uiModeUI_MODE_NIGHT_NO0x10 /UI_MODE_NIGHT_YES0x20映射为 Slint 的ColorScheme::Light/Dark/Unknown并通过ctx.set_color_scheme生效当系统配置变化时Java 侧onConfigurationChanged回调setNightModeSlintAndroidJavaHelper.javaRust 侧同样更新配色方案并刷新 accent 色javahelper.rs。强调色accent color通过解析主题中的android.R.attr.colorAccent获取并设置为 Slint 的强调色SlintAndroidJavaHelper.java。系统字体缩放读取Configuration.fontScale乘以 Material Design 正文基准字号 14LP 得到默认字体大小font_scale_to_logical_lengthjavahelper.rs并通过set_platform_default_font_size应用系统字体缩放变化时也会动态更新且会跳过 0.0 或 NaN 等异常值以免覆盖已设置的正确值。剪贴板set_clipboard_text/clipboard_text通过 JNI 调用 Java 侧ClipboardManager实现SlintAndroidJavaHelper.java其中读取剪贴板时用FutureTask在 UI 线程执行并同步等待结果。安全区与虚拟键盘Java 侧在 API 30 使用WindowInsets精确计算状态栏、刘海屏与 IME 键盘的 insets在低版本则退化为getWindowVisibleDisplayFrame近似估算SlintAndroidJavaHelper.java。这些 insets 通过setInsets原生回调传回 Rustjavahelper.rs最终由update_window_insets计算虚拟键盘遮挡矩形并设置到 Slint 窗口androidwindowadapter.rs。非全屏模式下safe_area_inset也会让 Slint 的 safe-area 机制生效androidwindowadapter.rs。九、常见问题与注意事项必须使用精确版本锁定由于该 crate 不遵循 semver任何直接依赖都应写version x.y.z升级时需关注破坏性变更。#[unsafe(no_mangle)]不可省略android_main符号必须按名称导出否则系统无法找到应用入口见 android.rs。init()的调用时机slint::android::init必须在任何需要后端的 Slint API 之前调用set_requested_graphics_api同理必须在 init 之后使用。最低系统版本从 vsync 实现注释vsync.rs可以确认Slint 的 Android 最低要求为 API 26NDK 版本选择0.8/0.9与 android-activity 版本0.5/0.6通过特性绑定aa-05已弃用新项目应使用backend-android-activity-06。渲染后端选择默认使用 Skia OpenGL 路径如需 wgpu需启用unstable-wgpu-29/unstable-wgpu-30特性两者互斥。十、相关源码索引后端 README本主题核心文档internal/backends/android-activity/README.md平台入口与事件循环internal/backends/android-activity/lib.rs窗口适配器与输入处理internal/backends/android-activity/androidwindowadapter.rsJNI 桥接与 dex 加载internal/backends/android-activity/javahelper.rsvsync 帧驱动internal/backends/android-activity/vsync.rsJava 辅助类internal/backends/android-activity/java/SlintAndroidJavaHelper.java特性定义与依赖internal/backends/android-activity/Cargo.toml公开 APIslint::android模块api/rs/slint/android.rsslintcrate 特性组合api/rs/slint/Cargo.toml【免费下载链接】slintSlint is an open-source declarative GUI toolkit to build native user interfaces for Rust, C, JavaScript, or Python apps.项目地址: https://gitcode.com/GitHub_Trending/sl/slint创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
