图像是应用导航、可用性和品牌的关键部分。 但是，每个平台都有不同的映像要求，这些要求通常涉及在不同的分辨率上创建多个版本的每个映像。 因此，每个平台通常必须多次复制单个映像，分辨率不同，生成的图像必须在每个平台上使用不同的文件名和文件夹约定。

在 .NET 多平台应用 UI (.NET MAUI) 应用项目中，可以在应用项目中的单个位置指定图像，并在生成时自动将其大小调整为目标平台和设备的正确分辨率，并添加到应用包。 这可以避免为每个平台手动复制映像和命名映像。 默认情况下，位图 (非矢量) 图像格式（包括动画 GIF）不会由 .NET MAUI 自动调整大小。

.NET MAUI 图像可以使用任何标准平台图像格式，包括可缩放矢量图形 (SVG) 文件。

重要

.NET MAUI 将 SVG 文件转换为 PNG 文件。 因此，将 SVG 文件添加到 .NET MAUI 应用项目时，应从具有.png扩展名的 XAML 或 C# 引用该文件。 对 SVG 文件的唯一引用应位于项目文件中。

通过将图像拖到项目的 Resources\Images 文件夹中，可以将图像添加到应用项目中，其中其生成操作将自动设置为 MauiImage。 这会在项目文件中创建相应的条目：

注意

还可以将图像添加到应用项目的其他文件夹中。 但是，在这种情况下，必须在“属性”窗口中手动将生成操作设置为 MauiImage。

若要遵守 Android 资源命名规则，图像文件名必须为小写，以字母字符开头和结尾，并且仅包含字母数字字符或下划线。 有关详细信息，请参阅有关 developer.android.com 的应用资源概述 。

通过将特性设置为 BaseSize 8 可分割的值来指定图像的基大小：

特性的值 BaseSize 表示图像的基线密度，并且实际上是图像的 1.0 比例系数， (代码中通常用于指定派生所有其他密度大小的图像大小) 。 此值将用于确保图像的大小正确调整为不同的显示密度。 如果未指定 BaseSize 位图图像，则不会调整图像大小。 如果未为矢量图像指定 BaseSize 值，则假定 SVG 中指定的尺寸为基本大小。 若要停止重设大小的矢量图像，请将 Resize 属性设置为 false：

若要向图像添加淡色，如果具有图标或简单图像，希望以不同颜色呈现给源的图像，请 TintColor 设置属性：

还可以指定图像的背景色：

可以在十六进制或 .NET MAUI 颜色中指定颜色值。 例如， Color="Red" 有效。

在生成时，可将映像大小调整为目标平台和设备的正确分辨率。 然后将生成的图像添加到应用包。