GHCJS 项目安装与使用教程

1. 项目目录结构及介绍

GHCJS 项目的目录结构如下：

ghcjs/
├── data/
├── include/
├── inplace/
│   └── bin/
├── lib/
├── src-bin/
├── src-platform/
├── src/
├── test/
├── utils/
├── .gitignore
├── .gitmodules
├── hlint.yaml
├── travis.yml
├── Dockerfile
├── HACKING.markdown
├── INSTALL.windows
├── LICENSE
├── README.markdown
├── Setup.hs
├── cabal.project
├── ghcjs.cabal
├── sources.txt
└── stack.yaml

目录介绍

• data/: 包含项目的数据文件。
• include/: 包含项目的头文件。
• inplace/bin/: 包含编译后的可执行文件。
• lib/: 包含项目的库文件。
• src-bin/: 包含项目的二进制源文件。
• src-platform/: 包含平台相关的源文件。
• src/: 包含项目的主要源代码。
• test/: 包含项目的测试代码。
• utils/: 包含项目的实用工具脚本。
• .gitignore: Git 忽略文件配置。
• .gitmodules: Git 子模块配置。
• hlint.yaml: HLint 配置文件。
• travis.yml: Travis CI 配置文件。
• Dockerfile: Docker 配置文件。
• HACKING.markdown: 开发指南。
• INSTALL.windows: Windows 安装指南。
• LICENSE: 项目许可证。
• README.markdown: 项目介绍和使用说明。
• Setup.hs: Cabal 安装脚本。
• cabal.project: Cabal 项目配置文件。
• ghcjs.cabal: GHCJS 的 Cabal 配置文件。
• sources.txt: 源文件列表。
• stack.yaml: Stack 配置文件。

2. 项目启动文件介绍

GHCJS 项目的启动文件主要包括以下几个：

• ghcjs: 主程序，用于将 Haskell 代码编译为 JavaScript。
• ghcjs-boot: 用于构建 GHCJS 的启动库，如 ghc-prim、base 和 template-haskell。

启动步骤

1. 克隆项目:

   git clone https://github.com/ghcjs/ghcjs.git
   cd ghcjs
   

2. 初始化子模块:

   git submodule update --init --recursive
   

3. 构建编译器:

   cabal v2-install --overwrite-policy=always --install-method=copy --installdir=inplace/bin
   

4. 启动 GHCJS:

   source ~/emsdk/emsdk_env.sh
   ./inplace/bin/ghcjs-boot -s ./lib/boot
   

3. 项目配置文件介绍

cabal.project

cabal.project 文件用于配置 Cabal 项目，指定项目依赖和构建选项。

packages: .

stack.yaml

stack.yaml 文件用于配置 Stack 项目，指定项目依赖和构建选项。

resolver: lts-18.0
packages:
- .

ghcjs.cabal

ghcjs.cabal 文件是 GHCJS 的主要配置文件，定义了项目的元数据、依赖关系和构建选项。

name:                ghcjs
version:             9.0.1
synopsis:            Haskell to JavaScript compiler
description:         GHCJS is a Haskell to JavaScript compiler based on GHC.
license:             MIT
license-file:        LICENSE
author:              The GHCJS Contributors
maintainer:          [e-mail]
build-type:          Simple
cabal-version:       >=1.10

library
  exposed-modules:
    GHCJS.Prim
    GHCJS.Types
  build-depends:
    base >=4.14 && <4.15
  hs-source-dirs:
    src
  default-language:   Haskell2010

通过以上配置文件，可以对 GHCJS 项目进行构建和启动。