fix(renderer): M97 后端判据 —— 静默降级改具名错误，取证通道拒绝降级出图
M97 的入口是一份 macOS M1 真机报告：探测认出了 Apple M1（adapters=1 /
hardware=true），日志却写着 `renderer = auto (wgpu -> tiny-skia)`，看起来
像在跑 CPU。读源码发现那行是**常量**：`probe.rs` 按 `ICED_BACKEND` 未设就把
`"auto (wgpu -> tiny-skia)"` 打出来，与实际后端无关。真正的失败被 iced 吞掉：
`iced_renderer-0.14.0/src/fallback.rs` 的 `Compositor::with_backend` 把 wgpu 的
错误装进 `errors` 向量，tiny-skia 一成功就整体丢弃。
## 判据改为单项，不再交给 iced 回退
`ICED_BACKEND` 现在**永远是单项**（`wgpu` / `tiny-skia`）：能跑起来就必定是它；
起不来就必然是 `iced::Error::GraphicsCreationFailed` 里的具名错误。判据是纯函数
`renderer::decide(request, probe, gpu_compiled)`，落在 `renderer/decision.rs`，
表驱动测试逐行钉死 1~6 行 + 「除强制 CPU / 未编 wgpu 外必须留兜底」的守门。
判据表（条件 / 选哪个 / 日志该打什么 / 谁能验证）在 `renderer/mod.rs` 顶部。
## 安全网改成换进程
第一版是「打印错误 → 在本进程再 run() 一次」，Windows 实测直接 panic：
`Create event loop: RecreationAttempt`（winit 一个进程只能建一次事件循环）。
改成 `respawn`：子进程只换 `ICED_BACKEND` + `ULL_GPU_FALLBACK`，父进程透传它的
退出码。子进程看到 `ULL_GPU_FALLBACK` 必须跳过探测，否则会无限递归重开。
## 取证通道不许自己降级
带 `--screenshot`（含 `--screen=gallery`）时 wgpu 起不来就**不出图**、退出码 1，
因为换了后端出的图会撒谎；交互启动才允许降级。每张图的日志现在打**实际**后端
（`[shot] … renderer=wgpu`），以前打的是请求值 `auto`——同一个病（在需要结果的
地方打请求）在仓库里出现了两次，这是第二次。
## 可观测性
- `log` 桥（`renderer/log_bridge.rs`）把 `iced_wgpu` 的
`Selected: AdapterInfo{…}` 接到 stderr：这是本仓库第一次能自证「真在用 GPU」。
按 target 分级（`iced_wgpu*` Info、`wgpu*` Warn），否则 Vulkan loader 会刷 90 行噪声。
- `renderer/preflight.rs`（默认关，`ULL_PREFLIGHT=1`）：开窗前拿 wgpu 的具名错误。
实测 Windows RX 6600 XT 上 took=717ms，所以不进默认路径。
- `app/backend.rs` 的档位判据跟着改成读单项；**真降级到 CPU 的那一次面板 α 现在会
正确强制 1.0**（以前静默降级后仍按 GPU 档判）。
Windows 实测：auto → wgpu + `Selected: AdapterInfo{…backend: Vulkan}` 出图；
`--renderer=cpu` 逐字不变；`WGPU_BACKEND=metal` 造失败 → 具名错误 → 交互路径降级
不崩（首帧 531ms）/ 取证路径拒绝出图 exit 1。macOS Metal 路径需真机复核，
命令与期望日志行写在 `renderer/mod.rs` 的「真机验收」一节。
This commit is contained in:
AskaEth committed
1 parent
45cd44f756
commit
31cdfd5bbd
13 files changed
+1260
-157
No files matched your search
@@ -0,0 +1,305 @@
|
||||
//! 判据的**纯函数**部分：`请求 × 探测 × 是否编入 wgpu` → 起步后端 + 兜底后端。
|
||||
//!
|
||||
//! 表本身（什么条件选什么、日志该打什么、谁能验证）在 [`super`] 的模块文档顶部。
|
||||
//! 这里只放可测的东西：判据一旦掺进运行期副作用（写环境变量、看日志、开窗），
|
||||
//! 「降级矩阵」就再也写不成表驱动测试了——M97 的教训。
|
||||
|
||||
use crate::{Backend, Probe};
|
||||
|
||||
/// 一个具体渲染后端（`ICED_BACKEND` 的单项取值）。
|
||||
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
|
||||
pub enum Kind {
|
||||
/// `ICED_BACKEND=wgpu`。
|
||||
Wgpu,
|
||||
/// `ICED_BACKEND=tiny-skia`。
|
||||
TinySkia,
|
||||
}
|
||||
|
||||
impl Kind {
|
||||
/// 写进 `ICED_BACKEND` 的取值（也是 `iced_renderer` 认的名字）。
|
||||
#[must_use]
|
||||
pub fn env_value(self) -> &'static str {
|
||||
match self {
|
||||
Kind::Wgpu => "wgpu",
|
||||
Kind::TinySkia => "tiny-skia",
|
||||
}
|
||||
}
|
||||
|
||||
/// 日志里的名字。
|
||||
#[must_use]
|
||||
pub fn name(self) -> &'static str {
|
||||
self.env_value()
|
||||
}
|
||||
|
||||
/// 对应的「档位」（D36 的 CPU 档 / GPU 档判据用）。
|
||||
#[must_use]
|
||||
pub fn tier(self) -> Backend {
|
||||
match self {
|
||||
Kind::Wgpu => Backend::Gpu,
|
||||
Kind::TinySkia => Backend::Cpu,
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/// 判据产物：起步后端 + **本 crate 自己**的兜底（不是 iced 的候选回退）。
|
||||
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
|
||||
pub struct Decision {
|
||||
/// 写进 `ICED_BACKEND` 的唯一一项。
|
||||
pub primary: Kind,
|
||||
/// 起步失败后重开的后端；`None` = 没有兜底（强制 CPU / 没编 wgpu）。
|
||||
pub fallback: Option<Kind>,
|
||||
/// 为什么这么判（进日志，验收就靠它）。
|
||||
pub reason: &'static str,
|
||||
}
|
||||
|
||||
impl Decision {
|
||||
/// 一行给人看的决策描述。
|
||||
#[must_use]
|
||||
pub fn describe(&self) -> String {
|
||||
match self.fallback {
|
||||
Some(fallback) => format!(
|
||||
"renderer = {} reason={} 兜底={}（失败会先打印具名错误）",
|
||||
self.primary.name(),
|
||||
self.reason,
|
||||
fallback.name()
|
||||
),
|
||||
None => format!(
|
||||
"renderer = {} reason={} 兜底=none（候选表唯一项）",
|
||||
self.primary.name(),
|
||||
self.reason
|
||||
),
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/// 判据纯函数：请求 × 探测 × 是否编入 wgpu → 决策。
|
||||
///
|
||||
/// **必须是纯函数**：M97 的教训是判据一旦掺了运行期副作用（写环境变量、看日志），
|
||||
/// 就再也写不出「降级矩阵」的表驱动测试了。
|
||||
#[must_use]
|
||||
pub fn decide(request: Backend, probe: &Probe, gpu_compiled: bool) -> Decision {
|
||||
match (request, gpu_compiled) {
|
||||
// 1. 用户点名 CPU：只有 CPU，且**不给兜底**（强制就是强制）。
|
||||
(Backend::Cpu, _) => Decision {
|
||||
primary: Kind::TinySkia,
|
||||
fallback: None,
|
||||
reason: "forced-cpu",
|
||||
},
|
||||
// 2. 点名 GPU 但没编 wgpu：只能 CPU，没得兜。
|
||||
(Backend::Gpu, false) => Decision {
|
||||
primary: Kind::TinySkia,
|
||||
fallback: None,
|
||||
reason: "gpu-not-compiled",
|
||||
},
|
||||
// 3. 点名 GPU 且编了：GPU 起步，CPU 兜底（绝不硬失败）。
|
||||
(Backend::Gpu, true) => Decision {
|
||||
primary: Kind::Wgpu,
|
||||
fallback: Some(Kind::TinySkia),
|
||||
reason: "forced-gpu",
|
||||
},
|
||||
// 4. auto + 没编 wgpu。
|
||||
(Backend::Auto, false) => Decision {
|
||||
primary: Kind::TinySkia,
|
||||
fallback: None,
|
||||
reason: "auto-gpu-not-compiled",
|
||||
},
|
||||
// 5. auto + 只有 WARP/llvmpipe 这类软光栅：CPU 起步，wgpu 留作最后兜底。
|
||||
(Backend::Auto, true) if !probe.hardware => Decision {
|
||||
primary: Kind::TinySkia,
|
||||
fallback: Some(Kind::Wgpu),
|
||||
reason: "auto-no-hardware-adapter",
|
||||
},
|
||||
// 6. auto + 有硬件适配器：GPU 起步，CPU 兜底。
|
||||
(Backend::Auto, true) => Decision {
|
||||
primary: Kind::Wgpu,
|
||||
fallback: Some(Kind::TinySkia),
|
||||
reason: "auto-hardware-adapter",
|
||||
},
|
||||
}
|
||||
}
|
||||
|
||||
/// 预检失败时把 wgpu 降下来（判据表第 7 行）。
|
||||
///
|
||||
/// 只在 `ULL_PREFLIGHT=1` 且预检真的失败时调用：这时候**别去开那个窗**——重试一次要闪两下窗，
|
||||
/// 而且原因已经拿在手里了。
|
||||
#[must_use]
|
||||
pub fn demote_after_preflight(decision: Decision) -> Decision {
|
||||
if decision.primary != Kind::Wgpu {
|
||||
return decision;
|
||||
}
|
||||
Decision {
|
||||
primary: Kind::TinySkia,
|
||||
fallback: Some(Kind::Wgpu),
|
||||
reason: "preflight-failed",
|
||||
}
|
||||
}
|
||||
|
||||
/// 取证通道（`--screen=gallery`）用：**剥掉兜底**。
|
||||
///
|
||||
/// 硬规则（M97 定）：**取证工具宁可红着退出，也不能悄悄换一种后端继续出图**。
|
||||
/// 以前 gallery 在 wgpu 挂掉时会静默出 CPU 截图，而报告上写的是「GPU 渲染截图」——
|
||||
/// 所有视觉结论的可信度都被这一条悄悄打折，而且从输出上看不出来。
|
||||
#[must_use]
|
||||
pub fn strict(decision: Decision) -> Decision {
|
||||
Decision {
|
||||
fallback: None,
|
||||
reason: "gallery-strict",
|
||||
..decision
|
||||
}
|
||||
}
|
||||
#[cfg(test)]
|
||||
mod tests {
|
||||
use super::*;
|
||||
|
||||
fn probe(types: &[&'static str]) -> Probe {
|
||||
Probe {
|
||||
adapters: types
|
||||
.iter()
|
||||
.map(|device_type| crate::probe::AdapterSummary {
|
||||
name: "adapter".to_owned(),
|
||||
device_type,
|
||||
})
|
||||
.collect(),
|
||||
hardware: types
|
||||
.iter()
|
||||
.any(|device_type| !matches!(*device_type, "Cpu" | "Other")),
|
||||
}
|
||||
}
|
||||
|
||||
/// 判据表的一行：`请求, 探测结论, 是否编入 wgpu, 期望起步, 期望兜底, 期望 reason`。
|
||||
type Case = (Backend, Probe, bool, Kind, Option<Kind>, &'static str);
|
||||
|
||||
/// 判据表第 1~6 行逐行钉死（表驱动）。谁动了 `decide` 的矩阵，这条先红。
|
||||
#[test]
|
||||
fn criterion_table_rows_1_to_6() {
|
||||
let hardware = || probe(&["IntegratedGpu"]);
|
||||
let software = || probe(&["Cpu"]);
|
||||
let cases: &[Case] = &[
|
||||
// 1 强制 CPU：不给兜底
|
||||
(
|
||||
Backend::Cpu,
|
||||
hardware(),
|
||||
true,
|
||||
Kind::TinySkia,
|
||||
None,
|
||||
"forced-cpu",
|
||||
),
|
||||
(
|
||||
Backend::Cpu,
|
||||
software(),
|
||||
false,
|
||||
Kind::TinySkia,
|
||||
None,
|
||||
"forced-cpu",
|
||||
),
|
||||
// 2 点名 GPU 但没编
|
||||
(
|
||||
Backend::Gpu,
|
||||
hardware(),
|
||||
false,
|
||||
Kind::TinySkia,
|
||||
None,
|
||||
"gpu-not-compiled",
|
||||
),
|
||||
// 3 点名 GPU 且编了
|
||||
(
|
||||
Backend::Gpu,
|
||||
hardware(),
|
||||
true,
|
||||
Kind::Wgpu,
|
||||
Some(Kind::TinySkia),
|
||||
"forced-gpu",
|
||||
),
|
||||
(
|
||||
Backend::Gpu,
|
||||
software(),
|
||||
true,
|
||||
Kind::Wgpu,
|
||||
Some(Kind::TinySkia),
|
||||
"forced-gpu",
|
||||
),
|
||||
// 4 auto + 没编
|
||||
(
|
||||
Backend::Auto,
|
||||
hardware(),
|
||||
false,
|
||||
Kind::TinySkia,
|
||||
None,
|
||||
"auto-gpu-not-compiled",
|
||||
),
|
||||
// 5 auto + 只有软光栅
|
||||
(
|
||||
Backend::Auto,
|
||||
software(),
|
||||
true,
|
||||
Kind::TinySkia,
|
||||
Some(Kind::Wgpu),
|
||||
"auto-no-hardware-adapter",
|
||||
),
|
||||
// 6 auto + 有硬件（macOS M1 走这条）
|
||||
(
|
||||
Backend::Auto,
|
||||
hardware(),
|
||||
true,
|
||||
Kind::Wgpu,
|
||||
Some(Kind::TinySkia),
|
||||
"auto-hardware-adapter",
|
||||
),
|
||||
];
|
||||
|
||||
for (request, probe, gpu_compiled, primary, fallback, reason) in cases {
|
||||
let got = decide(*request, probe, *gpu_compiled);
|
||||
assert_eq!(got.primary, *primary, "request={request:?} reason={reason}");
|
||||
assert_eq!(
|
||||
got.fallback, *fallback,
|
||||
"request={request:?} reason={reason}"
|
||||
);
|
||||
assert_eq!(got.reason, *reason);
|
||||
}
|
||||
}
|
||||
|
||||
/// **安全网守门**：除了「强制 CPU」和「没编 wgpu」，任何一条判据都必须留兜底。
|
||||
///
|
||||
/// 抓不住：兜底那次重开本身失败（那是 iced 的事，见判据表第 8 行）。
|
||||
#[test]
|
||||
fn every_decision_keeps_an_exit() {
|
||||
for request in [Backend::Auto, Backend::Gpu, Backend::Cpu] {
|
||||
for gpu_compiled in [true, false] {
|
||||
for types in [&[][..], &["Cpu"][..], &["IntegratedGpu"][..]] {
|
||||
let decision = decide(request, &probe(types), gpu_compiled);
|
||||
let forced = request == Backend::Cpu || !gpu_compiled;
|
||||
assert_eq!(
|
||||
decision.fallback.is_none(),
|
||||
forced,
|
||||
"{decision:?} 必须留兜底（request={request:?} gpu_compiled={gpu_compiled}）"
|
||||
);
|
||||
// 兜底不能和起步项相同，否则重试等于原地打转。
|
||||
assert_ne!(decision.fallback, Some(decision.primary), "{decision:?}");
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/// 预检失败只降 wgpu 起步的那些行；`--renderer=cpu` 一行都不许动。
|
||||
#[test]
|
||||
fn preflight_demotes_only_wgpu_decisions() {
|
||||
let hardware = probe(&["IntegratedGpu"]);
|
||||
let auto = decide(Backend::Auto, &hardware, true);
|
||||
let demoted = demote_after_preflight(auto);
|
||||
assert_eq!(demoted.primary, Kind::TinySkia);
|
||||
assert_eq!(demoted.reason, "preflight-failed");
|
||||
assert_eq!(demoted.fallback, Some(Kind::Wgpu), "wgpu 还能当最后兜底");
|
||||
|
||||
let cpu = decide(Backend::Cpu, &hardware, true);
|
||||
assert_eq!(demote_after_preflight(cpu), cpu, "强制 CPU 不许被预检改写");
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn describe_names_the_backend_and_the_reason() {
|
||||
let hardware = probe(&["DiscreteGpu"]);
|
||||
let text = decide(Backend::Auto, &hardware, true).describe();
|
||||
assert!(text.contains("renderer = wgpu"), "{text}");
|
||||
assert!(text.contains("reason=auto-hardware-adapter"), "{text}");
|
||||
assert!(text.contains("兜底=tiny-skia"), "{text}");
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,151 @@
|
||||
//! 把 `iced_wgpu` / `wgpu` 的 `log` 输出转到 stderr（判据表第 8 行的取证通道）。
|
||||
//!
|
||||
//! ## 为什么需要它
|
||||
//!
|
||||
//! `iced_wgpu` 在**真的**创建设备时会自己打一行：
|
||||
//!
|
||||
//! ```text
|
||||
//! Selected: AdapterInfo { name: "Apple M1", backend: Metal, device_type: IntegratedGpu, … }
|
||||
//! ```
|
||||
//!
|
||||
//! 这行只有「wgpu 走到适配器那一步」才会出现，所以它是**GPU 真生效的实证**——不是我们的推断。
|
||||
//! 但它走 `log` crate，而本进程从来没装过 logger，于是 M1 那份报告里这行根本不存在：
|
||||
//! 「看不到」被当成了「没有」。装一个只放行 GPU 相关 target 的 logger，成本 60 行，
|
||||
//! 换来的是以后每次验收都能直接看见 wgpu 说了什么。
|
||||
//!
|
||||
//! ## 过滤
|
||||
//!
|
||||
//! 按 **target 分级**，不是一刀切：`wgpu_hal` / `wgpu_core` 在 Info 级别会刷出上百行 Vulkan
|
||||
//! loader 噪声（M97 实测：启动时 90 行 registry 扫描），把真正有用的
|
||||
//! `iced_wgpu: Selected: AdapterInfo{…}` 埋掉。
|
||||
//!
|
||||
//! | `ULL_GPU_LOG` | `iced_wgpu*` | `wgpu*`（hal / core） | 用途 |
|
||||
//! |---|---|---|---|
|
||||
//! | 未设 / `info` | Info | **Warn** | 默认：看得见选中的适配器/格式 + wgpu 的告警 |
|
||||
//! | `warn` | Warn | Warn | 只留告警（启动日志最干净） |
|
||||
//! | `debug` | Debug | Debug | 全量（诊断用；含 Vulkan loader 噪声） |
|
||||
//! | `off` | — | — | 不装 logger（回到 M97 之前，仅用于对照实验） |
|
||||
//!
|
||||
//! 其它 target（`winit`、`iced_winit` …）一律不放行：它们只会把启动日志淹掉。
|
||||
|
||||
use std::sync::Once;
|
||||
|
||||
/// 装 logger（进程内只生效一次；重复调用无害）。
|
||||
pub fn install() {
|
||||
static ONCE: Once = Once::new();
|
||||
ONCE.call_once(|| {
|
||||
let Some(level) = level_from_env() else {
|
||||
return;
|
||||
};
|
||||
// `set_boxed_logger` 只能成功一次；已被别人装过就安静让位，不 panic。
|
||||
if log::set_boxed_logger(Box::new(Bridge { level })).is_ok() {
|
||||
log::set_max_level(level);
|
||||
}
|
||||
});
|
||||
}
|
||||
|
||||
/// `ULL_GPU_LOG` → 过滤级别；`None` = 别装（`off`）。
|
||||
fn level_from_env() -> Option<log::LevelFilter> {
|
||||
parse_level(&std::env::var("ULL_GPU_LOG").unwrap_or_default())
|
||||
}
|
||||
|
||||
/// 取值解释（纯函数，测试直接喂字符串，不碰进程环境）。
|
||||
fn parse_level(value: &str) -> Option<log::LevelFilter> {
|
||||
match value.trim().to_ascii_lowercase().as_str() {
|
||||
"off" | "0" | "no" | "false" => None,
|
||||
"warn" | "warning" => Some(log::LevelFilter::Warn),
|
||||
"debug" => Some(log::LevelFilter::Debug),
|
||||
"trace" => Some(log::LevelFilter::Trace),
|
||||
_ => Some(log::LevelFilter::Info),
|
||||
}
|
||||
}
|
||||
|
||||
/// 某个 target 在这个总级别下实际放行到哪一级。
|
||||
///
|
||||
/// `wgpu_hal`/`wgpu_core` 在 `info` 档被压到 `warn`：它们的 info 是 Vulkan loader 的原文，
|
||||
/// 对「到底用了哪个后端」没有信息量，只有噪声。
|
||||
fn target_level(level: log::LevelFilter, target: &str) -> log::LevelFilter {
|
||||
if level == log::LevelFilter::Info && !target.starts_with("iced_wgpu") {
|
||||
return log::LevelFilter::Warn;
|
||||
}
|
||||
level
|
||||
}
|
||||
|
||||
/// 只放行渲染后端相关 target 的 logger。
|
||||
struct Bridge {
|
||||
level: log::LevelFilter,
|
||||
}
|
||||
|
||||
impl log::Log for Bridge {
|
||||
fn enabled(&self, metadata: &log::Metadata<'_>) -> bool {
|
||||
let target = metadata.target();
|
||||
is_gpu_target(target) && metadata.level() <= target_level(self.level, target)
|
||||
}
|
||||
|
||||
fn log(&self, record: &log::Record<'_>) {
|
||||
if !self.enabled(record.metadata()) {
|
||||
return;
|
||||
}
|
||||
// iced_wgpu 用 `{:#?}` 打多行结构体；压成一行才好 grep / 贴验收报告。
|
||||
let message = record.args().to_string().replace('\n', " ");
|
||||
eprintln!("[gpu] {}: {}", record.target(), message.trim_end());
|
||||
}
|
||||
|
||||
fn flush(&self) {}
|
||||
}
|
||||
|
||||
/// `iced_wgpu::window::compositor` / `wgpu_core::…` / `wgpu_hal::…` 都算。
|
||||
fn is_gpu_target(target: &str) -> bool {
|
||||
["iced_wgpu", "wgpu"]
|
||||
.iter()
|
||||
.any(|prefix| target.starts_with(prefix))
|
||||
}
|
||||
|
||||
#[cfg(test)]
|
||||
mod tests {
|
||||
use super::*;
|
||||
|
||||
#[test]
|
||||
fn only_gpu_targets_pass() {
|
||||
assert!(is_gpu_target("iced_wgpu::window::compositor"));
|
||||
assert!(is_gpu_target("wgpu_core::instance"));
|
||||
assert!(is_gpu_target("wgpu_hal::metal"));
|
||||
assert!(!is_gpu_target("iced_winit::lib"));
|
||||
assert!(!is_gpu_target("winit::event_loop"));
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn level_env_values_are_interpreted() {
|
||||
assert_eq!(parse_level(""), Some(log::LevelFilter::Info));
|
||||
assert_eq!(parse_level("info"), Some(log::LevelFilter::Info));
|
||||
assert_eq!(parse_level(" WARN "), Some(log::LevelFilter::Warn));
|
||||
assert_eq!(parse_level("off"), None);
|
||||
assert_eq!(parse_level("0"), None);
|
||||
}
|
||||
|
||||
/// 默认档（`info`）下 `wgpu_hal`/`wgpu_core` 被压到 Warn：它们是 Vulkan loader 原文，
|
||||
/// M97 实测一屏 90 行噪声，会把 `Selected: AdapterInfo` 埋掉。
|
||||
#[test]
|
||||
fn default_level_mutes_wgpu_noise_but_keeps_adapter_line() {
|
||||
use log::LevelFilter;
|
||||
assert_eq!(
|
||||
target_level(LevelFilter::Info, "iced_wgpu::window::compositor"),
|
||||
LevelFilter::Info,
|
||||
"选中适配器那行必须留"
|
||||
);
|
||||
assert_eq!(
|
||||
target_level(LevelFilter::Info, "wgpu_hal::vulkan::instance"),
|
||||
LevelFilter::Warn,
|
||||
"Vulkan loader 噪声必须压掉"
|
||||
);
|
||||
assert_eq!(
|
||||
target_level(LevelFilter::Info, "wgpu_core::instance"),
|
||||
LevelFilter::Warn
|
||||
);
|
||||
// 显式要 debug 时全放行（诊断用）。
|
||||
assert_eq!(
|
||||
target_level(LevelFilter::Debug, "wgpu_hal::vulkan::instance"),
|
||||
LevelFilter::Debug
|
||||
);
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,187 @@
|
||||
//! 渲染后端的**判据表**（M97）+ 三段可观测性基建。
|
||||
//!
|
||||
//! 本模块回答一个问题：**这个进程到底跑在哪个渲染器上，凭什么这么断定。**
|
||||
//!
|
||||
//! ## 判据表（验收直接对照这张表）
|
||||
//!
|
||||
//! `ICED_BACKEND` **永远是单项**（不是候选列表）。理由见下节「为什么不再用候选列表」：
|
||||
//! 单项 ⇒ 「跑起来了 ⇒ 就是它」，不存在需要事后猜的空间。`兜底` 列是**本 crate 自己的重试**，
|
||||
//! 不是 iced 的回退，所以它一定伴随一行具名错误日志。
|
||||
//!
|
||||
//! | # | 条件 | 选哪个 | 日志该打印什么 | 谁能验证 |
|
||||
//! |---|---|---|---|---|
|
||||
//! | 1 | `--renderer=cpu` / `--software-renderer` | `tiny-skia` | `renderer = tiny-skia reason=forced-cpu` | 三平台（CI 只用这条） |
|
||||
//! | 2 | `--renderer=gpu` 但本构建没编 wgpu | `tiny-skia` | `reason=gpu-not-compiled` + `；本构建未编入 wgpu` | 三平台（`--no-default-features`） |
|
||||
//! | 3 | `--renderer=gpu` 且编了 wgpu | `wgpu`，兜底 `tiny-skia` | `renderer = wgpu reason=forced-gpu 兜底=tiny-skia` | Windows / Linux 本机；macOS 需真机 |
|
||||
//! | 4 | `--renderer=auto` 但没编 wgpu | `tiny-skia` | `reason=auto-gpu-not-compiled` | 三平台（`--no-default-features`） |
|
||||
//! | 5 | `auto` + 枚举不到硬件适配器（只有 WARP / llvmpipe） | `tiny-skia`，兜底 `wgpu` | `reason=auto-no-hardware-adapter` | Windows 本机（软渲染 VM） |
|
||||
//! | 6 | `auto` + 有硬件适配器 | `wgpu`，兜底 `tiny-skia` | `reason=auto-hardware-adapter` | Windows 本机 **√**；macOS 需真机 |
|
||||
//! | 7 | 同上但 `ULL_PREFLIGHT=1` 预检失败 | `tiny-skia`，兜底 `wgpu` | `[gpu-preflight] FAILED stage=… error=…` + `reason=preflight-failed` | 三平台（可用 `WGPU_BACKEND=gl` 造） |
|
||||
//! | 8 | 任何一行选了 wgpu，但 iced 真初始化失败，且**交互启动**（无 `--screenshot`） | 具名错误 → **换一个进程**重开 `tiny-skia` | `[gpu] wgpu 初始化失败（具名）：…` → `[gpu] 降级 → tiny-skia（…换一个进程重开…）` → 子进程 `[probe] 本次是降级重开（ULL_GPU_FALLBACK=tiny-skia）` | **Windows 已验**（`WGPU_BACKEND=metal` 造）；macOS 需真机 |
|
||||
//! | 9 | 同上行，但**取证启动**（带 `--screenshot`，含 `--screen=gallery`） | 具名错误 → **不出图**，退出码 1 | `[gpu] wgpu 初始化失败（具名）：…` → `[gpu] 拒绝降级出图：本次是取证启动（--screenshot …）` | **Windows 已验**（同造法）；macOS 需真机 |
|
||||
//!
|
||||
//! **第 8/9 行的硬规则（M97 定）**：
|
||||
//!
|
||||
//! - 取证工具（`--screenshot`）宁可红着退出，也不能悄悄换一种后端继续出图。以前 gallery 在
|
||||
//! wgpu 挂掉时会静默降级到 tiny-skia 照样落 PNG，而报告上写的是「GPU 渲染截图」——所有视觉
|
||||
//! 结论的可信度都被悄悄打折，而且从输出上看不出来。现在每张图的日志里都带
|
||||
//! **实际**后端名（`[shot] … renderer=wgpu`），图能自证来源。
|
||||
//! - 交互启动保留安全网：真无 GPU / wgpu 起不来时降级到 tiny-skia，不崩。
|
||||
//!
|
||||
//! **降级为什么是换进程**：第一版写的是「打印错误 → 在本进程里再 `run()` 一次」，Windows 实测
|
||||
//! 直接 panic（`iced_winit-0.14.1/src/lib.rs:81` → `Create event loop: RecreationAttempt`）——
|
||||
//! winit 不允许一个进程建两次事件循环。所以安全网是 `respawn`：起一个子进程、只换
|
||||
//! `ICED_BACKEND` + `ULL_GPU_FALLBACK`，然后带着子进程的退出码退出。子进程看到
|
||||
//! `ULL_GPU_FALLBACK` 就跳过探测（否则会得到同一个结论、无限重开）。
|
||||
//!
|
||||
//! `ULL_PREFLIGHT` 开关的代价（**实测**，不是估计）：Windows RX 6600 XT / Vulkan 上
|
||||
//! `took=717ms`（首次要扫一遍 Vulkan loader），不可用时 `took=0ms`。打开它等于启动多 ~0.7 s，
|
||||
//! 所以默认关。它测不了 `create_surface`（那时还没有窗口），代替不了真跑一次，只用来「开窗前拿原因」。
|
||||
//! 注意：`ULL_PREFLIGHT=1` + 预检失败 + `--screenshot` 时**仍会**降级出图（`reason=preflight-failed`，
|
||||
//! 图上是 `renderer=tiny-skia`）——那条路径不是静默的，但图确实是 CPU 的，读图前先读日志。
|
||||
//!
|
||||
//! ## 怎么从日志判断「有没有静默降级」
|
||||
//!
|
||||
//! | 你看到 | 结论 |
|
||||
//! |---|---|
|
||||
//! | `[probe] renderer = wgpu` 且之后有 `[gpu] iced_wgpu: …Selected: AdapterInfo…` | **真在走 GPU**（这行是 iced_wgpu 自己在创建设备时打的，不是我们的猜测） |
|
||||
//! | `[gpu] wgpu 初始化失败（具名）：…` | wgpu 起不来，**原因就在这行里**；交互启动已换进程降级 CPU，取证启动已拒绝出图 |
|
||||
//! | `[gpu] 拒绝降级出图：…` | 这张图**没有**产出（取证启动 + wgpu 起不来）。想用 CPU 出图请显式 `--renderer=cpu` |
|
||||
//! | `[gpu] 降级 → tiny-skia（…换一个进程重开…）` | 交互启动降级了；后面必然跟一行 `[probe] 本次是降级重开` |
|
||||
//! | `[probe] renderer = tiny-skia reason=…`（`reason` 不是 `forced-cpu`） | 探测判定不该上 GPU，**原因在 `reason`** |
|
||||
//! | `[shot] … renderer=wgpu` / `renderer=tiny-skia` | 这张图**实际**由哪个后端产出（M97 之前这里打的是请求值 `auto`，等于没打） |
|
||||
//! | 只有 `[probe] renderer = …` 一行、没有 `[gpu] iced_wgpu:` 也没有取证行 | 那是 M97 之前的旧日志——**它从来没观测过实际后端**，不可采信 |
|
||||
//!
|
||||
//! ## 为什么不再用候选列表（M97 的根因订正）
|
||||
//!
|
||||
//! M97 之前：`auto` + 有硬件 → **不设** `ICED_BACKEND`，把决策交给 iced 的
|
||||
//! `fallback::Compositor`；那条路径里 wgpu 的失败被 `errors` 向量装起来、tiny-skia 一成功就整体丢弃
|
||||
//! （`iced_renderer-0.14.0/src/fallback.rs`，我们改不了）。日志只剩 `renderer = auto (wgpu -> tiny-skia)`
|
||||
//! ——而这行是 `probe.rs` 里按 `env == None` 打出来的**常量字符串**，跟实际后端无关。
|
||||
//! 于是 macOS M1 上「枚举到 Apple M1」与「最终是不是真在用 GPU」彻底脱钩：**看起来正常但可能在跑 CPU**。
|
||||
//!
|
||||
//! 现在的唯一判据：`ICED_BACKEND` 只写一项 ⇒ 能跑起来就必定是它；起不来就必然是
|
||||
//! `iced::Error::GraphicsCreationFailed` 里那串具名错误（哪个 backend、reason 是什么），
|
||||
//! 由 `app/boot.rs` 打印后决定「换进程降级」还是「拒绝出图」。
|
||||
//!
|
||||
//! ## 三段基建
|
||||
//!
|
||||
//! | 模块 | 作用 | 默认 |
|
||||
//! |---|---|---|
|
||||
//! | [`preflight`] | 在 iced 之前自己跑一遍 wgpu 的「实例→适配器→设备」，把失败原因拿在手里 | **关**（`ULL_PREFLIGHT=1` 打开；会重复创建实例/设备，别放默认路径） |
|
||||
//! | [`log_bridge`] | 把 `iced_wgpu` / `wgpu` 的 `log` 输出转到 stderr（`Selected: AdapterInfo{…}` 这行就是 GPU 生效的实证） | 开（`ULL_GPU_LOG=off` 可关） |
|
||||
//!
|
||||
//! ## 真机验收（macOS Metal 路径 —— **需真机复核**，Windows 验不了这一段）
|
||||
//!
|
||||
//! 判据表第 3/6/8/9 行的 macOS 分支只能真机验。下面每段都可直接粘贴；`# 期望` 后面是**必须能在
|
||||
//! stderr 里 grep 到的原文**（M98 的验收包会直接把这些字符串编成断言）。
|
||||
//!
|
||||
//! ```bash
|
||||
//! # 0) 一次
|
||||
//! cargo build -p unlucky-app-iced
|
||||
//!
|
||||
//! # 1) 交互启动：这才是判「M1 到底有没有在用 GPU」的那次。看完关窗即可。
|
||||
//! ./target/debug/unlucky-launcher-iced --renderer=auto
|
||||
//! # 期望（这两行同一次运行里都要有）：
|
||||
//! # [probe] renderer = wgpu reason=auto-hardware-adapter 兜底=tiny-skia
|
||||
//! # [gpu] iced_wgpu::window::compositor: Selected: AdapterInfo { name: "Apple M1",
|
||||
//! # 上面第二行里的 backend 必须是 Metal（同一行靠后）。
|
||||
//! # 若出现下面任一行 ⇒ 这次**不是** GPU，把那段原文（含上一行）发回来：
|
||||
//! # [gpu] wgpu 初始化失败（具名）：
|
||||
//! # [gpu] 降级 → tiny-skia
|
||||
//! # [probe] 本次是降级重开（ULL_GPU_FALLBACK=tiny-skia）
|
||||
//!
|
||||
//! # 2) 开窗前拿原因（不建窗；多花 ~0.7 s）
|
||||
//! ULL_PREFLIGHT=1 ./target/debug/unlucky-launcher-iced --renderer=auto
|
||||
//! # 期望：[gpu-preflight] ok adapter="Apple M1" type=IntegratedGpu backend=Metal took=
|
||||
//!
|
||||
//! # 3) 取证出图（D30 通道；这一张图自证来源）
|
||||
//! ./target/debug/unlucky-launcher-iced --screen=gallery --screenshot /tmp/gallery.png
|
||||
//! # 期望（三行都该有）：
|
||||
//! # [gpu] iced_wgpu::window::compositor: Selected: AdapterInfo { name: "Apple M1",
|
||||
//! # [shot] 1180x760 scale=1 -> /tmp/gallery.png
|
||||
//! # [shot] screen=gallery theme=light renderer=wgpu
|
||||
//! # 若 wgpu 起不来 ⇒ 没有 /tmp/gallery.png、退出码 1、且打印 [gpu] 拒绝降级出图：
|
||||
//!
|
||||
//! # 4) 强制 CPU 对照（必须与 M97 之前逐字一致）
|
||||
//! ./target/debug/unlucky-launcher-iced --renderer=cpu --screenshot /tmp/cpu.png
|
||||
//! # 期望：
|
||||
//! # [probe] adapters=0 hardware=false :: request=cpu -> ICED_BACKEND=tiny-skia
|
||||
//! # [probe] renderer = tiny-skia reason=forced-cpu 兜底=none（候选表唯一项）
|
||||
//! # [shot] screen=shell theme=light renderer=tiny-skia
|
||||
//!
|
||||
//! # 5) 负例：取证启动遇到 wgpu 不可用时必须红着退出（Mac 上用一个不存在的后端来造）
|
||||
//! WGPU_BACKEND=dx12 ./target/debug/unlucky-launcher-iced --screen=gallery --screenshot /tmp/bad.png
|
||||
//! # 期望：**没有** /tmp/bad.png、退出码 1、并且打印：
|
||||
//! # [gpu] wgpu 初始化失败（具名）：multiple errors occurred: [GraphicsAdapterNotFound { backend: "wgpu", reason: RequestFailed("no adapter was found for the options requested:
|
||||
//! # [gpu] 拒绝降级出图：本次是取证启动（--screenshot /tmp/bad.png），换后端出的图会撒谎。
|
||||
//! ```
|
||||
//!
|
||||
//! 第 5 段在 Windows 上已用同构的 `WGPU_BACKEND=metal` 验过（`metal support not compiled in`
|
||||
//! → 具名错误 → 拒绝出图 → exit 1）；macOS 上要确认打印的是 `dx12 support not compiled in` 那类
|
||||
//! wgpu 原话，而不是我们自己的话。
|
||||
|
||||
pub mod decision;
|
||||
pub mod log_bridge;
|
||||
pub mod preflight;
|
||||
|
||||
pub use decision::{decide, demote_after_preflight, strict, Decision, Kind};
|
||||
|
||||
/// 把 `iced::Error` 里的**具名**图形错误掏出来（`Display` 那句笼统的话不算原因）。
|
||||
///
|
||||
/// `iced::Error::GraphicsCreationFailed(inner)` 的 `Display` 只有
|
||||
/// 「the application graphics context could not be created」，**没有** `{0}`；
|
||||
/// 真正的 backend 名与 `Reason` 在内层 `graphics::Error` 里。所以这里同时给 Display 与 Debug。
|
||||
#[must_use]
|
||||
pub fn named_graphics_error(error: &iced::Error) -> Option<String> {
|
||||
match error {
|
||||
iced::Error::GraphicsCreationFailed(inner) => Some(format!("{inner}｜详情 {inner:?}")),
|
||||
_ => None,
|
||||
}
|
||||
}
|
||||
|
||||
/// 跑一次 iced；起步后端起不来时把**具名**原因交给调用方（不在这里重试）。
|
||||
///
|
||||
/// ## 为什么不能在本进程里重试（M97 实测）
|
||||
///
|
||||
/// 第一版这里是「打印错误 + 再 `run()` 一次」。Windows 实测直接 panic：
|
||||
///
|
||||
/// ```text
|
||||
/// thread 'main' panicked at iced_winit-0.14.1/src/lib.rs:81:
|
||||
/// Create event loop: RecreationAttempt
|
||||
/// ```
|
||||
///
|
||||
/// winit 不允许一个进程建两次事件循环，所以**进程内重试在架构上就不成立**。
|
||||
/// 安全网因此改成**换一个进程重开**（`app/boot.rs` 的 `respawn`），
|
||||
/// 猜测的写法别再加回来。
|
||||
pub fn run_once(decision: Decision, attempt: impl FnOnce(Kind) -> iced::Result) -> iced::Result {
|
||||
attempt(decision.primary)
|
||||
}
|
||||
|
||||
/// 降级重开用的环境变量：子进程看到它就跳过探测、直接用它指向的后端（见 `app::boot::boot_probe`）。
|
||||
///
|
||||
/// ⚠️ 这是**防无限重开**的唯一闸门：子进程若不跳过探测，会算出同一个结论（auto + 有硬件 → wgpu）、
|
||||
/// 再失败、再 respawn，变成自杀式递归。子进程侧的判据在 `boot_probe` 的第一个分支。
|
||||
///
|
||||
/// 它也是**进程间**的交接约定，不是给用户设的开关（用户入口仍是 `--renderer`）。
|
||||
pub const FALLBACK_ENV: &str = "ULL_GPU_FALLBACK";
|
||||
|
||||
/// 读 [`FALLBACK_ENV`]：本进程是不是「上一步失败后重开」的那一次。
|
||||
#[must_use]
|
||||
pub fn forced_fallback() -> Option<Kind> {
|
||||
match std::env::var(FALLBACK_ENV).ok()?.trim() {
|
||||
"tiny-skia" => Some(Kind::TinySkia),
|
||||
"wgpu" => Some(Kind::Wgpu),
|
||||
_ => None,
|
||||
}
|
||||
}
|
||||
|
||||
/// 打印**具名**失败原因（三行以内，`stage`/`backend`/`reason` 都可 grep）。
|
||||
///
|
||||
/// `iced::Error::GraphicsCreationFailed` 的 `Display` **不包含**内部错误
|
||||
/// （`#[error("the application graphics context could not be created")]`，没有 `{0}`），
|
||||
/// 所以这里必须显式把内层错误打出来，否则又变回「只知道失败，不知道为什么」。
|
||||
pub fn report_failure(backend: Kind, error: &(impl std::fmt::Display + std::fmt::Debug)) {
|
||||
eprintln!("[gpu] {} 初始化失败（具名）：{error}", backend.name());
|
||||
eprintln!("[gpu] 失败详情（具名）：{error:?}");
|
||||
}
|
||||
@@ -0,0 +1,244 @@
|
||||
//! wgpu 自检（判据表第 7 行）：在把控制权交给 iced **之前**自己跑一遍
|
||||
//! 「实例 → 适配器 → 设备」，把 wgpu 的具名错误拿在手里。
|
||||
//!
|
||||
//! ## 为什么默认关
|
||||
//!
|
||||
//! 它会**重复** iced 马上要做的活（再建一个实例、再要一个设备），macOS 上一个 Metal 设备
|
||||
//! 不是免费的；而且它测不了 `create_surface`（那时还没有窗口），所以它**代替不了**真跑一次。
|
||||
//! 它的价值只有一个：让「不上 GPU」这个结论在**开窗之前**就有原因，验收时不用盯着一个闪窗猜。
|
||||
//!
|
||||
//! 开关：`ULL_PREFLIGHT=1`（判据表里登记过，不是隐藏口子）。
|
||||
//!
|
||||
//! ## 它镜像的是谁
|
||||
//!
|
||||
//! 逐字对着 `iced_wgpu-0.14.0/src/window/compositor.rs` 的 `Compositor::request()` 抄的：
|
||||
//! `Backends::from_env().unwrap_or(all)`、`PowerPreference::from_env().unwrap_or(HighPerformance)`、
|
||||
//! `Limits { max_bind_groups: 2, max_non_sampler_bindings: 2048, ..default }`。
|
||||
//! 差一处都会让预检和真实路径说不同的话，那时预检就不是证据而是噪声了。
|
||||
|
||||
/// 预检开关的环境变量名（`1` / `true` 打开）。
|
||||
pub const ENV_SWITCH: &str = "ULL_PREFLIGHT";
|
||||
|
||||
/// 预检成功：拿到的适配器摘要。
|
||||
#[derive(Debug, Clone, PartialEq, Eq)]
|
||||
pub struct Verdict {
|
||||
/// 适配器名（`Apple M1` / `AMD Radeon RX 6600 XT` / `Microsoft Basic Render Driver`）。
|
||||
pub adapter: String,
|
||||
/// `device_type` 的字符串形式。
|
||||
pub device_type: &'static str,
|
||||
/// 命中哪个 wgpu 后端（`Metal` / `Vulkan` / `Dx12` / `Gl`）。
|
||||
pub backend: String,
|
||||
}
|
||||
|
||||
impl Verdict {
|
||||
/// 一行日志。
|
||||
#[must_use]
|
||||
pub fn describe(&self) -> String {
|
||||
format!(
|
||||
"ok adapter={:?} type={} backend={}",
|
||||
self.adapter, self.device_type, self.backend
|
||||
)
|
||||
}
|
||||
}
|
||||
|
||||
/// 预检失败：卡在哪一步 + wgpu 自己的错误文本。
|
||||
#[derive(Debug, Clone, PartialEq, Eq)]
|
||||
pub struct Failure {
|
||||
/// 失败阶段（日志里 `stage=` 的取值）。
|
||||
pub stage: &'static str,
|
||||
/// wgpu 具名错误（`Display`，原样保留，不翻译成「失败」）。
|
||||
pub detail: String,
|
||||
}
|
||||
|
||||
impl Failure {
|
||||
/// 一行日志（`stage=` 可直接 grep）。
|
||||
#[must_use]
|
||||
pub fn describe(&self) -> String {
|
||||
format!("FAILED stage={} error={}", self.stage, self.detail)
|
||||
}
|
||||
}
|
||||
|
||||
/// 用户是否要求预检。
|
||||
#[must_use]
|
||||
pub fn requested() -> bool {
|
||||
std::env::var(ENV_SWITCH).is_ok_and(|value| matches!(value.trim(), "1" | "true" | "yes" | "on"))
|
||||
}
|
||||
|
||||
/// 按 `ULL_PREFLIGHT` 决定跑不跑；跑了就顺手把结论打进 stderr（带耗时，别让开关成本变成传说）。
|
||||
///
|
||||
/// 返回 `None` = 没要求预检（调用方按判据表 1~6 行原样走）。
|
||||
#[must_use]
|
||||
pub fn run_if_requested() -> Option<Result<Verdict, Failure>> {
|
||||
if !requested() {
|
||||
return None;
|
||||
}
|
||||
|
||||
let started = std::time::Instant::now();
|
||||
let verdict = run();
|
||||
let took = started.elapsed().as_secs_f64() * 1000.0;
|
||||
match &verdict {
|
||||
Ok(ok) => eprintln!("[gpu-preflight] {} took={took:.0}ms", ok.describe()),
|
||||
Err(failure) => {
|
||||
eprintln!("[gpu-preflight] {} took={took:.0}ms", failure.describe());
|
||||
}
|
||||
}
|
||||
Some(verdict)
|
||||
}
|
||||
|
||||
#[cfg(feature = "gpu")]
|
||||
/// 真跑一遍 wgpu 初始化（不开窗、不建 surface）。
|
||||
///
|
||||
/// # Errors
|
||||
/// 无适配器 / 设备请求被拒时返回 [`Failure`]，`detail` 是 wgpu 的原话。
|
||||
pub fn run() -> Result<Verdict, Failure> {
|
||||
use iced::wgpu::{
|
||||
Backends, ExperimentalFeatures, Features, Instance, InstanceDescriptor, Limits,
|
||||
MemoryHints, PowerPreference, RequestAdapterOptions, Trace,
|
||||
};
|
||||
|
||||
let backends = Backends::from_env().unwrap_or_else(Backends::all);
|
||||
let instance = Instance::new(&InstanceDescriptor {
|
||||
backends,
|
||||
..Default::default()
|
||||
});
|
||||
|
||||
let options = RequestAdapterOptions {
|
||||
power_preference: PowerPreference::from_env().unwrap_or(PowerPreference::HighPerformance),
|
||||
// 没有窗口，测不了 surface 兼容性——这一条只能靠真跑一次（判据表第 8 行）。
|
||||
compatible_surface: None,
|
||||
force_fallback_adapter: false,
|
||||
};
|
||||
|
||||
let adapter = block_on(instance.request_adapter(&options)).map_err(|error| Failure {
|
||||
stage: "request-adapter",
|
||||
detail: format!("{options:?}: {error}"),
|
||||
})?;
|
||||
|
||||
let info = adapter.get_info();
|
||||
let device_type = device_type_name(info.device_type);
|
||||
|
||||
// iced 的 `request_device` 失败时不打日志、只把错误塞进 `RequestDeviceFailed`，
|
||||
// 所以我们在这里先请求一次，把它的话原样抄下来。
|
||||
let _ = block_on(adapter.request_device(&iced::wgpu::DeviceDescriptor {
|
||||
label: Some("unlucky-launcher gpu preflight"),
|
||||
required_features: Features::empty(),
|
||||
required_limits: Limits {
|
||||
max_bind_groups: 2,
|
||||
max_non_sampler_bindings: 2048,
|
||||
..Limits::default()
|
||||
},
|
||||
memory_hints: MemoryHints::MemoryUsage,
|
||||
trace: Trace::Off,
|
||||
experimental_features: ExperimentalFeatures::disabled(),
|
||||
}))
|
||||
.map_err(|error| Failure {
|
||||
stage: "request-device",
|
||||
detail: error.to_string(),
|
||||
})?;
|
||||
|
||||
Ok(Verdict {
|
||||
adapter: info.name,
|
||||
device_type,
|
||||
backend: format!("{:?}", info.backend),
|
||||
})
|
||||
}
|
||||
|
||||
#[cfg(not(feature = "gpu"))]
|
||||
/// 本构建没编 wgpu：预检必然是「不可用」，但这不是错误——判据表第 4 行已经说明原因。
|
||||
///
|
||||
/// # Errors
|
||||
/// 恒返回 [`Failure`]（`stage=not-compiled`）。
|
||||
pub fn run() -> Result<Verdict, Failure> {
|
||||
Err(Failure {
|
||||
stage: "not-compiled",
|
||||
detail: "本构建未编入 wgpu（--no-default-features）".to_owned(),
|
||||
})
|
||||
}
|
||||
|
||||
#[cfg(feature = "gpu")]
|
||||
/// `DeviceType` → 日志里的字符串（探测与预检**共用**这一处，别各写一份 `match`）。
|
||||
#[must_use]
|
||||
pub fn device_type_name(device_type: iced::wgpu::DeviceType) -> &'static str {
|
||||
use iced::wgpu::DeviceType;
|
||||
match device_type {
|
||||
DeviceType::DiscreteGpu => "DiscreteGpu",
|
||||
DeviceType::IntegratedGpu => "IntegratedGpu",
|
||||
DeviceType::VirtualGpu => "VirtualGpu",
|
||||
DeviceType::Cpu => "Cpu",
|
||||
DeviceType::Other => "Other",
|
||||
}
|
||||
}
|
||||
|
||||
/// 把 wgpu 的 future 跑到底。
|
||||
///
|
||||
/// 只用 `std`：`Waker` 由 `std::task::Wake` 提供（安全 API），运行期负责 `park`。
|
||||
/// 不引入 futures 执行器——这里只有一个 future，而且它在 wgpu 的回调线程上唤醒。
|
||||
#[cfg(feature = "gpu")]
|
||||
fn block_on<F: std::future::Future>(future: F) -> F::Output {
|
||||
use std::sync::Arc;
|
||||
use std::task::{Context, Poll, Wake, Waker};
|
||||
|
||||
struct Unpark(std::thread::Thread);
|
||||
|
||||
impl Wake for Unpark {
|
||||
fn wake(self: Arc<Self>) {
|
||||
self.0.unpark();
|
||||
}
|
||||
|
||||
fn wake_by_ref(self: &Arc<Self>) {
|
||||
self.0.unpark();
|
||||
}
|
||||
}
|
||||
|
||||
let waker = Waker::from(Arc::new(Unpark(std::thread::current())));
|
||||
let mut context = Context::from_waker(&waker);
|
||||
let mut future = std::pin::pin!(future);
|
||||
|
||||
loop {
|
||||
match future.as_mut().poll(&mut context) {
|
||||
Poll::Ready(output) => return output,
|
||||
Poll::Pending => std::thread::park(),
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
#[cfg(test)]
|
||||
mod tests {
|
||||
use super::*;
|
||||
|
||||
#[test]
|
||||
fn failure_line_is_greppable() {
|
||||
let failure = Failure {
|
||||
stage: "request-device",
|
||||
detail: "no device request succeeded".to_owned(),
|
||||
};
|
||||
let text = failure.describe();
|
||||
assert!(
|
||||
text.starts_with("FAILED stage=request-device error="),
|
||||
"{text}"
|
||||
);
|
||||
assert!(text.contains("no device request succeeded"), "{text}");
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn verdict_line_lists_the_three_facts() {
|
||||
let verdict = Verdict {
|
||||
adapter: "Apple M1".to_owned(),
|
||||
device_type: "IntegratedGpu",
|
||||
backend: "Metal".to_owned(),
|
||||
};
|
||||
let text = verdict.describe();
|
||||
assert!(text.contains("adapter=\"Apple M1\""), "{text}");
|
||||
assert!(text.contains("type=IntegratedGpu"), "{text}");
|
||||
assert!(text.contains("backend=Metal"), "{text}");
|
||||
}
|
||||
|
||||
/// 没编 wgpu 的构建：预检必须说清原因，而不是一句「失败」。
|
||||
#[cfg(not(feature = "gpu"))]
|
||||
#[test]
|
||||
fn unbuilt_gpu_names_the_reason() {
|
||||
let failure = run().unwrap_err();
|
||||
assert_eq!(failure.stage, "not-compiled");
|
||||
assert!(failure.detail.contains("wgpu"), "{}", failure.detail);
|
||||
}
|
||||
}
|
||||
Reference in new issue
Block a user