Erjang 项目技术文档

1. 安装指南

环境要求

• Java 7 或更高版本
• Perl 5.10 或更高版本

安装步骤

1. 克隆项目仓库到本地：

   git clone https://github.com/trifork/erjang.git
   

2. 进入项目目录：

   cd erjang
   

3. 使用 ant 命令构建项目：

   ant alljar
   

   构建成功后，会生成 erjang-R16B01.jar 文件。

2. 项目的使用说明

启动 Erjang

运行以下命令启动 Erjang：

java -jar erjang-R16B01.jar

启动后，您将进入 Erlang 的 Eshell 环境，可以执行 Erlang 代码。

示例

1> 2+3.
5
2> 1/0.
** exception error: an error occurred when evaluating an arithmetic expression
     in operator  '/'/2
        called as 1 / 0

功能支持

• 支持 Erlang/OTP 启动到 Eshell (ej 命令)
• 提供 GUI 控制台 (ejc 命令)，支持 ^G 和行编辑
• 支持 Erlang 分布式、TCP/IP、端口命令（将标准输入输出重定向到外部进程）
• 支持编译器 (c(foo) 命令)
• 支持 mnesia 分布式运行
• 支持 mochiweb 和 webmachine 运行（暂不支持加密）
• 支持 rabbitmq 和 riak 启动，但尚未准备好用于生产环境

已知问题

• 部分 BIF（内置函数）尚未完全实现
• 部分 OTP 模块需要 NIF 或链接驱动程序，这些功能尚未完全实现

3. 项目API使用文档

核心API

• erjang.NotImplemented：用于标记尚未实现的功能
• ej：启动 Erlang Eshell
• ejc：启动 GUI 控制台

示例

1> 2+3.
5
2> 1/0.
** exception error: an error occurred when evaluating an arithmetic expression
     in operator  '/'/2
        called as 1 / 0

4. 项目安装方式

构建项目

使用 ant 命令构建项目：

ant alljar

构建成功后，会生成 erjang-R16B01.jar 文件。

配置

Erjang 会自动从 $PATH 中查找 erl 二进制文件，并推断 beam 文件的位置。您也可以通过 -root 参数指定 Erlang 根目录。

运行

运行以下命令启动 Erjang：

java -jar erjang-R16B01.jar

运行时，Erjang 会将翻译后的 Erlang 模块缓存到 ~/.erjang 目录中。如果出现问题，可以删除该目录以强制重新编译。

---

通过以上文档，您应该能够顺利安装、配置和使用 Erjang 项目。如果在使用过程中遇到问题，请参考项目 Wiki 或联系开发团队获取帮助。