Fortran Package Manager (fpm) 安装与使用教程

1. 项目目录结构及介绍

Fortran Package Manager (fpm) 的目录结构如下：

fpm/
├── fpm           # 包含fpm命令的主要源代码
├── tests         # 单元测试和集成测试
├── examples      # 示例项目
├── manifests     # 默认的包清单模板
└── doc           # 文档资料

• fpm: 该目录包含了构建和管理Fortran项目的主程序。
• tests: 测试文件，用于验证fpm功能的正确性。
• examples: 提供了一些示例项目，帮助用户了解如何使用fpm创建和管理项目。
• manifests: 包含默认的项目配置模板，这些模板定义了项目的基本信息。
• doc: 存放项目相关的文档和说明。

2. 项目的启动文件介绍

fpm 使用一个名为 fpm 的可执行脚本来进行操作。在安装后，这个脚本通常会被链接到系统的路径中，例如 /usr/local/bin/fpm，允许从任何目录执行。

主要的启动命令包括：

• fpm new <project_name>: 创建一个新的Fortran项目。
• fpm build: 构建项目（编译源代码）。
• fpm test: 运行项目的测试。
• fpm run: 直接运行项目（如果没有指定入口点，将尝试找到并运行main子程序）。
• fpm install: 将构建后的二进制文件安装到系统或指定位置。

要查看所有可用选项，可以使用 fpm --help 命令。

3. 项目的配置文件介绍

在每个使用fpm的Fortran项目中，都有一个名为 fpm.toml 的配置文件，它是项目的核心元数据描述。以下是一些基本配置项：

• [package]: 项目的基本信息，如name, version, description, author等。
• [dependencies]: 依赖的其他fpm包及其版本要求。
• [source]: 指定项目的源代码目录（相对于fpm.toml的位置）。
• [build】: 可选的构建指令，如编译器标志或者特定的构建步骤。
• [test】: 测试相关设置，比如测试源码目录和主测试程序的名称。

例如，一个简单的 fpm.toml 文件可能如下所示：

[package]
name = "my_project"
version = "0.1.0"
description = "A sample Fortran project managed by fpm"

[[sources]]
dir = "src"
kind = "src"

[dependencies]
gfortran >= "7.0.0"

在上述例子中，my_project 依赖于至少版本为 7.0.0 的 gfortran 编译器。

通过理解和定制这个配置文件，你可以精细地控制你的Fortran项目管理和构建流程。