MicroHs 项目使用教程

MicroHs 项目使用教程

MicroHs Haskell implemented with combinators 项目地址: https://gitcode.com/gh_mirrors/mi/MicroHs

1. 项目目录结构及介绍

MicroHs 是一个使用 Haskell 实现的编译器，它将 Haskell 的一个扩展子集编译为可在微控制器上运行的代码。项目的目录结构如下：

• boards/：包含针对不同开发板的示例代码，例如 STM32F407G-DISC1 开发板。
• cpphscompat/：提供与 C++ 代码兼容性的支持。
• cpphssrc/：源代码目录，包含编译器的主要实现。
• doc/：存放项目文档，包括 Haskell Symposium 2024 的演讲稿。
• generated/：生成文件的存放目录。
• ghc/：针对 GHC 编译器的一些额外配置和文件。
• hugs/：与 Hugs 编译器相关的文件。
• lib/：库文件目录。
• mhs/：MicroHs 编译器相关文件。
• paths/：路径配置文件。
• src/：源代码目录，包含 Haskell 源文件。
• tests/：单元测试和示例代码目录。
• unicode/：与 Unicode 相关的文件。
• .gitattributes：Git 属性配置文件。
• .gitignore：Git 忽略文件配置。
• .gitmodules：Git 子模块配置文件。
• Example.hs：示例 Haskell 源文件。
• LICENSE：项目许可证文件。
• Makefile：Makefile 文件，用于构建项目。
• Makefile.old：旧版本的 Makefile 文件。
• Makefile.windows：Windows 系统下的 Makefile 文件。
• MicroHs.cabal：Cabal 配置文件，用于构建项目。
• README.md：项目自述文件。
• TODO：待办事项文件。
• updateversion.sh：更新版本号的脚本文件。

2. 项目的启动文件介绍

项目的启动文件是 Example.hs，这是一个 Haskell 模块，其中定义了一个简单的阶乘函数 fac 和一个 main 函数，main 函数用于演示如何调用 fac 函数并打印结果。

module Example (main) where

fac :: Int -> Int
fac 0 = 1
fac n = n * fac (n - 1)

main :: IO ()
main = do
    let rs = map fac [1, 2, 3, 10]
    putStrLn "Some factorials"
    print rs

要编译和运行这个示例，你需要首先确保编译器已经构建完成，然后使用以下命令编译：

bin/mhs Example -oEx

这将生成一个名为 Ex 的可执行文件，可以通过以下命令运行：

./Ex

输出结果将是：

Some factorials
[1,2,6,3628800]

3. 项目的配置文件介绍

项目的配置文件主要是 Makefile 和 MicroHs.cabal。

• Makefile：这个文件包含了构建项目所需的所有指令。它定义了不同的目标，例如编译编译器、运行测试、安装编译器等。

• MicroHs.cabal：这是 Cabal 的配置文件，用于描述 Haskell 包的结构和依赖。它包含了编译器需要的所有依赖、构建参数和指令。

在使用项目之前，你可能需要根据你的开发环境调整 Makefile 中的编译器和链接器选项。此外，如果你需要自定义项目的配置，可以通过修改 MicroHs.cabal 文件来实现。

MicroHs Haskell implemented with combinators 项目地址: https://gitcode.com/gh_mirrors/mi/MicroHs