SETP0,安装Substrate开发环境

简介

• 使用 https://substrate 矿建
• 参考文档：https://substrate.dev/docs/en/tutorials/create-your-first-substrate-chain/setup
• 参考文档：https://substrate.dev/docs/en/knowledgebase/getting-started/
• 参考文档：https://www.rust-lang.org/ （https://www.rust-lang.org/zh-CN/tools/install 这个文档还有中文版本）
• 参考文档：https://rust-cli.github.io/book/tutorial/setup.html
• 我的电脑是 macOS 所以如下操作默认都是在 macOS 上进行

安装 Rust

• 命令行输入：curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

• 输入1 进行默认安装

  
  
  image.png

• 安装过程很顺利，最后提示 Rust is installed now. Great!

  
  
  image.png

• 查看可执行文件 ls ~/.cargo/bin
  

  image.png

• 为了可以在命令行中直接使用 rustc 命令可以 source ~/.profile

• 或者 vim ~/.bash_profile

# 在最后一行添加
$ export PATH="$HOME/.cargo/bin:$PATH"

• 操作演示如下图。

  
  
  image.png

• 最后通过 rustup default stable 命令，将rustup 设定为稳定版本
  

  image.png

• 如上图所示我们安装的nightly版本是 2021-02-10，为了之后的学习我们需要把版本切换到 nightly-2020-10-06 。

# 输入命令：
rustup install nightly-2020-10-06
# 上面命令后会进入安装该版本的环节，安装后使用 `rustup default nightly-2020-10-06` 命令切换到该版本，这个很重要。

• 操作截图：

  
  
  image.png

• 至此Rust 安装并配置完毕

安装 wasm32-unknown-unknown 即可：安装方法

# 主要是安装这个。
rustup target add wasm32-unknown-unknown 
# 顺便把下面两个一并安装。
cargo install wasm-pack
cargo install https   

安装

• Mac 需要安装 brew，一般来讲Mac用户都会安装这个命令，如果已经安装直接 brew update和brew install openssl cmake 即可，如下是全部流程：

# 此摘要源自：https://substrate.dev/docs/en/knowledgebase/getting-started/
# Install Homebrew if necessary https://brew.sh/
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"

# Make sure Homebrew is up-to-date, install openssl and cmake
brew update
brew install openssl cmake

• 如果安装出错可能是国外源被屏蔽了可以使用国内的工具包：

/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"
brew update
brew install openssl cmake

• brew install openssl cmake 如果报错的解决办法

# 如果 出错可以使用 
brew install --build-from-source cmake 通过源码安装试试（不过这个超级慢做好心理准备）
# 编译大概需要1个小时左右，根据机器性能的不同，编译后需要添加环境变量。
echo 'export PATH="/usr/local/opt/sphinx-doc/bin:$PATH"' >> ~/.bash_profile

安装 Notejs

• 参考文档（可选）：https://nodejs.org/en/download/
• 下载Mac 安装包 https://nodejs.org/dist/v14.16.0/node-v14.16.0.pkg

# Mac 下可以使用 curl 命令下载，或者浏览器直接访问安装包地址。
curl https://nodejs.org/dist/v14.16.0/node-v14.16.0.pkg -o ~/Desktop/node-v14.16.0.pkg
# 下载完成后Mac 上双击安装即可

• 验证版本：node -v 显示 v14.16.0 表示安装成功。
  
  image.png

安装Yarn

• Yarn 是更牛逼的npm 包管理器，如果你没有安装的化也需要安一个。

# 我这里使用cnpm 如果你不知道cnpm 是什么baidu一下吧，如果你有国外代理直接使用 npm 也可以
cnpm install --global yarn

• 验证 yarn --version 安装

  
  
  image.png

编译Substrate

• 经过上面漫长的配置等待，接下来开始编译 Substrate ，为了和大家保持一致，Substrate和Substrate-node-template版本：v2.0.0，这个版本很重要否则后面可能出现莫名其妙的问题，上面的Rust 使用的是 nightly-2020-10-06 版本，这个也很重要。
• 克隆代码仓库

# 首先切换到自己常用的代码仓库， cd ~/ 找个合适的位置
# 然后下载 2.0.0 版本代码
git clone -b v2.0.0 --depth 1 https://github.com/substrate-developer-hub/substrate-node-template
# 进入这个 substrate-node-template 
git tag # 如果显示 v2.0.0 表示对了。
# 然后开始 make 项目
make init
make build

# 然后切换到上级目录后下载前端代码仓库
cd ..
git clone -b v2.0.0 --depth 1 https://github.com/substrate-developer-hub/substrate-front-end-template
cd substrate-front-end-template/ # git tag 应该 v2.0.0
yarn install # 安装前端项目的依赖包

• 最终效果截图：

  
  
  image.png

启动后端节点

• 启动节点

cd ../substrate-node-template/
./target/release/node-template --dev --tmp

image.png

image.png

启动前端节点

## 启动前端

要与您的本地节点交互，我们将使用 [Substrate 开发者 Front-end Template](https://github.com/substrate-developer-hub/substrate-front-end-template)，它集合了常规情况下需要的各种前端交互组件。

如果您已经安装了 Front-end Template，请在 Front-end Template 所在的根目录中执行以下命令：

确保在 Front-end Template 根目录中运行此命令

cd ../substrate-front-end-template/ 
yarn start

image.png

浏览器访问效果

配置开发环境

• 下载安装 vscode，然后点击插件，我们安装插件

  
  
  image.png
• 安装如下插件，逐个搜索并安装如下：

Rust-in-peace Extension Pack
vscode-rust-syntax
Rust syntax # 这个有可能没有，请翻墙

• 需要安装的插件大致如下：

  
  
  image.png

可能遇到的问题

rust-analyzer加载时间过长

• 参考文档：https://segmentfault.com/a/1190000039375746
• 参考文档：https://github.com/rust-analyzer/rust-analyzer/issues/2653
• 开发环境: vscode+rust-analyzer
• 问题：vscode一直卡在fetching metadata阶段。
• 方法，运行cargo metadata,发现 ：

Blocking waiting for file lock on package cache

• 运行

rm -rf ~/.cargo/.package-cache
cargo metadata

• 之后重启 vscode

cargo metadata 过慢

• 参考：https://learnku.com/articles/49977
• 首先进入电脑的 cargo 目录，MAC OS 默认安装在～/.cargo 下：

cd ~/.cargo

• 创建一个 config 文件，这里使用 vim 编辑器：

vim config

• 将下面的代码贴进去：

# 放到 `$HOME/.cargo/config` 文件中
[source.crates-io]
registry = "https://github.com/rust-lang/crates.io-index"

# 替换成你偏好的镜像源
replace-with = 'sjtu'
#replace-with = 'ustc'

# 清华大学
[source.tuna]
registry = "https://mirrors.tuna.tsinghua.edu.cn/git/crates.io-index.git"

# 中国科学技术大学
[source.ustc]
registry = "git://mirrors.ustc.edu.cn/crates.io-index"

# 上海交通大学
[source.sjtu]
registry = "https://mirrors.sjtug.sjtu.edu.cn/git/crates.io-index"

# rustcc社区
[source.rustcc]
registry = "git://crates.rustcc.cn/crates.io-index"

结束

• 感谢阅读，接下来会进入SETP1环节，参考下一篇文章。