Subsurface 开源潜水日志软件安装与使用教程

Subsurface 开源潜水日志软件安装与使用教程

subsurfaceThis is the official upstream of the Subsurface divelog program项目地址:https://gitcode.com/gh_mirrors/su/subsurface

1. 项目目录结构及介绍

在克隆或下载 subsurface 项目后，您将看到一个典型的开源项目目录结构：

.
├── LICENSE          # 许可证文件
├── README.md        # 项目简介
├── CHANGELOG        # 更新日志
├── src/             # 源代码目录
│   ├── subsurface/  # 主要应用程序代码
│   ├── common/      # 公共库和工具
│   └── ...           # 其他相关源代码子目录
├── build/           # 构建输出目录（通常在编译时自动生成）
└── ...               # 可能包括其他配置脚本、测试或其他辅助文件

src/ 目录包含了项目的主体代码，其中 subsurface/ 存放应用程序的核心逻辑，而 common/ 包含通用的功能模块。

2. 项目的启动文件介绍

Subsurface 的主要启动文件通常是 src/sui/sui_main.cpp。这个文件作为程序入口点，负责初始化应用程序并加载所需的组件。在实际运行中，编译后的二进制文件（如 subsurface 或 subsurface.exe）是直接执行的，不需要用户直接操作源码中的启动文件。

在Linux或MacOS上，可以使用以下命令从源代码构建并运行Subsurface：

$ cd path/to/subsurface
$ mkdir build && cd build
$ qmake ..
$ make -j$(nproc)
$ ./subsurface    # 运行构建结果

在Windows上，可能需要使用Visual Studio或MinGW等开发环境来编译并运行。

3. 项目的配置文件介绍

Subsurface 配置文件通常位于用户的主目录下，隐藏的.subsurface文件夹内。具体的路径取决于您的操作系统：

• Linux/MacOS：

  ~/.subsurface/
  

• Windows：

  %APPDATA%\Subsurface\
  

此目录下可能包含如下文件：

• config.json：存储用户偏好设置，如界面语言、字体大小等。
• logbook.sql：潜水日志数据库文件，保存用户的潜水记录。
• cloud.yaml：如果启用了云同步，这将包含相关的配置信息。

若需更改配置，直接编辑 config.json 文件，但请注意保持JSON格式正确。对于其他数据更改，建议使用Subsurface的图形用户界面进行操作，以避免破坏数据格式。

---

以上是Subsurface的基本安装与使用介绍。由于Subsurface是一款图形化的跨平台应用，大部分配置和功能通过应用程序内的菜单和对话框完成。更多详细功能和高级使用的教程，可以参考项目的官方文档或参与社区论坛。

subsurfaceThis is the official upstream of the Subsurface divelog program项目地址:https://gitcode.com/gh_mirrors/su/subsurface