【CXX-Qt】1.1 Rust中的QObjects

news2025/2/12 15:08:23

本文涉及到了使用CXX-Qt将Rust、C++和QML集成到Qt应用程序中的各个方面。下面，我将提供一个简单的示例，演示如何使用CXX-Qt来创建一个Rust结构体并将其作为QObject子类暴露给C++和QML。

一、设置CXX-Qt环境

首先，确保您已经安装了Rust、CXX和CXX-Qt。您可以在CXX和CXX-Qt的官方文档中找到安装指南。

二、创建Rust项目

创建一个新的Cargo项目：
cargo new my_qt_app --lib
cd my_qt_app
在Cargo.toml中添加CXX和CXX-Qt依赖：
[dependencies]
cxx = “1” # 确保使用最新版本
cxx-qt = “0.7” # 假设这是当前版本，实际使用时请检查最新版本
创建必要的桥接代码。在src目录下创建一个名为bridge.rs的文件，并添加以下内容：
use cxx_qt::prelude:😗;
use cxx::cxxbridge;
// 定义一个Rust结构体
#[derive(Default)]
pub struct MyRustStruct {
pub value: i32,
}
// 使用CXX-Qt宏来桥接Rust结构体到QObject
#[cxx_qt::bridge]
mod ffi {
unsafe extern “C++” {
include!(“qt_includes.h”); // 包含Qt头文件，如#include
type MyRustStructWrapper; // 声明一个QObject子类包装Rust结构体
fn new_my_rust_struct_wrapper() -> UniquePtr;
fn get_value(&self) -> i32;
fn set_value(&mut self, value: i32);
}
}
// 实现QObject子类的方法
impl MyRustStruct {
#[qinvocable]
fn get_value(&self) -> i32 {
self.value
}
#[qinvocable]
fn set_value(&mut self, value: i32) {
self.value = value;
}
}
// 定义QObject子类
#[derive(QObject, Default)]
#[qclass(name = “MyRustStructWrapper”)]
struct MyRustStructWrapper {
#[qproperty]
rust_struct: MyRustStruct,
}
#[cxx_qt::bridge(impl)]
impl ffi::MyRustStructWrapper {
unsafe fn new_my_rust_struct_wrapper() -> UniquePtr {
UniquePtr::new(Self::default())
}
fn get_value(&self) -> i32 {
self.rust_struct.get_value()
}
fn set_value(&mut self, value: i32) {
self.rust_struct.set_value(value);
}
}
创建一个名为qt_includes.h的头文件，并添加必要的Qt头文件：
#pragma once
#include
#include

三、创建C++代码

在项目的根目录下创建一个名为cpp的目录，并在其中创建一个名为main.cpp的文件：
#include
#include
#include
#include “bridge.h” // CXX-Qt生成的桥接头文件
int main(int argc, char *argv[]) {
QGuiApplication app(argc, argv);
// 创建Rust结构体包装器实例
auto my_rust_struct_wrapper = ffi::new_my_rust_struct_wrapper();
qDebug() << “Initial value:” << my_rust_struct_wrapper->get_value();
// 修改值
my_rust_struct_wrapper->set_value(42);
qDebug() << “Updated value:” << my_rust_struct_wrapper->get_value();
// 设置QML环境（这里省略了具体的QML文件加载，仅作为示例）
QQmlApplicationEngine engine;
// engine.load(QUrl(QStringLiteral(“qrc:/main.qml”)));
return app.exec();
}

四、构建和运行

在Cargo.toml中添加构建脚本以生成CXX和CXX-Qt所需的桥接代码：
[build-dependencies]
cc = “1.0”
[package.metadata.cxx-bridge.main]
rust-source = “src/bridge.rs”
创建一个名为build.rs的构建脚本，内容如下：
fn main() {
cxx_build::bridge(“src/bridge.rs”)
.emit_cpp(true)
.compile(“cxx_qt_bridge”);
}
使用Cargo构建项目：
cargo build --release
编译生成的C++代码并链接到Qt应用程序（这通常涉及到配置CMake或其他构建系统，具体步骤取决于您的项目设置）。