【CXX-Qt】0 Rust与Qt集成实践指南(CXX-Qt)

CXX-Qt 是一个用于在 Rust 和 Qt 之间实现安全互操作的库。与通常的 Rust Qt 绑定不同，它提供了一种不同的方式来桥接 Qt 代码和 Rust 代码。CXX-Qt 认识到 Qt 和 Rust 代码具有不同的习惯，因此不能直接从一个语言包装到另一个语言。相反，它使用 CXX 作为桥接工具，允许正常的 Qt 代码和正常的 Rust 代码之间进行互操作。这种方法被认为比典型的绑定更强大，因为它能够提供一个安全的 API 以及 Qt 和 Rust 之间安全的多线程支持。

一、CXX-Qt 的核心概念概述

1. 安全机制：CXX-Qt 通过 CXX 实现了一种安全的机制，使得 Rust 和 Qt 可以在保持各自代码风格的同时进行互操作。
2. 多线程支持：库提供了在 Qt 和 Rust 之间进行安全多线程操作的能力。
3. 常见 Qt 类型：为了辅助 Qt 和 Rust 代码的集成，CXX-Qt 为 Rust 提供了常见的 Qt 类型，这些类型可以在桥接过程中传递，并允许表达常见的 Qt 惯用法。
4. 宏和代码生成：开发者使用 CXX-Qt 提供的宏注解来描述一个 QObject。然后 CXX-Qt 会生成这个对象的 C++ 表示，并使用宏扩展来定义 CXX 桥，以实现 C++ 和 Rust 之间的互操作。

二、如何开始

如果你是 CXX-Qt 的新用户，推荐你访问“Getting Started”指南。这个指南将帮助你快速上手并理解如何使用 CXX-Qt 来桥接你的 Rust 和 Qt 代码。

三、更多信息

• 可用功能：要获取关于 CXX-Qt 中可用功能的详细信息，请参阅“bridge”章节。
• 深入概念：如果你对 CXX-Qt 的概念感兴趣，想要更深入地了解，可以查看“concepts”章节，该章节详细解释了 CXX-Qt 引入的概念。
• CXX-Qt 的开源代码地址：https://github.com/KDAB/cxx-qt/
• CXX-Qt 的帮助文档：https://kdab.github.io/cxx-qt/book/index.html

四、注意事项

• CXX-Qt 在 Linux、Windows 和 macOS（均为 x86_64）上的持续集成（CI）环境中进行了测试。
• wasm32 版本已编译，但尚未在 CI 环境中进行测试。
• CXX-Qt 应该可以在 Qt 和 Rust 都支持的其他平台上工作，但这些平台没有被定期测试。
  通过使用 CXX-Qt，可以在保持 Qt 和 Rust 各自优势的同时，实现两者之间的无缝互操作。