首页
/ Boo 编程语言技术文档

Boo 编程语言技术文档

2024-12-23 18:29:47作者:薛曦旖Francesca

1. 安装指南

Windows

  1. 安装 .NET 4.5。
  2. 下载并安装 Visual C++ Build Tools,因为Boo使用NAnt构建,而NAnt需要从源代码构建,这需要NMake,NMake随Visual C++ Build Tools一起提供。

Mac/Linux

  1. 安装Mono 4.2.x版本(推荐使用4.2.4版本)。
  2. 确保系统已安装Bash。

2. 项目的使用说明

在项目目录中,你可以找到以下结构:

  • docs/BooManifesto.sxw:项目的简要描述和目标。
  • extras/boox:一个可以帮助你熟悉语言的小工具。
  • src/:包含运行时和编译器组件的所有源代码。
  • tests/:包含所有单元测试。
  • testcases/integration:包含关于语言特性的信息。
  • lib/:包含项目依赖,例如antlr。
  • bin/:包含通过所有测试的最新版本,可用于重建系统。

运行和编译代码

  • 运行Boo脚本:

    booi <script> [args]
    

    例如:

    booi examples/hw.boo
    
  • 从标准输入读取:

    booi -
    
  • 生成.NET程序集:

    booc -output:build/hello.exe examples/hw.boo
    
  • 查看编译器对你的代码应用了哪些转换:

    booc -p:boo examples/replace.boo
    

3. 项目API使用文档

本项目API使用文档请参考官方GitHub仓库的wiki页面。

4. 项目安装方式

使用bootstrap脚本来安装所需的构建工具到build-tools目录,构建脚本将从此目录执行它们:

Windows

在x86 Native Tools Command Prompt中运行以下PowerShell脚本:

powershell .\build-tools\bootstrap

Mac/Linux

./build-tools/bootstrap

对于Mac用户,如果当前版本不是Mono 4.2.x,可以在运行bootstrap脚本时指定版本,构建脚本将使用指定版本的Mono:

./build-tools/bootstrap [<mono version>]

构建项目:

# Windows (PowerShell)
.\nant [<target>]

# Mac/Linux
./nant [<target>]

没有指定目标时,将增量构建代码和测试。要完全清理并从头开始构建项目,请运行“rebuild”目标。这将导致ast类和解析器被重新生成(需要一个java虚拟机)。

运行单元测试:

# Windows (PowerShell)
.\nunit

# Mac/Linux
./nunit

构建和测试整个项目,与CI构建相同:

# Windows (PowerShell)
.\ci

# Mac/Linux
./ci

更多信息和社区支持,请访问Boo开发Google群组和Boo社区Discord。贡献者信息请查看GitHub仓库的贡献者列表。

登录后查看全文
热门项目推荐
相关项目推荐