Rust Constructor V2

A cross-platform GUI framework built on egui, the simplest way to develop GUI projects in Rust

English | 简体中文

Rust Constructor is an open-source project, but is not directly affiliated with the egui development team!

Table of Contents

• Version Update Information
• Introduction
• Quick Start
• Purpose of Creating Rust Constructor
• Frequently Asked Questions
• License
• Conclusion

Version Update Information

• The current latest version is v2.3.0 Compatibility Update. Major updates include:
  • Removed a large number of useless functions outside of App.
  • Added FrontResource trait for managing basic front-end resources.
  • Added Config class structures for quickly customizing front-end resources.
  • Image added multiple fields: background_color for managing background color displayed behind the image, rotate_angle for managing image rotation angle (clockwise, used with std::f32::consts::PI, does not change other resource detection input range), rotate_center controls the image rotation center point (position determined by the ratio of input values to image dimensions).
  • Removed Text's write_background field.
  • Major refactor of SwitchData.
  • Some fields in Switch have been renamed: switch_image_name -> fill_resource_name, enable_hover_click_image -> enable_hover_click_fill_resource.
  • Removed Switch's sound_path field and related functionality.
  • RustConstructorError added two new error types: SwitchFillResourceMismatch and CustomError.
  • Removed Config and AppText and their related fields.
  • Added strict_mode field in App.
  • Fixed the issue where CustomRect's position would not update with center_display.
  • Major refactor of Switch, now multiple resources can be used to fill the Switch main part (Image or CustomRect).
  • The close button of MessageBox now also supports filling with multiple resources.

Introduction

• Rust Constructor is a Rust GUI development library built on egui, including common features such as timers, resource storage, and error handling.
• Rust Constructor released its first version in 2025.2, and today's Rust Constructor has undergone earth-shattering changes compared to that time.

Quick Start

• To introduce Rust Constructor, please add rust_constructor = "x.y.z" (please replace xyz as needed) to your toml.
• If you want to start App and perform some simple operations, it is recommended to refer to the official egui documentation.
• Due to the large content and complex operations of Rust Constructor, it is inconvenient to fully describe here. You can refer to the official tutorial of Rust Constructor Rust Constructor Guide.

Purpose of Creating Rust Constructor

We encountered some problems that egui could not solve during the development of Targeted Vector, so we expanded many tools. To enable more people to develop conveniently, we created Rust Constructor.

Frequently Asked Questions

• Q1: Which platforms does Rust Constructor support?

• A1: macOS and Windows are confirmed to be fully supported, other platforms depend on egui support.

• Q2: What are the differences between Rust Constructor V2 and V1?

• A2: The original architecture was modified to conform to the crate structure, published on crates.io, and added an official guide.

• Q3: Why do I get errors when calling resources?

• A3: Please ensure you have added the resources through the add method and there are no spelling errors.

• Q4: How to modify resources?

• A4: You can retrieve resources via get_resource_mut.

• Q5: What should I do if I encounter unknown error messages?

• A5: First check the RustConstructorError definition in the Rust Constructor source code, find the problem you triggered and fix it.

• Q6: Why is only V2 of Rust Constructor on crates.io?

• A6: Rust Constructor V0 and Rust Constructor V1 were essentially bloated projects with many redundant features and meaningless code, so they were not published.

License

MIT © 2025 ChepleBob

Conclusion

If you like this project, please give me a star on GitHub. You can also join our organization Binder.