Conflux Studio 是一个帮助开发者快速开发 Conflux 智能合约的集成化开发环境。
Conflux Studio 安装包可以在 Github Releases(github.com/ObsidianLabs/ConfluxStudio/releases) 进行下载。目前 Conflux Studio 支持 macOS 和 Linux 系统,请根据系统下载对应的版本 (macOS 下载 .dmg 或者 .zip,Linux 下载 .AppImage)。
· macOS: 双击打开 ConfluxStudio-x.x.x.dmg 并将 Conflux Studio 拖动到应用文件夹内。
· Linux: 双击打开 ConfluxStudio-x.x.x.AppImage, 选择 Properties => Permissions => Execute, 将 Allow executing file as progrom 选项打勾。关闭属性设置窗口并双击打开应用(不同的 Linux 发行版可能会有不同的安装方式)。
你可以前往 Conflux DApp 开发教程《使用 IDE 开发 DApp 的实战操作指南》学习如何使用 Conflux Studio 完整地开发一款代币 DApp。
在正确安装 Conflux Studio(github.com/ObsidianLabs/conflux-dapp-tutorial) 并初次启动时,你将看到一个欢迎页面,这里有 Conflux Studio 正常运行所需要的依赖,包括了 Docker,Conflux Node 以及 Conflux Truffle。
· Conflux Studio 使用 Docker(www.docker.com/) 来启动 Conflux 节点和进行项目编译。如果你之前没有安装过 Docker,可以点击 Install Docker 按钮访问 Docker 官方网站并进行下载安装。
· Conflux Node(github.com/Conflux-Chain/conflux-rust) 是 Conflux 官方提供的 Conflux 节点镜像,Conflux Studio 使用这个镜像来运行 Conflux 节点以及项目编译。
· Conflux Truffle(github.com/Conflux-Chain/conflux-truffle) 是 Conflux 版本的 Truffle。Conflux Studio 使用这个工具包进行项目的创建和编译。
当所有依赖都正确安装并运行后,灰色的 Skip 按钮将会变成绿色的 Get Started 按钮。点击这个按钮进入 Conflux Studio 的主界面。
进入主界面后,我们需要首先创建一些密钥对。在 Conflux Studio 的任意界面,点击应用左下⻆的钥匙图标,打开密钥管理器。
你可以在密钥管理器中创建、导入并管理密钥对。在创建和编辑密钥对的时候,你可以为该密钥对设置别名,方便在后续的使用中进行识别。密钥管理器除了对密钥对进行储存管理外,还将为创世区块提供创世地址。创建新的 Conflux 节点实例时,会使用密钥管理器里所有的地址作为创世地址,每个地址得到 10000 CFX 的初始 token。
再继续之前,请先在密钥管理器中创建一些密钥对,作为接下来创建节点实例的创世地址。
点击顶部的 Network 标签,主页面将切换为网络管理器。在网络管理器中,我们可以进行 Conflux 节点版本和节点实例的管理,包括下载、删除 Conflux 节点版本,根据不同版本创建、删除和运行节点实例。
点击主页面中右上角的 New Instance 按钮打开创建新实例的弹窗,填写实例名称和选择合适的版本,点击 Create 按钮完成节点实例的创建。
节点实例创建完成后,实例列表将显示刚刚创建好的实例,点击实例的绿色 Start 按钮启动 Conflux 节点。启动完成后,你可以在下方的日志查看器中检查节点运行日志。
节点启动后,点击顶部的 Explorer 标签,主页面将切换为区块浏览器。在区块浏览器中,我们可以查询对应地址的信息。由于该模块仍在开发中,目前区块浏览器仅支持查看余额。
从密钥管理器中复制刚刚生成的地址,将地址粘贴在地址栏并点击回车,我们便可以看到对应地址的余额信息了。
点击顶部的 Project 标签,主页面将切换至项目管理器。点击页面右上角的 New 按钮打开创建项目弹窗,输入项目名称并选择合适的模版,Conflux Studio 目前提供了两个模版:
· coin:Conflux实例提供的coin智能合约
· [Truffle] metacoin:使用Conflux Truffle创建的合约;该项目目前无法部署到 Conflux 节点
项目创建完成后,主页面将切换至项目编辑器。项目编辑器由几个部分组成,包括了文件浏览器,代码编辑器,工具栏,日志查看器等多个开发常用模块。
点击工具栏的编译按钮(锤子形状),Conflux Studio 将进行项目的编译,你可以通过下方的日志查看器来查看编译结果。编译后将在项目目录下的 build 文件夹中生成 json 文件。
点击工具栏的部署按钮(船形状),Conflux Studio 将进行项目部署,部署结果将会弹窗显示。
成功部署智能合约后,点击弹窗中点击蓝色的 contract 按钮,主页面将切换至合约浏览器,Conflux Studio 将自动打开刚才部署完成的智能合约。
合约浏览器页面主要分为两个部分:
· 左边为合约的调用方法,点击左半部分的左上角蓝色按钮弹出的下拉框显示当前合约所定义的方法,点击方法名称可以切换调用的方法。
· 右边为合约的数据读取,点击右半部分的左上角蓝色按钮弹出的下拉框显示当前合约的数据表,点击表名称可以切换查看不同表中的数据。
Conflux Studio 会自动读取合约 ABI 中的 functions,并为每个 function 生成参数表单。用户可以简单的选择要调用的 function,输入参数,选择签名者(需要为 keypair manager 中存在的地址;读操作不需选择),并点击运行按钮进行合约调用。调用结果(成功或失败)将显示在下方的 result 栏中。
接下来我们使用部署好的合约创建 coin。选择 mint 方法,在 Parameters 下填入 receiver 地址(可以从密钥管理器中复制)和在 amount 中填入合适的数量,在 Authorization 中填入创世地址,点击上方的执行按钮。完成交易后,我们可以在左下角的 Result 中看到成功执行的结果。此时我们已经创建了新的 coin。
在右边的 balance 表中,在 Parameters 下输入刚刚填入的 receiver 地址,点击执行按钮,便可以看到刚刚 mint 的总数了。