设置计算机以能够使用Internet计算机开发分散应用程序。
这是一个逐步的教程,供Windows用户在1小时或更短的时间内安装,设置和部署“ Hello” Dapp到Internet计算机(IC)。 DAPP的部署仅需要使用终端的基本知识。在开始之前,请看一下this DApp running on-chain:
的版本1.确保您获得了正确的系统要求
因此,如果您进入Windows上的“开始”菜单并搜索系统信息,则可以查看您正在运行的操作系统版本。
因此,至少您应该运行 Windows 10,版本2004或更高版本,您可以通过查看此版本并看到它是19041年或更高版本,并且我可以说出这是正确的版本VE在这里有19045年,这很完美。
,而且,如果您正在运行 Windows 11或以上,那很好。
2.确保您正在运行64位窗口
在系统类型下,您应该看到“ x64。
所以这是两个主要要求。 接下来,您将去搜索 powershell 首先将以下代码行写入PowerShell: 它将安装用于Linux的Windows子机器的东西。 它将为我们提供一个虚拟Linux环境与我们一起运行bash命令,这是您使用dfinity Internet计算机时所必需的。 所以这将需要一段时间才能运行,但是一旦完成,它将告诉您请求操作成功,但是您必须重新启动机器才能生效。 ,一旦重新启动并再次启动,它应该自动将窗格放在下方,您需要设置一个用户名和密码以与Ubuntu合作。 重新启动后,将提示您设置Ubuntu用户名和密码,然后您将成功安装WSL。 注意: 记下这两种信息,您将稍后再进行。当您键入密码时,它不会显示出来,只需确保您知道您的键入! 请确保您知道您要打字的内容,并且也可以保持简单,因为您将在安装其他组件时很快使用此密码。 现在,一旦完成,请继续并打开Windows PowerShell作为管理员。 这只是检查了WSL是否正确安装。 只要您看到ubuntu版本第二版,您就可以了。 您已经准备好进入下一步,如果您没有这样做,那就是安装Visual Studio代码。 并按照以下说明 另外,您也可以下载A Zip archive,从那里提取并运行代码。 提示: 设置将添加Visual Studio代码到您的%路径%,因此从控制台,您可以键入 '代码。 在该文件夹中打开VS代码。安装后,您需要重新启动控制台,以更改为%路径%环境变量才能生效。 现在,一旦安装完成,它将自动启动。 您要做的是要安装一些必需的扩展名。 现在让VSCODE IDE打开,然后将
因此,转到“安装指南”并复制Motoko extension的第一个链接,然后将其粘贴到浏览器中。确保它来自 dfinity 团队。 并且,如果您单击浏览器中的“安装”,则应该能够提出Visual Studio代码并允许您在VSCODE中打开该链接。 有很多称为Motoko的扩展名,但是您想要一个来自Dfinity Foundation的扩展。 然后您将安装您的remote wsl,这将允许您在内部使用终端。 vscode,然后点击您之前安装的WSL。 现在,最后,您已经准备好继续安装节点。 因此,这意味着即使您已经在Windows计算机上安装了节点,也必须再次执行此操作,以便您可以使用WSL,Node,dfinity和其他所有内容。 Homebrew将使我们更容易安装其他工具,例如节点。您可能已经在Windows系统上安装了节点,但是由于我们与WSL合作,因此您也需要在Linux系统上安装它。 因此,要么转到“安装指南”中的自制链接,要么只是复制该命令,然后从开始菜单中打开Ubuntu,然后粘贴该命令并运行它。 或者从Homebrew网站上复制它: https://brew.sh/ 在安装过程中,它将要求您在设置Ubuntu时刚刚设置的密码,您只需要立即输入即可。当他们要求您确认时,请继续点击Enter。 现在,一旦安装自制酿造,就必须完成一些步骤。 复制这三个命令,然后在Ubuntu中一个一个命令。 这将使您可以在路径中使用自制。是否不明白这意味着什么都没关系。这只是需要的一点点手动设置。 现在在最后三个命令下方,您只需要在安装DFX之前安装另一个命令。 并最终添加在安装自制依赖项下方的部分,输入您的密码并在要求您进行完整安装过程时输入“ Y”。 现在,一旦您再次看到该美元签名,这意味着一切都完成了,您现在可以... ,如果您看到自制的,后面是某种版本编号,例如: 那意味着一切都成功了。 现在,最后,您将使用Homebrew安装节点版本16。 这是最新的稳定版本,这是可以很好地使用Internet计算机的版本。 因此您必须按照此命令。 现在,如果您遇到了我遇到的此错误, ,只要您获得以16开始的版本,就可以滚动。 最后,您准备安装DFX。因此,继续,从您的Windows开始菜单中: 现在要花一点时间来获取DFX,这将使我们可以在本地与Internet计算机合作。安装后,它将告诉您安装在哪里,您必须手动设置指向该位置的路径。 例如。就我而言,它告诉我它已安装在/home/josec/bin/dfx 因此,在“安装指南”中,我为您提供了这个存根,我希望您粘贴到记事本,然后用从DFX安装中获得的安装路径替换为“替换为安装路径”的零件。<<<<<<<< /p>
并从下面的命令中替换<用安装路径>替换(您可以使用记事本) 例如。就我而言,它将是导出路径= $ path:/home/josec/bin/dfx 所以复制,粘贴在那里,并确保结肠和第一个前向斜线之间没有空间。 复制整个命令,将其粘贴到Ubuntu中,然后按Enter运行该命令。 现在,如果您复制该行所说的Echo,然后是一堆符号,则应该可以看到当我到达这里时,您应该看到您的DFX位置已添加到您的路径中。 现在,终于,在您运行 ,如果您这样做,那意味着DFX已成功安装,您可以最终通过创建第一个Internet计算机应用程序开始。 注意:在本简短的教程中,我将使用 dfx 9.0.3 ,如果您一直遵循保持该版本的运行,即使它提示您升级DFX,不要升级!
3.确保您以管理员的身份打开PowerShell
$ wsl --install
4.完成此操作后,您将需要重新启动计算机
5.输入这些信息(用户名和密码)
6.要确认一切都起作用,请在PowerShell中键入以下命令
$ wsl --list --verbose
7.您应该在PowerShell中看到这样的输出
8.下载并安装最新版本的Vscode
9.在Vscode中安装Motoko语言扩展
10.安装远程WSL扩展
11.搜索和打开
12.安装自制
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
13.在步骤5中为您设置的用户输入密码
14.安装程序将告诉您如何将啤酒添加到路径
$ echo '# Set PATH, MANPATH, etc., for Homebrew.' >> /home/josec/.profile
$ echo 'eval "$(/home/linuxbrew/.linuxbrew/bin/brew shellenv)"' >> /home/josec/.profile
$ eval "$(/home/linuxbrew/.linuxbrew/bin/brew shellenv)"
15.如果您有sudo访问权限,请安装自制的依赖
$ sudo apt-get install build-essential
16.检查并确保通过键入以下命令
$ brew --version
$ brew --version
Homebrew 3.6.16
Homebrew/homebrew-core (git revision ff690e6841d, last commit 2022-12-27)
17.使用Homebrew与以下命令安装节点
$ brew install node@16
node 16 is keg-only
,这意味着它不是链接的,这是因为您在计算机上安装了另一个节点版本,而您所要做的就是简单地键入brew link node@16
即可链接到我们刚刚安装的这个版本。
$ brew link node@16
18.完成后检查是否合作
$ node --version
安装DFX
19.打开Ubuntu
20.复制/粘贴以下命令到您的终端中,然后按ENTER安装DFX
$ DFX_VERSION=0.9.3 sh -ci "$(curl -fsSL https://sdk.dfinity.org/install.sh)"
$ DFX_VERSION=0.9.3 "(install.sh)"
info: installed /home/josec/bin/dfx
21.复制您从最后一步获得的安装路径
$ export PATH=$PATH:/home/josec/bin/dfx
22.从上一步粘贴格式的命令,然后命中输入
23.检查已通过运行以下命令添加
$ echo "${PATH//:/$'\n'}"
24.检查DFX是否已成功安装了以下命令
$ dfx --version
dfx --version
之后,您应该看到dfx 0.9.3.
测试创建和部署第一个DAPP的所有内容
创建默认Hello Dapp
1.打开Vscode,然后单击那个小绿色图标
打开Vscode,然后单击左下方的那个小绿色图标,然后选择新的WSL窗口。
现在,完成此操作后,您可以在需要的话上关闭上一个窗口,但请确保与您一起使用的窗口说WSL:ubuntu。
,如果您徘徊在ubuntu中,它应该说
2.打开Ubuntu并创建一个名为IC-Projects的目录
现在继续从开始菜单打开Ubuntu,您将使用Make Directory命令创建一个名为ic-projects
的目录:
$ mkdir ic-projects
因此,请复制/粘贴此命令,也可以输入。
但是,您正在在我们的主要用户文件夹中创建此文件夹,然后在我们的主要用户文件夹中创建该文件夹,然后您将转到cd
或将目录更改为该新创建的文件夹。
3.将目录更改为该文件夹
通过使用以下命令将目录更改为该文件夹:
$ cd ic-projects
4.创建您的第一个互联网计算机DAPP
在此ic-projects
文件夹中,您将创建我们的第一个Internet Computer Dapp。继续输入以下命令:
$ dfx new hello
这将为您构建一个示例Internet计算机应用程序,称为 Hello 。
并将其留在后台运行中。
构建后,您将看到dfinity徽标显示出现,您可以通过使用命令explorer.exe .
查看文件夹和文件在哪里,并且您可以看到所有hello文件夹,其中包含所有模板文件DFX为您创建。
~/ic-projects$
5.确认您的项目文件和文件夹
您可以通过运行以下命令来查看此新项目和文件夹:
~/ic-projects$ explorer.exe .
6.打开Vscode,然后单击那个小绿色图标
再次打开Vscode,然后像步骤1一样单击绿色图标。
您现在可以返回VSCODE,然后选择“打开文件夹”,选择IC-Projects/Hello。
现在应该在Vscode中打开我们的项目。
现在,如果您在源文件夹中查看,您将看到此项目的所有源文件。
,您已经拥有您的koude9,这是您的Motoko文件。
以防万一,它没有任何语法突出显示,这是我们的Motoko扩展程序应该做的,请转到“扩展”选项卡,如果是这样,您可以看到此扩展名。 >
我希望您单击该按钮,该按钮要在WSL:Ubuntu中安装,以便您可以在WSL遥控器中提供可用。
现在,最终您可以回到您的koude9,您应该看到所有的语法突出显示正常工作。
部署DAPP
现在还有一些HTML文件和JS文件,但是您现在可以部署。
所以进入终端菜单,然后打开一个新的终端。
,在这里我要您写信启动dfx start
开始本地Internet计算机。
$ dfx start
现在,一旦您在某物上看到此列表后,我希望您通过单击下图中显示的+
按钮将新的终端窗口拆分,然后输入dfx deploy
以将此Hello Project部署到该本地DFX上你刚开始。
$ dfx deploy
完成后,您再次看到美元符号,您将键入npm start
以启动服务器。
$ npm start
,如果您滚动,您会看到,它会告诉您项目在哪里运行。
因此,继续复制该URL并将其粘贴到您的浏览器中或打开浏览器并导航到http://localhost:8080/。
请注意:您可能会在终端中看到其他服务器URL,它可以是http://localhost:3000/或http://localhost:5000/或其他本地服务器主机。
加载后,您将看到您的入门项目,输入您的名称,然后单击Click Me!
按钮,您会看到出现的问候。
这意味着您已经成功安装并设置了在Internet计算机上开始开发所需的一切。
停止本地罐执行环境
在浏览器中测试应用程序后,您可以停止本地罐执行环境,以免在后台继续运行。我们不需要它运行即可部署链。
停止本地部署:
- 在终端A中,按Control-C中断本地网络过程。
- 在终端B中,按Control-C中断开发服务器过程。
- 停止在本地计算机上运行的本地罐执行环境:
$ dfx stop
故障排除
Node.js未正确安装
如果您的DAPP未在浏览器中显示,则可能无法正确安装Node.js。确认它是通过运行安装的:
$ node --version
DFX的事先安装
如果您以前在2022年2月之前创建了IC DAPP,则可能需要进行干净的安装。您可以删除SDK和关联的配置文件并重新安装它。在此处按照说明:Install, upgrade, or remove the software。
升级到最新版本
如果最初安装后可以下载新版本的SDK,则应尽早安装更新版本,以尽快获得最新的修复程序和增强功能。您可以使用dfx upgrade
命令将您当前安装的版本与可供下载的最新版本进行比较。如果可以使用较新版本的DFX,则dfx upgrade
命令自动下载并安装最新版本。
$ dfx upgrade
请注意,在安装新版本之前,您无需卸载软件。但是,如果要执行干净的安装而不是升级,则可以首先卸载Removing the software中所述的软件,然后重新运行下载和安装命令。
有关最新版本中功能和修复的信息,请参见Developer Release notes。
在互联网计算机上构建的开发人员资源有哪些?
我还想分享用于在Internet计算机上创建项目的DFINITY开发人员文档,工具和其他developer resources的广泛列表。
通用互联网计算机教程
- Coding with Kyle Video Tutorial Series:学习如何与Dfinity开发人员Kyle Peacock一起构建IC Avatar Dapp。
- The Complete 2022 Web Development Bootcamp:这是一个完整的Web开发人员训练营,总计为65小时。第34节开始是关于在IC上构建的10小时课程。
- Series on low-level interaction with the Internet Computer by Ben Lynn
包起来
恭喜!您学会了如何设置计算机,以便能够使用Internet计算机开发分散的应用程序,并且您还希望在1小时内完全构建了您的第一个“ Hello” Dapp(后续和前端)。
。教程外卖:
- Dapps可以由多个罐头组成。
- DAPP可以在本地和链上部署。
- “ Hello” Dapp由Motoko编写的后端代码组成,该编写是一种专门设计用于与Internet计算机交互的编程语言,以及一个简单的基于WebPack的前端。
在哪里可以获得帮助并支持IC开发的?
当您通过教程并开始提出个人项目的想法时,最好了解所有可以在互联网计算机上获得帮助的地方,下面的链接值得在!
- Official Developer Docs
- Command-line Reference
- Official Dfinity Forum
- Official Dfinity Developer Discord
想从我的文章中了解更多吗?
如果您正在寻找有关Internet计算机的更多信息,请查看以下文章What is the Internet Computer?发布于2022年12月29日。
感谢您的阅读!现在去构建一些很棒的东西!