【rust/egui】(二)看看template的main函数：日志输出以及eframe run_native

说在前面

• rust新手，egui没啥找到啥教程，这里自己记录下学习过程
• 环境：windows11 22H2
• rust版本：rustc 1.71.1
• egui版本：0.22.0
• eframe版本：0.22.0
• 上一篇：这里

开始

• 首先让我们看看main.rs中有些什么

  #![warn(clippy::all, rust_2018_idioms)]
  #![cfg_attr(not(debug_assertions), windows_subsystem = "windows")] 
  // 在release模式中隐藏控制台窗口(实际上我怎么试也没找到这个窗口) 本文放弃关注
  
  // 非wasm架构
  #[cfg(not(target_arch = "wasm32"))]
  fn main() -> eframe::Result<()> {
      env_logger::init(); // 初始化log参数，debug模式下仅会打印error日志
  
      let native_options = eframe::NativeOptions::default(); // 初始化eframe默认参数
      eframe::run_native(
          "demo app",
          native_options,
          Box::new(|cc| Box::new(demo_app::TemplateApp::new(cc))),
      )
      // 启动eframe
  }
  
  // When compiling to web using trunk:
  #[cfg(target_arch = "wasm32")]
  // ... 本文暂不关注wasm相关内容
  

日志输出

• 在eframe中使用的日志库为log以及env_logger，其日志等级有5个：

  pub enum Level {
      Error,
      Warn,
      Info,
      Debug,
      Trace,
  }
  

• 我们可以在main函数中添加测试一下：

  fn main() -> eframe::Result<()> {
      env_logger::init(); 
      // Log to stderr (if you run with `RUST_LOG=debug`).
  
      log::info!("1");
      log::warn!("2");
      log::error!("3");
      log::trace!("4");
      log::debug!("5");
  
      // ...
  }
  

• 执行cargo run，只能看到error输出；使用cargo run --release的话什么日志都没有了

  [2023-08-13T09:20:59Z ERROR demo_app] 3
  

• env_logger可以指定日志输出的级别以及目标，当我们在cmd下执行（注意powershell的设置环境变量的语法不一样）：

  set RUST_LOG=demo_app
  cargo run
  

  这会将我们的项目(demo_app)下所有的级别的log进行输出，现在我们能看到所有级别的日志了

  [2023-08-13T09:27:18Z INFO  demo_app] 1
  [2023-08-13T09:27:18Z WARN  demo_app] 2
  [2023-08-13T09:27:18Z ERROR demo_app] 3
  [2023-08-13T09:27:18Z TRACE demo_app] 4
  [2023-08-13T09:27:18Z DEBUG demo_app] 5
  

• 现在我们尝试下将eframe的日志都输出：

  set RUST_LOG=eframe
  cargo run
  

  可以看到大量的日志输出：

  [2023-08-13T09:31:29Z DEBUG eframe] Using the glow renderer
  [2023-08-13T09:31:29Z DEBUG eframe::native::run] Entering the winit event loop (run_return)…
  

eframe初始化参数

• 在main函数中调用eframe::run_native()时使用到了一个native_options，让我们看看这里面有些什么：

  always_on_top: bool
  Sets whether or not the window will always be on top of other windows at initialization.
  
  maximized: bool
  Show window in maximized mode
  
  decorated: bool
  On desktop: add window decorations (i.e. a frame around your app)? 
  If false it will be difficult to move and resize the app.
  
  fullscreen: bool
  Start in (borderless) fullscreen?
  
  ...
  

• 我们可以试着改几个看看效果

  • always_on_top

    let mut native_options = eframe::NativeOptions::default();
    native_options.always_on_top = true;
    

    
  • decorated

    let mut native_options = eframe::NativeOptions::default();
        native_options.always_on_top = true;
        native_options.decorated = false;
    

    
    毫无灵魂了，甚至和背景融为一体了
  • transparent

    let mut native_options = eframe::NativeOptions::default();
        native_options.transparent = true;
    // 同时注释掉app.rs中 egui::CentralPanel::default() 代码
    

    

• 其他详细参数见这里，大家可以自己试试

eframe::run_native

• 调用该函数创建我们的应用窗口，其定义为：

  pub fn run_native(
      app_name: &str, // 应用名
      native_options: NativeOptions, // 初始化选项
      app_creator: AppCreator // 应用主逻辑
  ) -> Result<()>
  

• app_name
  应用名称，在我们的例子中为demo app；同时该值也是我们的窗口显示的名称，同时也是持久化存储(下一节看看 )目录的名称；
  
  

相关参考

• log
• env_logger
• log无法单独使用