在 Windows 上构建

在 Windows 上构建 - 图1

安装 Go

go-ipfs基于 Golang 构建,因此所有构建方法都依赖于它. \ https://golang.org/doc/install\ 该GOPATH环境变量也必须设置. \ https://golang.org/doc/code.html#GOPATH

选择您要继续的方式

go-ipfs利用make自动化构建和运行测试,但可以在没有它的情况下构建git和go. \ 无论您选择哪种方法,如果遇到问题,请参阅故障排除部分.

运用make:\ MSYS2 和 Cygwin 提供了我们需要的 Unix 工具构建go-ipfs. 您可以使用其中任何一个,但如果您还没有安装,我们建议使用 MSYS2. \ MSYS2→\ Cygwin 的 →

使用最小构建工具:\

本节假设您的go和git版本已经设置好了,如果您的环境限制安装其他软件,或者您正在将 IPFS 集成到您自己的构建系统中,那么您可能希望以这种方式构建. \ 最小 →

MSYS2

  1. 安装 msys2 (http://www.msys2.org)
  2. 在正常情况下运行以下内容 (不是 MSYS2 提示,我们只需要 MSYS2 的工具) . \ 下面是对该块的解释.
  1. SET PATH=%PATH%;\msys64\usr\bin
  2. pacman --noconfirm -S  git make unzip
  3. go get -u github.com/ipfs/go-ipfs
  4. cd %GOPATH%\src\github.com\ipfs\go-ipfs
  5. make install
  6. %GOPATH%\bin\ipfs.exe version --all

如果没有错误,则最终命令应输出类似于”ipfs version 0.4.14-dev-XXXXXXX“其中”XXXXXXX”应匹配当前的短哈希值go-ipfs库. 您可以通过此命令检索所述哈希: git rev-parse --short HEAD. \ 如果ipfs.exe执行并且版本字符串匹配,然后构建成功.

命令 说明
SET PATH=%PATH%;\msys64\usr\bin 添加 msys2 到PATH;默认为: (\msys64\usr\bin)
pacman --noconfirm -S git make unzip 安装go-ipfs构建依赖项
go get -u github.com/ipfs/go-ipfs 获取/更新go-ipfs资源
cd %GOPATH%\src\github.com\ipfs\go-ipfs 改成go-ipfs源目录
make install 构建并安装到%GOPATH%\bin\ipfs.exe
%GOPATH%\bin\ipfs.exe version --all 测试构建的二进制文件

要在更改源后再次构建,请运行:

  1. SET PATH=%PATH%;\msys64\usr\bin
  2. cd %GOPATH%\src\github.com\ipfs\go-ipfs
  3. make install

提示:避免每次设置PATH (SET PATH=%PATH%;\msys64\usr\bin) ,你可以永久锁定它,通过setx在设置一次之后:

  1. SETX PATH %PATH%

Cygwin

  1. 安装 Cygwin (https://www.cygwin.com)

  2. 在安装过程中,选择以下包. (如果已安装 Cygwin,请再次运行安装文件以安装其他软件包. ) 全新安装应该类似于这个参考图片.

    • 开发包-devel
      • git
      • make
    • 存档包-archive
      • unzip
    • 网络包-net
      • curl

  3. 在正常情况下运行以下内容 (不是 Cygwin 提示,我们只需要 Cygwin 的工具) \ 下面是对该块的解释.

  1. SET PATH=%PATH%;\cygwin64\bin
  2. mkdir %GOPATH%\src\github.com\ipfs
  3. cd %GOPATH%\src\github.com\ipfs
  4. git clone https://github.com/ipfs/go-ipfs.git
  5. cd %GOPATH%\src\github.com\ipfs\go-ipfs
  6. make install
  7. %GOPATH%\bin\ipfs.exe version --all

如果没有错误,则最终命令应输出类似于”ipfs version 0.4.14-dev-XXXXXXX“其中”XXXXXXX”应匹配当前的短哈希值go-ipfs库. 您可以通过此命令检索所述哈希: git rev-parse --short HEAD. \ 如果ipfs.exe执行并且版本字符串匹配,然后构建成功.

命令 说明
SET PATH=%PATH%;\cygwin64\bin 将 Cygwin 的工具添加到我们的工具中PATH;默认为: (\cygwin64\bin)
mkdir %GOPATH%\src\github.com\ipfs
cd %GOPATH%\src\github.com\ipfs
git clone https://github.com/ipfs/go-ipfs.git		 获取/更新go-ipfs资源
cd %GOPATH%\src\github.com\ipfs\go-ipfs 改成go-ipfs源目录
make install 构建并安装到%GOPATH%\bin\ipfs.exe
%GOPATH%\bin\ipfs.exe version --all 测试构建的二进制文件

要在更改源后再次构建,请运行:

  1. SET PATH=%PATH%;\cygwin64\bin
  2. cd %GOPATH%\src\github.com\ipfs\go-ipfs
  3. make install

提示:避免每次设置PATH (SET PATH=%PATH%;\cygwin64\bin) ,你可以永久锁定它,通过setx在设置一次之后:

  1. SETX PATH %PATH%

最小

虽然有可能go单独构建go-ipfs,我们会使用git和gx用于实际的源管理. 你可以使用任何版本的git你希望,但我们建议使用 Windows 版本https://git-scm.com. git必须在你的PATH对于go get识别和使用它.

gx

您可以安装预建的二进制文件gx&gx-go如果它们适用于您的平台. 或者,您可以从源代码构建它们,并将它们安装到%GOPATH%\bin通过运行以下内容:

  1. go get -u github.com/whyrusleeping/gx
  2. go get -u github.com/whyrusleeping/gx-go

go-ipfs

  1. SET PATH=%PATH%;%GOPATH%\bin
  2. go get -u -d github.com/ipfs/go-ipfs
  3. cd %GOPATH%/src/github.com/ipfs/go-ipfs
  4. gx --verbose install --global
  5. cd cmd\ipfs

我们需要git commit 哈希 包含在我们的构建中,以便在极少数情况下发现错误,我们稍后会有一个参考点来跟踪它. 我们会问git为它并将其存储在变量中. 根据您是使用交互式命令行 还是 编写批处理文件,下一个命令的语法会有所不同. 使用适合您的那个.

  • 互动: FOR /F %V IN ('git rev-parse --short HEAD') do set SHA=%V
  • 解释: FOR /F %%V IN ('git rev-parse --short HEAD') do set SHA=%%V

最后,我们将构建并测试ipfs本身.

  1. go install -ldflags="-X "github.com/ipfs/go-ipfs".CurrentCommit=%SHA%"
  2. %GOPATH%\bin\ipfs.exe version --all

您可以检查 ipfs 输出版本 是否匹配go version和git rev-parse --short HEAD. \ 如果ipfs.exe执行并且一切都匹配,然后构建成功.

故障排除

  • Git auth

如果您在使用 Git 时遇到身份验证问题,您可能需要查看https://help.github.com/articles/caching-your-github-password-in-git/并使用建议的解决方案: \ git config --global credential.helper wincred

  • 还要别的吗

请搜索https://discuss.ipfs.io对于您可能遇到的任何其他问题. 如果您找不到任何现有的解决方案,请随时发布问题寻求帮助.

如果你遇到了一个 bug 在go-ipfs本身 (与构建无关) 请使用问题跟踪器举报.