# Mac系統中如何搭建Hyperledger Composer環境
## 前言
Hyperledger Composer是構建區塊鏈業務網絡的強大工具集,它允許開發者快速建模、測試和部署區塊鏈解決方案。本文將詳細介紹在macOS系統上搭建Hyperledger Composer開發環境的完整流程,涵蓋從基礎依賴安裝到最終環境驗證的全過程。
---
## 一、環境準備
### 1.1 系統要求
- macOS 10.14 (Mojave) 或更高版本
- 至少8GB RAM(推薦16GB)
- 至少20GB可用磁盤空間
- 穩定的網絡連接
### 1.2 必要工具安裝
#### 1.2.1 安裝Xcode命令行工具
```bash
xcode-select --install
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
將以下內容添加到~/.zshrc
或~/.bash_profile
:
export PATH=/usr/local/bin:$PATH
brew install node@14
注意:Composer需要Node.js 8.x或10.x(推薦LTS版本)
驗證安裝:
node -v # 應顯示v14.x.x
npm -v # 應顯示6.x.x
brew install python@2
brew install --cask docker
安裝完成后需啟動Docker Desktop應用
驗證Docker:
docker --version
docker-compose --version
brew install git
mkdir ~/fabric-dev-servers && cd ~/fabric-dev-servers
curl -O https://raw.githubusercontent.com/hyperledger/composer-tools/master/packages/fabric-dev-servers/fabric-dev-servers.tar.gz
tar -xvf fabric-dev-servers.tar.gz
./downloadFabric.sh
./startFabric.sh
./createPeerAdminCard.sh
docker ps
應看到以下容器運行: - peer0.org1.example.com - couchdb - ca.org1.example.com - orderer.example.com
npm install -g composer-cli@0.20
npm install -g composer-rest-server@0.20
npm install -g composer-playground@0.20
npm install -g generator-hyperledger-composer@0.20
composer --version
composer-rest-server --version
mkdir ~/composer-projects && cd ~/composer-projects
yo hyperledger-composer
選擇”Business Network”并按照提示操作
git clone https://github.com/hyperledger/composer-sample-networks.git
cd composer-sample-networks/packages/basic-sample-network
composer archive create -t dir -n .
composer network install --card PeerAdmin@hlfv1 --archiveFile basic-sample-network@0.2.0.bna
composer network start --networkName basic-sample-network --networkVersion 0.2.0 --networkAdmin admin --networkAdminEnrollSecret adminpw --card PeerAdmin@hlfv1 --file networkadmin.card
composer card import --file networkadmin.card
composer-rest-server
訪問 http://localhost:3000/explorer
composer network ping --card admin@basic-sample-network
composer-playground
npm test
如果遇到端口沖突(特別是3000或8080):
lsof -i :3000
kill -9 [PID]
嘗試重置Docker:
docker rm -f $(docker ps -aq)
docker system prune
刪除舊卡片:
composer card delete -n admin@basic-sample-network
確保所有組件版本一致(推薦使用0.20.x系列)
composer network export --card admin@basic-sample-network --outFile network.backup
npm update -g composer-cli
./stopFabric.sh
./teardownFabric.sh
通過以上步驟,您已在macOS系統上成功搭建了完整的Hyperledger Composer開發環境?,F在可以開始創建自己的區塊鏈業務網絡,或基于示例項目進行二次開發。建議定期查看官方文檔獲取最新更新。
注意:由于Hyperledger Composer已進入維護模式,新項目建議考慮使用Fabric SDK直接開發。 “`
這篇文章共計約3400字,采用Markdown格式編寫,包含: 1. 清晰的分級標題結構 2. 詳細的代碼塊和命令行操作 3. 注意事項和常見問題解決方案 4. 版本兼容性說明 5. 維護和升級建議
您可以根據實際需要調整各部分內容的詳細程度或添加更多具體示例。
免責聲明:本站發布的內容(圖片、視頻和文字)以原創、轉載和分享為主,文章觀點不代表本網站立場,如果涉及侵權請聯系站長郵箱:is@yisu.com進行舉報,并提供相關證據,一經查實,將立刻刪除涉嫌侵權內容。