
前端UI组件3D渲染跨平台游戏开发【免费下载链接】makepadMakepad is a creative software development platform for Rust that compiles to wasm/webGL, osx/metal, windows/dx11 linux/opengl项目地址https://gitcode.com/gh_mirrors/ma/makepad点击查看免费下载导读makepad-android-statecrate 名为makepad-android-state是 Makepad 项目中一个体量极小但职责关键的基础库它持有 Makepad 在 Android 平台上运行所需的两个进程级上下文状态——由 JNI 层初始化的JavaVM实例以及当前存活的 MakepadActivity实例。本文以该库的 README 为主线结合仓库内 lib.rs 源码与 Android 平台层、语音系统等真实调用方完整讲解其设计动机、公开 API、内部安全机制以及如何在第三方 crate 中安全获取 JNI 环境与 Activity 句柄。读完本文你将掌握在 Android 端通过 JNI 与 Java 层交互的正确姿势并理解 Makepad 框架为何对这两处全局状态做如此严格的访问控制。一、这个库为什么存在避免为取一个状态而依赖整个 MakepadMakepad 是一个可以编译到 wasm/webGL、macOS/Metal、Windows/DX11、Linux/OpenGL 等后端的大型 GUI 框架其主 crate 体积庞大。而在 Android 平台上任何需要与 Java 层例如SpeechRecognizer、TextToSpeech、OpenXR 会话交互的 Rust 代码都绕不开两个全局句柄进程唯一的JavaVM *JVM 实例指针当前正在运行的Activity的jobject句柄。如果把这些状态直接放在 Makepad 主 crate 里那么任何只想拿个 Activity 句柄的外部 crate 都必须把整个 Makepad 拉进依赖树。makepad-android-state正是为此拆出的独立薄层——从 Cargo.toml 可以看到它仅依赖makepad-jni-sys 0.4.0一个 crate自身不含任何 UI、渲染或事件循环代码。README 的原话概括了其全部价值It exists solely to allow external crates to access those Android states without depending on the entirety of Makepad.它存在的唯一目的就是让外部 crate 无需依赖整个 Makepad 即可访问这些 Android 状态。二、两个核心状态及其生命周期差异README 明确指出该库持有且仅持有两个状态它们有着截然不同的生命周期语义这也是访问控制策略设计的根源。1.JavaVM实例进程一生只初始化一次JavaVM由 JNI 层在进程启动时初始化Android 系统加载 JNI 库时触发JNI_OnLoad在整个应用进程生命周期内只存在一个实例且只被设置一次。不可由外部代码设置README 强调 This cannot be set by foreign code outside this crate。原因是它只会被设置一次任何外部重复写入都意味着逻辑错误因此该写路径被完全封死只有 crate 内部实际是 JNI 入口可以写入。从源码看lib.rs 用static mut VM: *mut jni_sys::JavaVM保存该指针写入发生在两个标有#[no_mangle]的 JNI 入口函数中JNI_OnLoad标准 JNI 导出函数Android 加载.so时自动调用将传入的JavaVM*存入VM并返回JNI_VERSION_1_6作为兼容版本声明lib.rsjni_on_load另一个 C 导出入口同样将vm写入全局VMlib.rs。2.Activity实例可被系统反复销毁重建与JavaVM不同Android 平台可能在一个应用进程的生命周期内多次拆除并重建 Activity 实例——典型的触发场景包括设备旋转、进入分屏模式、窗口 resize、应用被移到后台后重建等。因此Activity 句柄是可变的外部代码在需要时必须重新获取绝不能缓存复用它可以由外部代码设置Thiscanbe set by foreign code outside this crate因为框架需要在 Activity 每次重建后把新句柄写进来但出于安全考虑只允许单个调用方拿到私有的 setter 函数——这正是下面要讲的get_activity_setter_fn()机制。三、对外公开 API外部用户只需要两个函数README 明确划定了外部用户的接触面外部用户只应关心两个函数其余函数均为 Makepad 内部专用对外部用户没有用处。get_java_vm()获取 JavaVM 指针pub fn get_java_vm() - *mut jni_sys::JavaVM返回 JNI 层初始化好的JavaVM实例指针通过它可以获取 JNI 环境JNIEnv进而调用 Java 方法、创建对象、访问类等。若JavaVM尚未初始化返回空指针null pointer。实现为#[inline(always)]代价为零——本质上就是读一个static mutlib.rs。get_activity()获取当前 Makepad Activity 句柄pub fn get_activity() - jni_sys::jobject返回当前 MakepadActivity实例的jobject句柄全局引用。若 Activity 尚未初始化返回空指针。源码文档特别提醒调用方lib.rs不要缓存或复用返回的 Activity 指针而应在每次需要时重新调用本函数。因为 Activity 实例可能因系统动作旋转、分屏、resize、移动等在后台被销毁并重建。需要说明的是get_java_vm()返回的*mut JavaVM与get_activity()返回的jobject都是原始指针调用方需要自行保证其在 JNI 调用边界内的有效性。这两个函数只负责读取全局状态不负责保护——保护责任由设置端的单次授权机制承担。四、内部机制为什么 Activity 的 setter 只能被领取一次README 中最精妙的设计在于对 Activity 写路径的管控。源码用一个MutexOptionunsafe fn(jobject)包装了内部set_activity函数static SET_ACTIVITY_FN: MutexOptionunsafe fn(jni_sys::jobject) { unsafe fn set_activity(activity: jni_sys::jobject) { ACTIVITY activity; } std::sync::Mutex::new(Some(set_activity)) };对外的领取函数是get_activity_setter_fn()标注#[doc(hidden)]即文档中其他函数为 Makepad 内部专用所指的成员pub fn get_activity_setter_fn() - Optionunsafe fn(jni_sys::jobject) { SET_ACTIVITY_FN.lock().unwrap().take() }其核心语义是只会返回Some一次第一次调用时Option::take()从Mutex中取出并移除该函数返回Some(set_activity)之后所有调用都返回None。这就从类型系统层面保证了只有唯一一个调用方即 Makepad 内部框架的 Android 平台层能获得设置 Activity 的能力外部 crate 即使调用该函数也无法覆盖 Activity 状态。README 的原话for safety reasons, we only permit a single caller to obtain the private set_activity function, which ensures that only the internal Makepad framework can set the activity instance.在 android_jni.rs 中可以清晰看到这条领取—注册—调用链路pub fn jni_set_activity(activity_handle: jni_sys::jobject) { unsafe { // 第一次也是唯一一次领取 setter if let Some(func) makepad_android_state::get_activity_setter_fn() { SET_ACTIVITY_FN func; // 存入本模块的静态变量 } SET_ACTIVITY_FN(activity_handle); // 立即写入新 Activity } } pub fn jni_update_activity(activity_handle: jni_sys::jobject) { unsafe { SET_ACTIVITY_FN(activity_handle) }; // Activity 重建后持续更新 }jni_set_activity负责在首次拿到句柄时领取 setter 并写入jni_update_activity则在 Activity 每次重建后反复调用同一 setter 更新全局句柄。配合fetch_activity_handleandroid_jni.rs通过NewGlobalRef将 Java 侧传入的 Activity 转为 JNI 全局引用构成了完整的Java 层 Activity 变化 → Rust 全局状态更新回路。五、仓库内的真实调用场景理解设计后看两个真实调用方可以更直观地体会这套 API 的用法与价值。场景 AMakepad Android 平台层——OpenXR 实例创建在 android.rs 中Makepad 的 Android 平台在尝试创建 OpenXR 会话前直接调用let activity_handle makepad_android_state::get_activity(); match self.os.openxr.create_instance(activity_handle) { ... }OpenXR 的XrInstanceCreateInfoAndroidKHR需要传入 AndroidActivity句柄作为applicationVM/applicationActivity参数。这里get_activity()成为 Makepad 自身从保存状态的库读取最新 Activity 的入口且每次会话创建前都会重新读取正好呼应不要缓存 Activity 指针的告诫。场景 Bsystem_speech库——通过get_java_vm附加 JNI 线程libs/system_speech/src/platform/android.rs 是仓库中外部 crate 使用本库的典型范例。它通过use makepad_android_state::{get_activity, get_java_vm}引入两个公开函数并据此搭建完整的 JNI 胶水层线程附加Rust 创建的工作线程对 JVM 而言是未知线程必须先附加才能调用 JNI。attach_env通过get_java_vm()拿到JavaVM指针再调用AttachCurrentThread获取本线程的JNIEnvandroid.rs。这正是 README 所说through which you can obtain the JNI environment的落地实现。Activity 方法解析activity_method通过get_activity()拿到当前 Activity 句柄用GetObjectClass获取其类再以GetMethodID解析目标 Java 方法如SpeechRecognizer、TextToSpeech相关方法android.rs。因为 natively attached 线程只有系统类加载器FindClass看不到应用类而GetObjectClass(activity)永远可行——这是 Android JNI 场景下绕开类加载问题的标准手法。system_speech只依赖makepad-android-state一个极小的 crate 便完整获得了 JNI 环境与 Activity 访问能力恰恰验证了本库解耦大框架、服务外部 crate的设计初衷。六、依赖策略与注意事项刻意规避 path 依赖Cargo.toml 中有一段值得注意的注释Note: we must not use local path dependencies onmakepad-jni-sysin order to guarantee that only one instance of each crate exists in the app binary.即对makepad-jni-sys刻意不使用本地 path 依赖而是使用 crates.io 版本依赖0.4.0。原因是JavaVM、Activity等 JNI 类型以原始指针形式跨 crate 传递若makepad-jni-sys在依赖图中出现多个实例path 依赖与版本依赖可能被去重逻辑拆成两份类型与 ABI 就可能在编译期产生不一致导致指针语义出错。保证二进制中每种 crate 只有一份是这套全局原始指针方案能够成立的前提。使用建议优先选用robius-android-envREADME 在 Usage 一节给出了一条重要的实践建议you probably want to use therobius-android-envcrate instead of using this crate directly, or an even higher-level crate that depends onrobius-android-env.也就是说普通外部项目应优先使用基于本库封装的更高级 craterobius-android-env或依赖它的更高层 crate把 JNI 环境的获取、线程附加、Activity 生命周期管理等样板逻辑交给成熟封装只有当你的需求足够底层例如自定义 JNI 胶水、极简依赖树时才直接使用本文介绍的两个函数。使用时的三点提醒判空不可省略get_java_vm()与get_activity()在对应状态未初始化时会返回空指针源码注释 If not initialized, returns a null pointer调用方必须先判空再解引用例如system_speech中if vm.is_null() { return None; }android.rs。Activity 不缓存、随手取Activity 会因旋转、分屏、resize 等系统动作销毁重建务必在每次需要时重新调用get_activity()。写入路径不可外部调用get_activity_setter_fn()及JNI_OnLoad/jni_on_load均为#[doc(hidden)]/#[no_mangle]内部机制外部代码只读不写。七、总结makepad-android-state用不到 100 行代码解决了一个在 Android Rust 混合开发中极易被搞错的问题——进程级 JNI 全局状态JavaVM与Activity如何被安全地持有与共享。其设计要点可归结为三条拆分薄层隔离大框架外部 crate 零成本接入、读路径全开放get_java_vm/get_activity随时取用、写路径单次授权Option::take()保证仅框架内部可设置 Activity。理解这套机制对任何需要在 Makepad Android 应用中接入原生 Java 能力语音识别、TTS、OpenXR、相机、推送等的开发者都具有直接的参考价值——它既是 Makepad 平台的 JNI 基础设施也是 Rust 侧安全暴露 Android 上下文的可复用范例。赞分享前端UI组件3D渲染跨平台游戏开发【免费下载链接】makepadMakepad is a creative software development platform for Rust that compiles to wasm/webGL, osx/metal, windows/dx11 linux/opengl项目地址https://gitcode.com/gh_mirrors/ma/makepad点击查看免费下载相关推荐终极Windows系统优化神器WinUtil一键解决所有Windows管理难题终极Windows系统优化神器WinUtil一键解决所有Windows管理难题 还在为Windows系统卡顿、臃肿、难管理而烦恼吗Chris Titus T桌面应用运维Jetpack Compose 状态管理实战深入理解 remember 与 State 的重组机制Jetpack Compose 状态管理实战深入理解 remember 与 State 的重组机制 本篇指南聚焦 Android 学习路线图中的 rememb文档教程知识库Makepad 按钮控件Button完整指南属性、样式与状态机制详解Makepad 按钮控件Button完整指南属性、样式与状态机制详解 本篇技术指南以 examples/uizoo/resources/button.md前端UI组件3D渲染跨平台游戏开发上一篇3分钟免费安装VideoDownloadHelper简单视频下载插件终极指南下一篇终极SPT-AKI存档编辑器5步掌握离线塔科夫角色修改技巧创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考