【rust/egui】(一)从编译运行template开始

                    
                        
                    
                    说在前面 
 
 rust新手，egui没啥找到啥教程，这里自己记录下学习过程
环境：windows11 22H2
rust版本：rustc 1.71.1
egui版本：0.22.0
eframe版本：0.22.0
rust windows安装参考：这里
本文默认读者已安装相关环境(git、vscode等)
 
 
关于egui 
egui github
demo online
 
 
关于immediate mode
 wikipedia
 microsoft learn
 
开始吧 
先clone下这个项目(也可以使用github提供的Use this template功能)，这是官方说明中的一个template。git clone https://github.com/emilk/eframe_template.git
 
删除项目中的toolchain文件
 
编译运行（cargo换源见安装参考）PS E:\eframe_template-master> cargo run 
    Updating `rsproxy` index
remote: Counting objects: 32254, done.
remote: Compressing objects: 100% (14081/14081), done.
remote: Total 32254 (delta 23946), reused 25317 (delta 17601)
Receiving objects: 100% (32254/32254), 7.70 MiB | 7.47 MiB/s, done.
Resolving deltas: 100% (23946/23946), completed with 2726 local objects.
From https://rsproxy.cn/crates.io-index
 + 69b92ab647...84fdefbd80 HEAD       -> origin/HEAD  (forced update)
  Downloaded ...
  Downloaded 21 crates (14.4 MB) in 12.60s (largest was `windows` at 11.9 MB)
   Compiling ...
   Compiling egui-winit v0.22.0
   Compiling eframe v0.22.0
   Compiling eframe_template v0.1.0 (E:\Workspace\eframe_template-master)
    Finished dev [unoptimized + debuginfo] target(s) in 1m 12s
     Running `target\debug\eframe_template.exe`
 可以看到我们的应用窗口打开了
 
 
小小的尝试 
根据readme中的内容，我们可以修改下工程的名字，现在我们的应用名称是eframe template，我们将它改成demo app
修改Cargo.toml[package] 
name = "demo_app" // 修改这里
version = "0.1.0"
authors = ["o0olele <o0o@lele.com>"] // 修改这里
edition = "2021"
rust-version = "1.71" // 这里可以替换成我们使用的rust版本
 
修改src/main.rs#![warn(clippy::all, rust_2018_idioms)]
#![cfg_attr(not(debug_assertions), windows_subsystem = "windows")] // hide console window on Windows in release

// When compiling natively:
#[cfg(not(target_arch = "wasm32"))]
fn main() -> eframe::Result<()> {
    env_logger::init(); // Log to stderr (if you run with `RUST_LOG=debug`).

    let native_options = eframe::NativeOptions::default();
    eframe::run_native(
        "demo app", // `eframe template` to `demo app`
        native_options,
        Box::new(|cc| Box::new(demo_app::TemplateApp::new(cc))), 
        // `eframe_template::TemplateApp` to `demo_app::TemplateApp`
    )
}

// When compiling to web using trunk:
#[cfg(target_arch = "wasm32")]
fn main() {
    // Redirect `log` message to `console.log` and friends:
    eframe::WebLogger::init(log::LevelFilter::Debug).ok();

    let web_options = eframe::WebOptions::default();

    wasm_bindgen_futures::spawn_local(async {
        eframe::WebRunner::new()
            .start(
                "the_canvas_id", // hardcode it
                web_options,
                Box::new(|cc| Box::new(demo_app::TemplateApp::new(cc))), 
                // `eframe_template::TemplateApp` to `demo_app::TemplateApp`
            )
            .await
            .expect("failed to start eframe");
    });
}
 
再次cargo run，可以看到我们的应用名称已经变成了demo app
 
readme中的另外两个修改是web 应用构建相关的，后面再说
 
尝试下web 
添加wasm相关资源set $RUSTUP_DIST_SERVER=https://mirrors.tuna.tsinghua.edu.cn/rustup; rustup target add wasm32-unknown-unknown 
 
安装trunk(真tm吃cpu)cargo install --locked trunk
 
开启trunk server(真tm吃cpu)trunk serve
 
浏览器打开http://127.0.0.1:8080
 
可以看到我们的应用名称还是eframe_template，这个时候我们可以进行一些修改
修改index.html...
<title>demo app</title>
...
 
修改assets/sw.jsvar cacheName = 'egui-template-pwa';
var filesToCache = [
  './',
  './index.html',
  './demo_app.js',
  './demo_app_bg.wasm',
];

/* Start the service worker and cache all of the app's content */
self.addEventListener('install', function (e) {
  e.waitUntil(
    caches.open(cacheName).then(function (cache) {
      return cache.addAll(filesToCache);
    })
  );
});

/* Serve cached content when offline */
self.addEventListener('fetch', function (e) {
  e.respondWith(
    caches.match(e.request).then(function (response) {
      return response || fetch(e.request);
    })
  );
});
 
 
一些相关数据 
该桌面应用内存占用(cargo run --release)，有点高啊
 
可执行程序大小(.eframe_template-master\target\release目录下)
 

                