解决flutter-pi在DSI面板上的分辨率与旋转问题

问题背景

在使用flutter-pi项目时，开发者可能会遇到DSI面板显示分辨率不正确的问题。具体表现为：虽然操作系统终端显示正确的分辨率（如1364x768像素），但Flutter应用运行时却显示为错误的逻辑分辨率（如733x413像素）。

分辨率问题分析

flutter-pi默认会假设所有连接的DSI显示器都是树莓派7英寸屏幕（800x480分辨率）。当实际连接的显示器分辨率不同时，就会出现显示比例失调的问题。

解决方案

1. 使用--dimensions参数：通过指定显示器的物理尺寸（毫米单位）来正确计算像素密度。例如对于344mm×193mm的屏幕，应使用：

   flutter-pi --dimensions 344,193
   

2. 未来改进：项目维护者表示将修改默认行为，只有当分辨率确实是800x480时才假设是7英寸屏幕，其他分辨率将采用更合理的默认值。

屏幕旋转问题

另一个常见问题是Flutter应用的显示方向可能与操作系统不一致。例如应用默认旋转90度显示。

解决方案

1. 使用-r参数：可以通过旋转参数强制调整显示方向，例如：

   flutter-pi -r 90
   

2. 注意SystemChrome.setPreferredOrientations：有开发者报告此API在flutter-pi中可能不生效，建议优先使用命令行参数控制方向。

技术原理

flutter-pi通过DRM/KMS接口与Linux显示系统交互。分辨率问题源于：

• 物理像素与逻辑像素的转换
• 默认的DPI假设不符合实际硬件
• 显示方向信息在显示管道中的传递

最佳实践建议

1. 始终使用--dimensions参数明确指定显示器物理尺寸
2. 在开发初期就确定好显示方向，并通过-r参数固定
3. 对于非标准分辨率显示器，建议在flutter-pi启动参数中明确所有显示参数
4. 考虑在应用中添加显示参数检测逻辑，适配不同运行环境

通过正确配置这些参数，可以确保Flutter应用在各种DSI面板上都能获得最佳的显示效果。