共计 3087 个字符,预计需要花费 8 分钟才能阅读完成。
近期,XuperIDE SIG 小组组织了首次例会,由黑曜石实验室产品负责人 Edrick 为大家具体介绍 XuperIDE 操作方法,以下为操作手册,欢送感兴趣的开发者查看。
XuperIDE 应用文档
- 装置
1.1. 下载
目前 XuperIDE 反对 macOS, Linux 和 Windows 操作系统,对应的安装包能够在下方地址进行下载(macOS, Linux, Windows)。
1.2. 装置
macOS
双击关上 XuperIDE-x.x.x.dmg 并将 XuperIDE 拖动到利用文件夹内(首次运行时若呈现未通过苹果验证的提醒,可右键点击利用图标并关上,跳过验证)。
Linux
双击关上 XuperIDE-x.x.x.AppImage 抉择 Properties => Permissions => Execute, 将 Allow executing file as progrom 选项打勾。敞开属性设置窗口并双击关上利用(不同的 Linux 发行版可能会有不同的装置形式)。
Windows
双击 XuperIDE-x.x.x.exe,装置并关上利用。
- 性能预览
2.1. 筹备工作
在正确装置 XuperIDE 并首次启动时,你将看到一个欢送页面,这里有 XuperIDE 失常运行所须要的依赖,包含了 Docker,XuperChain node 及 Xdev
XuperIDE 应用 Docker 来启动 Xuper 节点和进行我的项目编译。如果你之前没有装置过 Docker,能够点击 Install Docker 按钮拜访 Docker 官方网站并进行下载安装;
对于 Windows 用户,咱们举荐应用 Docker Desktop。Docker Toolbox 也可应用,但在一些状况可能会呈现问题;
XuperChain node 是超级链节点的 Docker 镜像,XuperIDE 应用这个镜像来运行 XuperChain 节点;
Xdev 是超级链 C++ 合约的开发及编译工具。
当所有依赖都正确装置并运行后,灰色的 Skip 按钮将会变成绿色的 Get Started 按钮。点击这个按钮进入 XuperIDE 的主界面。
2.2. 创立密钥对
进入主界面后,咱们须要首先创立一些密钥对。在 XuperIDE 的任意界面,点击利用左下⻆的钥匙图标,关上密钥管理器。
你能够在密钥管理器中创立、导入并治理密钥对。在创立和编辑密钥对的时候,你能够为该密钥对设置别名,不便在后续的应用中进行辨认。密钥管理器除了对密钥对进行贮存治理外,还将为创世区块提供创世地址。创立新的 Xuper 节点实例时,XuperIDE 会应用密钥管理器里的地址作为创世地址。
创立的新密钥对将应用中文助记词来生成私钥。不过,导入私钥的时候也能够导入英文助记词或者 JSON 格局超级链私钥。
在持续之前,请先在密钥管理器中创立一些密钥对,作为接下来创立节点实例的创世地址。
2.3. 启动节点
点击顶部的 Network 标签,主页面将切换为网络管理器。在网络管理器中,咱们能够进行 Xuper 节点版本和节点实例的治理,包含下载、删除 Xuper 节点版本,依据不同版本创立、删除和运行节点实例。
点击主页面中右上角的 New Instance 按钮关上创立新实例的弹窗,填写实例名称和抉择适合的版本,点击 Create 按钮实现节点实例的创立。
节点实例创立实现后,实例列表将显示刚刚创立好的实例,点击实例的绿色 Start 按钮启动 Xuper 节点。启动实现后,你能够在下方的日志查看器中查看节点运行日志。
2.4. 连贯百度超级链凋谢网络
XuperIDE 除了提供本地节点性能,也提供了连贯百度超级链凋谢网络和连贯自定义节点的性能。点击 Network 标签旁的下拉菜单抉择 Baidu Xuper 可切换到百度超级链凋谢网络。
2.4. 区块链浏览器
节点启动后,点击顶部的 Explorer 标签,主页面将切换为区块浏览器。在区块浏览器中,咱们能够查问对应地址的信息。
通过标签旁边的下拉箭头,能够抉择并关上密钥管理器中的地址。您也能够在地址栏中输出或粘贴一个地址。关上一个无效地址后,咱们便能够看到对应地址的余额信息了,在余额信息的右方显示该地址对应的合约账户地址。
2.5. 创立智能合约账户
XuperChain 的一个账户能够领有多个智能合约账户,用户能够将智能合约部署在合约账户下。
点击地址栏最右侧的创立合约账号按钮,在弹出的创立合约账号窗口中填入创立的合约地址。合约账户地址格局为 16 位的纯数字,且第一位不能为 0。
点击创立后能够在浏览器中看到刚刚创立的合约账户地址信息,格局为 XC2000000000000000@xuper,点击能够跳转到该地址的合约交互页面。
2.6. 创立智能合约我的项目
点击顶部的 Project 标签,主页面将切换至我的项目管理器。点击页面右上角的 New 按钮关上创立我的项目弹窗,输出项目名称并抉择适合的模版,XuperIDE 目前提供了两个模版,别离为
C++ 版本的 Counter
Solidity 版本的 Counter
填写项目名称并抉择适合的模版后点击创立我的项目,创立实现后 XuperIDE 将在项目管理页面中关上该我的项目。
Counter 合约实现了一个简略的区块链计数器,其中定义了两个办法 increase 和 get,别离为自增计数器和获取以后计数器的值。
2.7. 编译智能合约我的项目
XuperChain 反对应用 C++ 及 Solidity 开发智能合约,其中 C++ 应用 Xdev 进行合约编译,Solidity 应用 Solc 进行编译。在右下角能够看到目前应用的编译器和编译器版本。能够点击该按钮抉择心愿应用的编译器版本,或者关上管理器下载更多可用的编译器版本。
点击工具栏的编译按钮(锤子形态),XuperIDE 将进行我的项目的编译,你能够通过下方的日志查看器来查看编译后果。编译后将在我的项目目录下中生成 wasm 或者 abi 文件。
2.8. 部署智能合约我的项目
点击工具栏的部署按钮(船形态),部署参数窗口将被关上,在这里能够输出部署合约的名称、构造函数的参数、交易签名者和合约账号。
2.9. 调用合约
胜利部署智能合约后,点击区块浏览器,并在合约地址处抉择刚刚部署的地址,主页面将切换至合约浏览器,XuperIDE 将主动关上方才部署实现的智能合约。
合约浏览器页面次要分为两个局部:
右边为合约的调用办法,能够依据合约代码填写调用的办法及参数,还能够抉择不同的签名地址。
左边为合约的数据读取,与调用合约相似,能够依据合约代码填写查问的办法及参数,能够抉择不同的签名地址。
XuperIDE 会主动读取合约 ABI 中的 functions,并为每个 function 生成参数表单。用户能够简略的抉择要调用的 function,输出参数,抉择签名者(须要为 keypair manager 中存在的地址;读操作不需抉择),并点击运行按钮进行合约调用。调用后果(胜利或失败)将显示在下方的 result 栏中。
接下来咱们开始调用部署好的合约。在 Invoke 侧的 Method 中填入 increase,因为 increase 办法须要一个参数 key,将在 Args 下的输入框中留下一个参数,并在右边填入 key 左边填入 a,在 Authorization 的 Signer 中抉择地址,点击上方的执行按钮。实现交易后,咱们能够看到胜利执行的后果。合约会依据传入的 key 参数来减少 counter 的值。
在左边的 Query 的 Method 中填入 get,将在 Args 下的输入框中留下一个参数,并在右边填入 key 左边填入 a,点击执行按钮,在下方 Result 中能够看到查问的后果,即计数器以后的值。
屡次调用 increase 并通过 get 查问能够看到计数器依据调用 increase 的次数发生变化。