WinUI 3类库中引用图片资源失效问题求助

核心原因 #

类库控件用相对路径引用自身资源时，在被主项目引用后会失效——运行时资源查找上下文是主项目（项目B），而非类库（项目A），必须明确指定资源所在的类库包路径。

具体解决方案 #

1. 确认图片的生成配置 #

在项目A中选中logo-256.png，在属性窗口设置：

• 生成操作：Content
• 复制到输出目录：如果较新则复制（或始终复制）
  这一步保证图片会被打包到类库输出目录，供主项目访问。

2. 在MyControl的XAML中用包URI引用图片 #

替换原有相对路径，使用类库专属的包URI格式：

<Image Source="ms-appx:///[项目A的程序集名称]/Assets/logo-256.png" />

注意：

• 将[项目A的程序集名称]替换为实际类库的程序集名（可在项目A的「属性→应用程序→程序集名称」中查看）
• URI开头为ms-appx:///（三个斜杠），第三个斜杠后接程序集名

3. （可选）代码中设置图片源 #

若需在代码里绑定图片，同样用包URI：

myImage.Source = new BitmapImage(new Uri("ms-appx:///MyWinUI3Library/Assets/logo-256.png"));

验证步骤 #

1. 重新编译项目A和项目B
2. 运行项目B，检查MyControl中的图片是否正常显示

常见误区 #

• 不要只用相对路径：相对路径在类库内部调试可能有效，但主项目运行时会从自身目录查找，找不到类库中的图片
• 不要漏设「复制到输出目录」：若图片未被复制到类库输出目录，即使路径正确也无法加载

内容的提问来源于stack exchange，提问作者Rahmann Dellal