在模拟器中运行 UWP 应用

2025-05-30

适用于 UWP 应用的 Visual Studio 模拟器是模拟 UWP 应用的桌面应用程序。通常，需要在本地计算机、连接的设备或远程计算机上进行调试。但是，在某些情况下，你可能希望使用 Visual Studio 模拟器来模拟不同的物理屏幕大小和分辨率。还可以模拟常见的触摸和旋转事件，以及模拟网络连接属性。

模拟器提供了一个环境，你可以在其中设计、开发、调试和测试 UWP 应用。但是，在将应用发布到 Microsoft Store 之前，应在实际设备上测试应用。

适用于 UWP 应用的 Visual Studio 模拟器不会在本地计算机上的独立环境中运行。因此，模拟器中发生的错误（如不可恢复的系统范围错误）也可能会影响整个计算机。

将模拟器设置为目标

若要在模拟器中运行 UWP 应用，请从调试器标准工具栏上的“开始调试”按钮旁边的下拉列表中选择模拟器。只有当您的应用的 目标平台最低版本 小于或等于开发计算机上的操作系统时，此选项才可用。

在模拟器VSRUN_F5_Simulator中运行

选择交互模式

可以选择以下交互模式：

鼠标模式：将交互模式设置为鼠标手势。鼠标手势包括单击、双击和拖动。
启动触摸仿真：将交互模式设置为单个手指的触摸手势。单指事件包括点击、拖动和轻扫。

单个目标图标指示模拟器中事件的位置。使用鼠标定位指针。

按鼠标左键激活触摸模式。例如，单击按钮模拟点击，或在拖动或轻扫时按住按钮。

收缩和缩放

将交互模式设置为两根手指的收缩和缩放手势。

模拟器双指目标

双目标图标指示设备屏幕上两根手指的位置。

移动鼠标以将图标放置在设备屏幕上的对象上。
向后或向前旋转鼠标滚轮，以在收缩或缩放之前更改两根手指的模拟距离。

收缩、缩放和旋转目标

按下左键，向后（朝自己方向）旋转滚轮以放大。
按左按钮，向前旋转鼠标滚轮（远离你）缩小（缩放）。

对象旋转

触摸仿真旋转按钮使用两根手指将交互模式设置为旋转手势。

移动鼠标以将图标放置在设备屏幕上的对象上。向后或向前旋转鼠标滚轮以在旋转对象之前更改两根手指的模拟方向。
按左按钮，向后旋转方向盘（朝你方向），以逆时针旋转对象。旋转鼠标滚轮时，两个目标图标中的一个会围绕另一个图标旋转，以指示旋转的相对大小。
按左按钮向前旋转鼠标滚轮（远离你），以顺时针旋转对象。

启用或禁用 Always On Top 模式

可以将模拟器窗口设置为始终位于其他窗口之上。 “ 切换顶部窗口 ”按钮启用或禁用模拟器窗口的 “始终处于顶部 ”模式。

更改设备方向

通过将模拟器向任意方向旋转90度，可以在纵向与横向之间切换设备的方向。

注释

模拟器不尊重项目的 DisplayProperties.AutoRotationPreferences 属性。例如，如果您的项目将方向设置为Landscape，然后将模拟器旋转到纵向，则模拟器的显示图像也将旋转并调整大小。在实际设备上测试这些设置。

注释

如果旋转模拟器，使得模拟器的一个边缘大于显示屏，那么模拟器的大小会自动调整以适应屏幕。如果再次旋转模拟器，模拟器的大小不会调整为其原始大小。

更改模拟屏幕大小和分辨率

若要更改模拟的屏幕大小和分辨率，请选择调色板上的 “更改分辨率 ”按钮，然后从列表中选择新的大小和分辨率。

屏幕大小和分辨率列为 屏幕宽度英寸、像素宽度 X 像素高度。请注意，屏幕大小和分辨率均为模拟效果。模拟器上的位置坐标将转换为所选设备大小和分辨率。

注释

可以在应用中保存位图图像的缩放版本，Windows 将为当前缩放加载正确的图像。但是，如果更改模拟器分辨率，以便 Windows 选取其他图像以适应分辨率，则必须停止并重启调试会话才能查看新映像。

捕获要提交到 Microsoft Store 的应用的屏幕截图

将应用提交到 Microsoft 应用商店时，必须包含应用的屏幕截图。

注释

屏幕截图保存在模拟器的当前分辨率下。若要更改分辨率，请选择 “更改分辨率 ”按钮。

若要从模拟器创建应用的屏幕截图，请选择“ 捕获屏幕截图到剪贴板 ”按钮。
若要设置屏幕截图所在的位置，请选择 “屏幕截图设置 ”按钮，然后从快捷菜单中选择位置。

模拟网络连接属性

通过保持对网络连接成本或数据计划状态更改的认识，使应用能够使用此信息避免漫游或超出指定数据传输限制，从而帮助应用用户管理按流量计费的网络连接成本。 Windows.Networking.Connectivity API 允许你响应指示的 NetworkStatusChanged 和 TriggerType 事件。请参阅快速入门：管理按流量计费的网络成本约束。

若要调试或测试网络成本感知代码，模拟器可以模拟通过 GetInternetConnectionProfile 返回的 ConnectionProfile 对象公开的网络的属性。

模拟网络属性：

在模拟器工具栏上，选择 “更改网络属性 ”按钮。
在“ 设置网络属性 ”对话框中，选择“ 使用模拟网络属性”。

清除复选框以删除模拟并返回到当前连接的接口的网络属性。
输入模拟网络的 配置文件名称 。建议使用唯一名称，该名称可用于标识 ConnectionProfile 对象的 ProfileName 属性中的模拟。
从“网络成本类型”列表中为配置选择NetworkCostType值。
在 “数据限制状态标志” 列表中，可以将 ApproachingDataLimit 属性或 OverDataLimit 属性设置为 true，也可以选择 “数据限制” ，将这两个值设置为 false。
在 “漫游状态” 列表中，设置 “漫游 ”属性。
选择“设置属性”以通过触发前台 NetworkStatusChanged 事件和 NetworkStateChange 类型的后台 SystemTrigger 来模拟网络属性。