Prerequisites - 必备组件¶

Before we begin, if you haven’t already done so, you may wish to check that you have all the prerequisites below installed on the platform(s) on which you’ll be developing blockchain applications and/or operating Hyperledger Fabric.

在我们开始之前，如果你还没有操作这一步，你不妨检查你是否已在将要开发区块链应用程序和/或运行Hyperledger Fabric的平台上安装了所有必备组件。

Install cURL - 安装cURL¶

Download the latest version of the cURL tool if it is not already installed or if you get errors running the curl commands from the documentation.

下载最新版本的 cURL 工具，如果尚未安装或如果你从文档中运行curl命令时出错。

Note

If you’re on Windows please see the specific note on `Windows: extras`_ below.

如果你使用的是Windows，请参阅特定说明如下 Windows extras - Windows附加

Docker and Docker Compose - Docker和Docker镜像¶

You will need the following installed on the platform on which you will be operating, or developing on (or for), Hyperledger Fabric:

MacOSX, *nix, or Windows 10: Docker Docker version 17.06.2-ce or greater is required.

Older versions of Windows: Docker Toolbox - again, Docker version Docker 17.06.2-ce or greater is required.

你将需要在将要运行或在/为Hyperledger Fabric开发的平台上安装以下内容：

MacOSX, *nix, 或 Windows 10系统: Docker Docker 要求17.06.2-ce 版本或更高。

Windows旧版系统: Docker Toolbox - 同样的，Docker 要求17.06.2-ce 版本或更高。

You can check the version of Docker you have installed with the following command from a terminal prompt:

你可以使用以下命令从终端提示检查已安装的Docker的版本：

docker --version

Note

Installing Docker for Mac or Windows, or Docker Toolbox will also install Docker Compose. If you already had Docker installed, you should check that you have Docker Compose version 1.14.0 or greater installed. If not, we recommend that you install a more recent version of Docker. Mac或Windows系统下安装Docker或Docker Toolbox将一并安装Docker镜像。如果你已安装Docker，则应检查是否已安装Docker镜像1.14.0版本或更高。如果没有，我们建议你安装更新版本的Docker。

You can check the version of Docker Compose you have installed with the following command from a terminal prompt:

你可以使用以下命令从终端提示检查已安装的Docker镜像的版本：

docker-compose --version

Go Programming Language - Go编程语言¶

Hyperledger Fabric uses the Go Programming Language for many of its components.

Go version 1.10.x is required.

Hyperledger Fabric许多组件使用Go编程语言。

Go 要求1.10.x版本。

Given that we will be writing chaincode programs in Go, there are two environment variables you will need to set properly; you can make these settings permanent by placing them in the appropriate startup file, such as your personal ~/.bashrc file if you are using the bash shell under Linux.

鉴于我们将在Go中编写链代码程序，你需要正确设置两个环境变量；你可以通过将这些设置放在适当的启动文件中来永久保存这些设置，比如你的个人 ~/.bashrc 文件，如果你在Linux下使用 bash Shell。

First, you must set the environment variable GOPATH to point at the Go workspace containing the downloaded Fabric code base, with something like:

首先，你必须设置环境变量 GOPATH 指向包含下载Fabric代码库的Go工作空间，如：

export GOPATH=$HOME/go

Note

You must set the GOPATH variable: 你必须设置GOPATH变量

Even though, in Linux, Go’s GOPATH variable can be a colon-separated list of directories, and will use a default value of $HOME/go if it is unset, the current Fabric build framework still requires you to set and export that variable, and it must contain only the single directory name for your Go workspace. (This restriction might be removed in a future release.) 即使在Linux中，Go的GOPATH变量可以使以冒号分隔的目录列表，如果未设置，将使用默认值 $HOME/go ，当前的Fabric构建框架仍需要你设置并导出该变量，而且它必须只包含Go工作区的单个目录名。（此限制可能在未来版本中移除）

Second, you should (again, in the appropriate startup file) extend your command search path to include the Go bin directory, such as the following example for bash under Linux:

然后，你应该（再次，在适当的启动文件中）扩展你的命令搜索路径以包含Go bin 目录，如Linux下 bash 的以下示例：

export PATH=$PATH:$GOPATH/bin

While this directory may not exist in a new Go workspace installation, it is populated later by the Fabric build system with a small number of Go executables used by other parts of the build system. So even if you currently have no such directory yet, extend your shell search path as above.

虽然此目录可能不存在于新的Go工作区安装中，但稍后会由Fabric构建系统填充，其中构建系统的其他部分使用少量Go可执行文件。因此，即使你目前还没有此类目录，也可以以上述方法扩展shell搜索路径。

Node.js Runtime and NPM - Node.js运行及NPM¶

If you will be developing applications for Hyperledger Fabric leveraging the Hyperledger Fabric SDK for Node.js, you will need to have version 8.9.x of Node.js installed.

如果你将用Node.js的Hyperledger Fabric软件开发包开发Hyperledger Fabric的应用程序，则需安装Node.js的8.9.x版本.

Note

Node.js version 9.x is not supported at this time.: Node.js 9.x版本暂不支持

Node.js - version 8.9.x or greater
Node.js - 8.9.x版本或更高

Note

Installing Node.js will also install NPM, however it is recommended that you confirm the version of NPM installed. You can upgrade the npm tool with the following command: 下载Node.js时也将下载NPM，然而建议你确认NPM的安装版本。你可以通过以下命令升级 npm 工具：

npm install npm@5.6.0 -g

Python¶

Note

The following applies to Ubuntu 16.04 users only. 以下内容仅适用于Ubuntu 16.04用户。

By default Ubuntu 16.04 comes with Python 3.5.1 installed as the python3 binary. The Fabric Node.js SDK requires an iteration of Python 2.7 in order for npm install operations to complete successfully. Retrieve the 2.7 version with the following command:

默认情况下，Ubuntu 16.04附带了Python 3.5.1安装的 python3 二进制文件。Fabric Node.js软件开发包需要迭代Python 2.7版本才能成功完成 npm install 操作。使用以下命令检索2.7版本：

sudo apt-get install python

Check your version(s):

检查你的版本：

python --version

Windows extras - Windows附加¶

If you are developing on Windows 7, you will want to work within the Docker Quickstart Terminal which uses Git Bash and provides a better alternative to the built-in Windows shell.

如果你在Windows 7上进行开发，则需要在使用 Git Bash 的Docker快速启动终端中工作，并提供内置Windows shell的更好替代方案。

However experience has shown this to be a poor development environment with limited functionality. It is suitable to run Docker based scenarios, such as Getting Started - 入门, but you may have difficulties with operations involving the make and docker commands.

然而，经验表明这是一个功能有限的糟糕开发环境。它适合运行基于Docker的方案，如 Getting Started - 入门，但你可能在操作包括 make 和 docker 命令时遇到困难。

On Windows 10 you should use the native Docker distribution and you may use the Windows PowerShell. However, for the binaries command to succeed you will still need to have the uname command available. You can get it as part of Git but beware that only the 64bit version is supported.

在Windows 10上，你应该使用本地Docker发行版，并且可以使用Windows PowerShell。但是你仍将需要可用的 uname 命令以成功运行 binaries 命令。

Before running any git clone commands, run the following commands:

在运行任何 git clone 命令前，运行如下命令：

git config --global core.autocrlf false
git config --global core.longpaths true

You can check the setting of these parameters with the following commands:

你可以通过如下命令检查这些参数的设置：

git config --get core.autocrlf
git config --get core.longpaths

These need to be false and true respectively.

相应地，这些需要分别是 false 和 true 。

The curl command that comes with Git and Docker Toolbox is old and does not handle properly the redirect used in Getting Started - 入门. Make sure you install and use a newer version from the cURL downloads page

Git和Docker Toolbox附带的 curl 命令很旧，无法正确处理 Getting Started - 入门中使用的重定向。因此要确保你从 cURL downloads page 安装并使用的是较新版本。

For Node.js you also need the necessary Visual Studio C++ Build Tools which are freely available and can be installed with the following command:

对于Node.js，你还需要免费提供必要的Visual Studio C ++构建工具，可以使用以下命令进行安装：

npm install --global windows-build-tools

See the NPM windows-build-tools page for more details.

有关更多详细信息，请参阅 NPM windows系统搭建工具页面。

Once this is done, you should also install the NPM GRPC module with the following command:

完成此操作后，还应使用以下命令安装NPM GRPC模块：

npm install --global grpc

Your environment should now be ready to go through the Getting Started - 入门 samples and tutorials.

你的环境现在应该已准备好 Getting Started - 入门中的示例和教程。

Note

If you have questions not addressed by this documentation, or run into issues with any of the tutorials, please visit the Still Have Questions? page for some tips on where to find additional help. 如果你有本文档未解决的问题，或遇到任何有关教程的问题，请访问 Still Have Questions? 页面，获取有关在何处寻求其他帮助的一些提示。