Main Menu Shell for Openvario

这是一个用于替换官方Openvario镜像中提供的默认主菜单的替代品。它用Python实现，比基于shell脚本的默认版本提供了更多的可扩展性和更丰富的用户界面。

本项目目标是提供一个用户界面，用于管理Openvario设备，使其

• 用户友好 -- 响应式，可以使用遥控杆或最小输入控制进行操作。
• 功能丰富 -- 允许管理设备的各个方面，包括连接的设备、文件等。
• 可扩展 -- 允许集成第三方应用程序。
• 易于开发和测试 -- 用Python编写，可以在没有Openvario设备的情况下进行测试。

功能

• 运行XCSoar，可选地配置超时后自动运行
• 选择首选的XCSoar语言
• 选择屏幕方向、屏幕亮度、字体大小等
• 校准触摸屏和传感器
• 使用响应式UI将飞行记录下载到USB闪存驱动器
• 将文件复制到和从USB闪存驱动器，备份和恢复配置
• 与GPS接收器连接时，与GPS时间同步系统时间
• 与第三方应用程序集成（如Competition Manager）

安装

最简单的方法是在连接到互联网的Openvario设备上使用opkg包管理器安装。

wget https://raw.githubusercontent.com/kedder/openvario-shell/master/scripts/openvario-shell-install.sh -O - | sh

执行此命令后，应该可以找到 ovshell 命令。下次 Openvario 启动时会自动启动。

如果您不喜欢它，想要回到原版的 Openvario 菜单，请运行此命令

wget https://raw.githubusercontent.com/kedder/openvario-shell/master/scripts/openvario-shell-uninstall.sh -O - | sh

开发

开发 ovshell 并不需要拥有或访问 Openvario 设备。唯一的要求是 Python 3.7 或更高版本和终端模拟器，这些在 MacOS 或 Linux 操作系统上都可以轻松获得。Windows 系统也有许多免费的选项。

设置开发环境

ovshell 使用 pipenv 来管理依赖和开发环境。如果您还没有安装，可以使用以下命令进行安装：

pip install pipenv  # or pip3 if you don't have "pip"

检出源代码后，使用 cd 命令进入 openvario-shell 目录，然后运行

pipenv shell
pipenv sync

之后，您的开发环境就准备好了，您应该能够运行应用程序

ovshell

您可以通过在项目目录中的 .env 文件中提供一些选项来调整一些设置。您可以复制示例文件 sample.env 到 .env 并在那里调整值。

开发工具

ovshell 使用各种工具来检查代码质量。它们通常可以通过 make 程序获得。最有用的是以下这些：

• make test - 运行测试套件
• make coverage - 运行测试套件并显示测试覆盖率统计信息
• make mypy - 使用静态类型检查器检查源代码
• make black - 将源代码重格式化以匹配代码风格