TLA+ 项目教程

1. 项目目录结构及介绍

TLA+ 项目的目录结构如下：

tlaplus/
├── conf/
├── tlaplus/
│   ├── src/
│   ├── test/
│   ├── README.md
│   └── ...
├── tlapm/
│   ├── src/
│   ├── test/
│   ├── README.md
│   └── ...
├── vscode-tlaplus/
│   ├── src/
│   ├── test/
│   ├── README.md
│   └── ...
├── Examples/
│   ├── spec1/
│   ├── spec2/
│   ├── README.md
│   └── ...
├── CommunityModules/
│   ├── module1/
│   ├── module2/
│   ├── README.md
│   └── ...
└── ...

目录介绍

• conf/: 包含项目的配置文件和相关资源。
• tlaplus/: TLA+ 核心项目，包含 TLC 模型检查器的源代码和测试文件。
• tlapm/: TLA Proof Manager 项目，包含 TLA+ 证明管理器的源代码和测试文件。
• vscode-tlaplus/: Visual Studio Code 扩展项目，包含 TLA+ 语言支持的源代码和测试文件。
• Examples/: 包含各种 TLA+ 规范的示例。
• CommunityModules/: 包含社区贡献的 TLA+ 模块和操作符。

2. 项目启动文件介绍

TLA+ 项目的主要启动文件位于 tlaplus/ 目录下。以下是一些关键的启动文件：

• tlaplus/src/TLC.java: TLC 模型检查器的主启动文件。
• tlaplus/src/TLAplusToolbox.java: TLA+ Toolbox 的主启动文件。
• vscode-tlaplus/src/extension.ts: Visual Studio Code 扩展的主启动文件。

启动步骤

1. TLC 模型检查器:

   • 进入 tlaplus/src/ 目录。
   • 运行 java TLC 启动 TLC 模型检查器。

2. TLA+ Toolbox:

   • 进入 tlaplus/src/ 目录。
   • 运行 java TLAplusToolbox 启动 TLA+ Toolbox。

3. Visual Studio Code 扩展:

   • 进入 vscode-tlaplus/src/ 目录。
   • 运行 npm install 安装依赖。
   • 运行 npm run compile 编译扩展。
   • 在 Visual Studio Code 中加载扩展并启动。

3. 项目配置文件介绍

TLA+ 项目的配置文件主要位于 conf/ 目录下。以下是一些关键的配置文件：

• conf/tlc.properties: TLC 模型检查器的配置文件，包含模型检查的各种参数设置。
• conf/toolbox.properties: TLA+ Toolbox 的配置文件，包含 IDE 的各种参数设置。
• conf/vscode-extension.json: Visual Studio Code 扩展的配置文件，包含扩展的各种参数设置。

配置文件示例

# tlc.properties
modelCheckTimeout=300
maxThreads=4

# toolbox.properties
autoSaveInterval=60
theme=dark

// vscode-extension.json
{
  "name": "TLA+",
  "version": "1.0.0",
  "publisher": "tlaplus",
  "engines": {
    "vscode": "^1.50.0"
  },
  "contributes": {
    "languages": [{
      "id": "tla",
      "extensions": [".tla"]
    }]
  }
}

通过以上配置文件，可以自定义 TLA+ 项目的行为和功能。