Embark 项目启动与配置教程

1. 项目的目录结构及介绍

Embark 项目是一个用于区块链去中心化应用（DApp）开发的开源框架。以下是项目的目录结构及各部分的简要介绍：

embark/
├── contracts/                # 存储智能合约的目录
├── dapp/                     # 存储前端代码的目录
├── embark.json               # Embark 配置文件
├── package.json              # 项目依赖及脚本配置
├── scripts/                  # 自定义脚本目录
├── test/                     # 测试代码目录
├── tmp/                      # 临时文件目录
└── trie/                     # 存储区块链数据的相关文件

• contracts/: 包含所有的智能合约代码，通常是 .sol 文件。
• dapp/: 存储前端代码，包括 HTML、CSS、JavaScript 文件，以及可能的静态资源。
• embark.json: Embark 的配置文件，用于设置 Embark 的行为和运行参数。
• package.json: 包含项目的依赖项和运行脚本。
• scripts/: 存储自定义脚本，可以用于执行特定的任务或流程。
• test/: 存储测试代码，用于验证智能合约和前端代码的功能。
• tmp/: 存储临时的构建文件和中间文件。
• trie/: 存储与区块链交互时生成的数据。

2. 项目的启动文件介绍

项目的启动主要依赖于 package.json 文件中定义的脚本。以下是常见的启动脚本：

"scripts": {
  "start": "embark run",
  "build": "embark build",
  "test": "embark test"
}

• start: 运行 Embark 的开发服务器。该命令将启动本地节点，编译智能合约，并在浏览器中启动前端应用程序。
• build: 构建项目，用于生产环境。该命令将编译智能合约，生成前端应用程序的静态文件，并准备部署。
• test: 运行测试脚本。该命令将执行智能合约的测试用例。

要在本地启动项目，你可以在项目根目录下运行以下命令：

npm start

这将启动 Embark 的开发服务器，并自动在默认浏览器中打开前端应用程序。

3. 项目的配置文件介绍

embark.json 是 Embark 的配置文件，它允许你自定义项目的行为。以下是一些常见的配置项：

{
  "version": 2,
  "pipelines": {
    "default": {
      "loader": {
        "appDir": "dapp/dist",
        "enabled": true
      }
    }
  },
  "contracts": {
    "MyContract": {
      "file": "contracts/MyContract.sol"
    }
  },
  "blockchain": {
    "accounts": {
      "default": {
        "balance": "1000000 ether"
      }
    }
  },
  "consensus": "proof_of_authority",
  "networks": {
    "development": {
      "host": "localhost",
      "port": 8545,
      "accounts": [
        "0x..."
      ]
    }
  },
  "dappConnection": [
    "$DAPP_connection"
  ]
}

• pipelines: 定义了 Embark 的构建和部署管道配置。
• contracts: 指定了智能合约的文件位置和名称。
• blockchain: 配置区块链网络的基本信息，例如默认账户的余额。
• consensus: 指定区块链网络的共识算法。
• networks: 定义了不同的网络环境配置，例如开发环境和测试网络。
• dappConnection: 设置了 DApp 连接到区块链的方式。

通过编辑 embark.json 文件，你可以根据项目的具体需求进行相应的配置调整。