侧边栏壁纸
博主头像
疯狂IT人博主等级

疯狂编程博客,分享IT编程的技术博客,用程序员视角总结分享IT编程和互联网知识的那些事儿。

  • 累计撰写 189 篇文章
  • 累计创建 20 个标签
  • 累计收到 3 条评论

目 录CONTENT

文章目录

在 Linux 上本地设置 Habitica

疯狂IT人
2022-08-24 / 0 评论 / 0 点赞 / 1,299 阅读 / 5,355 字 / 正在检测是否收录...

向 Habitica 的habitica.com网站贡献代码的第一步是设置网站的本地实例来测试您的更改。此页面包含有关如何在Linux中执行此操作的说明。

如果您使用不同的操作系统(或托管在 Linux 上但包含不同操作系统的虚拟机),或者如果您想为移动应用程序的开发做出贡献,请参阅本地设置 Habitica中的链接。

按顺序阅读本页上的每个部分,确保在继续下一个之前遵循每条说明。如果您遇到错误,请务必停止并解决它们,然后再继续下一步。

阅读铁匠指南以获取有关 Habitica 编码的背景信息 也很重要。

1 准备故障排除
2 安装 Git
3 设置交换文件
4 安装构建工具
5 安装 MongoDB
6 安装节点和 NPM
7 安装其他通用要求
8 叉子和克隆 Habitica
9 留在正确的分支和目录中
10 Habitica 初始配置
11 安装 Habitica 特定要求
12 启动 Habitica Web 服务器
13 查看服务器输出
14 在浏览器中测试网站
15 后续步骤:使用本地安装

准备故障排除

本地安装并不总是顺利,但我们很乐意为您提供帮助!Habitica 使用了很多软件,我们知道在您习惯之前安装它们可能会很复杂。请在遇到错误之前按照本节中的所有步骤进行操作,以便在必要时轻松寻求帮助,我们可以快速评估您的问题。

在安装 Habitica 时:

记录您键入的每个命令和每个命令的完整输出- 将所有命令和输出保存到一个或多个文本文件中,以防我们以后需要查看它们。
仔细阅读所有输出消息以查找错误。
如果您看到错误,请在错误解决之前不要继续操作,因为后面的步骤可能无法正常工作。
屏幕截图可能是记录错误的一种简单方法,但不利于分析它们,因此如果可能,请以文本形式提供完整的错误消息。这让管理员可以将相关部分粘贴到 GitHub 问题或 Google 搜索中。
如果您需要偏离此页面上的任何说明,请记录您所做的不同之处以及原因。如果您以后需要帮助,帮助您的人了解这些差异至关重要,否则可能会将时间花在与您无关的建议上。
如果您在修复任何错误方面需要帮助,请将您收集的所有信息上传到GitHub Gist等网站,然后在 GitHub 中记录问题并告诉我们以下内容:

您使用的是什么版本的 Linux
您需要从标准说明中做出的任何偏差
本页说明要求您记录的任何其他信息
链接到您上传的文件
你遇到什么问题
故障排除的关键步骤是能够重现问题。为了让其他人能够帮助排除故障,除非他们已经熟悉问题,否则他们通常需要能够在另一个系统上复制这种情况。因此,任何可以帮助其他人复制场景的信息都是有价值的。您还应该能够自己复制问题。有时从头开始可以解决问题或帮助确定问题的可能原因。

安装 Git

如果您还没有 GitHub 帐户,请创建一个。

git在您的机器上安装(此处提供安装说明)。

设置交换文件

如果您的计算机没有太多 RAM,您可能需要至少 4 GB 的交换文件,否则在运行“npm install”和“npm start”命令时会出现持续错误(例如错误,请参阅此 GitHub 问题)。如果您有一台具有良好 RAM 的相对较新的计算机,您可能可以忽略此部分。

您的计算机可能已经有一个交换文件。在 Internet 上查找适当的说明,以查看或为您的平台创建交换文件。

如果您有交换文件,但仍然无法成功运行“npm install”和“npm start”命令,请尝试增加交换文件的大小。

现在记录交换文件的大小。如果您以后需要寻求帮助,请在您提供给我们的情况下将其包含在故障排除信息中。

安装构建工具

用于构建软件(例如 make 和 gcc)的命令行工具将由您将在本页后续步骤中安装的软件包使用。你的 Linux 机器可能已经安装了它们,所以下面的命令可能会告诉你不需要安装任何东西;这不会是错误,您可以继续本页的下一部分。

对于Ubuntu、Debian和基于它们的发行版,运行:
sudo apt-get install build-essential

对于RedHat、CentOS和类似的发行版,运行:
sudo yum install gcc-c++ make。

对于任何其他发行版,如果有必要安装从源代码构建软件的工具,请查阅发行版的文档以了解如何操作。

安装 MongoDB

自 2020 年 7 月 15 日起,无需手动安装 MongoDB。当您按照以下步骤操作时,将自动安装专门用于 Habitica 的 MongoDB 实例。也不需要使用 MongoDB 的标准服务器启动命令手动启动 Habitica 的 MongoDB 服务器。

(请注意,如果您正在为 Habitica 以外的项目运行 MongoDB 服务器,它将与 Habitica 自己的 MongoDB 实例冲突,因此需要在您的 Habitica 本地安装运行时停止它。有关此的更多详细信息将在下面给出有必要停止它的地方。)

安装节点和 NPM

本节将带您完成安装 node 和 npm 的过程。重要提示:您必须安装node 14和npm 6。自 2020 年 12 月起,节点 12 也将正常工作,但将来会停止工作,因此请尽可能安装节点 14。如果您使用任何其他版本,您将遇到错误。如果你需要在你的开发机器上使用不同的版本来完成与 Habitica 无关的工作,你可以使用nvm来管理这些版本。

安装 Node 时,系统上将安装一个 Node 可执行文件。它可能被称为node或nodejs。以下所有命令都假定它已被调用node,但如果您看到错误提示该节点不存在,请键入nodejs。

请注意,以下示例命令仅供参考,可能不包含正确版本的 node 或 npm,因此请务必在运行之前根据需要调整命令。正确的版本是 node 14和npm 6

检查是否未安装不适当的node 和 npm版本:
node --version; npm --version
如果该命令显示该节点未安装,请继续执行下一步。
如果它显示您的节点版本与所需版本不同,请将其卸载。在 Ubuntu 上,卸载它的命令是:
sudo apt-get purge nodejs -y; sudo apt-get purge node -y
使用源代码或二进制发行版或包管理器为您的 Linux 发行版安装正确版本的节点。
对于 Ubuntu,其软件存储库可能比最新版本晚几个月运行,请从更新的存储库安装 NodeJS。例如,如果需要安装 Node 12:
curl --location https://deb.nodesource.com/setup_12.x | sudo bash -
sudo apt-get install nodejs
对于 CentOS 7,如果需要安装 Node 12:
curl --location https://rpm.nodesource.com/setup_12.x | sudo bash -
sudo yum install -y nodejs
检查您是否成功安装了节点并且它是正确的版本:
node --version
安装节点也会安装 npm。检查是否已完成并且版本是否正确:
npm --version
如果您有任何其他版本的 npm,请将其升级到正确的版本。例如,如果需要安装 npm 6 但您的版本不同:
sudo npm install -g npm@6
如果您发现您的 Node 可执行文件名为,请使用以下命令nodejs创建指向该名称的链接:node
sudo ln -s which nodejs /usr/bin/node

安装其他通用要求

执行这个命令:
sudo npm install -g mocha

注意:如果你查看 Habitica repo 的README 文件,你会看到它链接到各种服务,例如 Greenkeeper。您不需要在本地安装中安装它们。

注意:
完成上述步骤后,重要的是,从此时起,您将使用为 Habitica 开发代码时使用的相同用户帐户登录计算机。不要以 root 身份登录。当需要提升权限时,此页面将告诉您使用 sudo。在其他时间使用提升的权限会导致问题。

关闭您在之前的步骤中打开的所有命令窗口或终端窗口。当您再次需要命令/终端窗口时,请打开一个新窗口,以便您的 shell 环境知道您迄今为止安装的软件。

叉子和克隆 Habitica

获取 Habitica 代码库的副本。有多种方法可以做到这一点;以下是最简单的方法,基于 GitHub 的Fork A Repo文章。

通过转到https://github.com/HabitRPG/habitica并单击“Fork”按钮来创建 Habitica 的存储库。这会在您自己的 GitHub 帐户中创建 Habitica 存储库的副本。
如果您之前已经对存储库进行了 fork,请确保您的 fork 是最新的。
在您的机器上,打开命令提示符或终端窗口。切换到你想要复制 Habitica 代码库的目录。
使用以下命令克隆您的 Habitica 存储库副本(将“ YourUsername ”替换为您的 GitHub 用户名)。这会将 Habitica 的代码复制到您的机器上,将存储库放入当前目录下的新“habitica”目录中。
git clone https://github.com/YourUsername/habitica.git
更改为由上述步骤创建的“habitica”目录:
cd habitica
除非另有说明,否则在此页面上的所有后续步骤中都保留在该目录中。
配置 Git 以将你的 fork 与 Habitica 的存储库同步。
git remote add upstream https://github.com/HabitRPG/habitica.git
git remote -v通过键入应该产生与以下相同的输出但使用您的 GitHub 用户名来验证所有设置是否正确:
来源 https://github.com/ YourUsername /habitica.git (fetch)
来源 https://github.com/ YourUsername /habitica.git(推送)
上游 https://github.com/HabitRPG/habitica.git (fetch)
上游 https://github.com/HabitRPG/habitica.git(推送)

留在正确的分支和目录中

克隆 Habitica 的存储库后,默认情况下您将在develop分支中。这是在本地安装 Habitica 时要使用的正确分支。您不需要更改到任何其他分支,但如果您出于任何原因这样做,则必须git checkout develop在继续安装之前切换回开发分支。您可以检查您所在git branch的分支(旁边带有星号的分支是您当前所在的分支)。

完成上述所有步骤后,您将进入 Habitica 的顶级目录。除非另有说明,否则您必须保留在该目录中以执行此页面上的所有后续步骤。下面的所有命令都是在假设您位于该目录中的情况下编写的。如果您出于任何原因更改该目录,请在继续执行此页面上的说明之前更改回该目录。如果您想检查您是否在正确的目录中,请查找一个名为config.json.example- 如果您在当前目录中看到该文件,那么您在正确的目录中。

Habitica 初始配置

通过复制(而不是重命名)示例文件来创建您自己的 config.json 配置文件副本:
cp config.json.example config.json

如果需要,编辑config.json:

通常你不需要这样做,但如果你知道任何理由,你现在就可以这样做。如果需要,您也可以在以后的任何时间对其进行编辑。
编辑 config.json 的一个可能原因是更改 Habitica 的 Express 服务器使用的端口。默认情况下,它使用端口 3000,除非您知道您正在使用相同端口的计算机上运行其他软件,否则没有理由更改它。如果是,请在其中找到BASE_URL和PORT行config.json并将端口更改为合适的数字。两者使用相同的数字。
没有理由更改 ADMIN_EMAIL 的值。它已被弃用,将来可能会被删除。
不要编辑config.json.example。

安装 Habitica 特定要求

安装 Habitica 特定的 npm 包:
npm install

如果该命令显示错误,请尝试重新运行它两到三次,以防故障是由于从 Internet 检索包时超时造成的。

如果这没有帮助,请运行npm ci,这将删除 node_modules 文件夹并重新安装所有软件包,但在安装过程中存在一些差异。

如果您仍然看到任何错误,或者此页面上的任何后续步骤显示有关缺少模块或文件的错误,请按照上述“准备故障排除”部分中的描述寻求帮助。

启动 Habitica Web 服务器

如果您为 Habitica 以外的项目运行 MongoDB 服务器,它将与 Habitica 自己的 MongoDB 实例发生冲突。现在使用 MongoDB 的标准服务器停止命令为您的系统停止该 MongoDB 服务器。(您可以在运行完 Habitica 的服务器之后安全地重新启动它。)
确保您的计算机或虚拟机上设置的时间精确到最接近的秒数,否则您将看到“RequestTimeTooSkewed”错误。
在一个命令提示符或终端中:
启动 Habitica 自己的 MongoDB 实例npm run mongo:dev
等到你看到Started replica set on "mongodb://localhost:27017?replicaSet=rs"后再继续下一步。(第一次运行时,它会在 Habitica 的目录中下载并安装 MongoDB,所以这需要几分钟。)
不要尝试将此终端用于其他任何事情,因为 Mongo 命令需要在那里继续运行。
在第二个命令提示符或终端窗口中,使用以下命令启动 Habitica Web 服务器:
npm start
在第三个命令提示符或终端窗口中,使用npm run client:dev. 这将在您保存对客户端文件的更改时自动重建,并会通知您任何错误。
如下一节所述,查看这三个命令的输出。如果您已经注意到错误消息,该部分将有所帮助。

查看服务器输出

该npm run mongo:dev命令的输出应类似于以下示例。您可能会看到细微的差别(例如,不同的版本号)。

habitica@4.148.1 mongo:dev /home/alys/code/habitica
run-rs -v 4.2.8 -l ubuntu1804 --keep --dbpath mongodb-data --number 1 --quiet

Skipping purge
Running ‘/home/alys/code/habitica/node_modules/run-rs/4.2.8/mongod’ [ 27017 ]
Restarting replica set…
Started replica set on “mongodb://localhost:27017?replicaSet=rs”

启动服务器(来自npm start命令)的输出应该类似于下面的示例。您可能会在系统中看到细微的差异(例如,不同的日期、时间和版本号)。斜体文字描述了您可能看到的信息类型,并非逐字记录。

habitica@4.116.8 start /home/username/habitica
gulp nodemon

[18:39:02] Using gulpfile ~/habitica/gulpfile.js
[18:39:02] Starting ‘nodemon’…
[18:39:02] Finished ‘nodemon’ after 25 ms
[18:39:02] [nodemon] 1.19.4
[18:39:02] [nodemon] to restart at any time, enter rs
[18:39:02] [nodemon] watching dir(s): [directory path(s) here]
[18:39:02] [nodemon] watching extensions: js,mjs,json
[18:39:02] [nodemon] starting node ./website/server/index.js
(node:3348) [ “DeprecationWarnings” might be here and/or below; they do not indicate an error ]
2019-10-20T08:39:08.767Z - info: Express server listening on port 3000
2019-10-20T08:39:08.960Z - info: Connected with Mongoose.

构建网站客户端(来自npm run client:dev命令)的输出分两个阶段出现,首先是构建客户端时的一些初始文本(然后可能会从屏幕上清除),然后输出显示客户端已准备好。

第一阶段应该类似于下面的示例,最后一行快速变化。斜体文字描述了您可能看到的信息类型,并非逐字记录。

habitica@4.116.8 client:dev /home/username/habitica
cd website/client && npm run serve

habitica-client@1.0.0 serve /home/username/habitica/website/client
vue-cli-service serve

INFO Starting development server…
42% building 2584/2635 modules 51 active … [file paths here]

第二阶段应该类似于下面的示例。斜体文本不是逐字逐句的。

DONE Compiled successfully in 12652ms 6:56:45 PM

App running at:

Note that the development build is not optimized.
To create a production build, run npm run build. [This is just informational and not an instruction for you to follow.]

如果您看到任何与这些示例明显不同的输出,尤其是错误或明显的警告消息,请在继续之前自行解决或使用本页顶部“准备故障排除”部分中的指南进行报告。以下是一些带有建议修复的错误示例:

任何错误
首先检查您是否使用了正确版本的node和npm,如上面安装节点和 NPM中所述。如果您使用 nvm 在版本之间交换,这一点尤其重要,因为它可能在您没有意识到的情况下交换了它们。
ECONNREFUSED和/或Proxy error: Could not proxy request /api/v… from localhost:8080 to http://localhost:3000
使用上面安装 MongoDB部分链接到的说明检查您的本地数据库服务器是否正在运行。
npm ERR! code ELIFECYCLE
如果您使用的是 Linux 或 Docker,则此错误很可能是因为 nodemon 需要的文件监视程序比inotify提供的要多。增加文件观察者的数量。在 Ubuntu 和类似的 Linux 发行版上,您可以使用以下命令执行此操作:
echo fs.inotify.max_user_watches=524288 | sudo tee /etc/sysctl.d/50-max-user-watches.conf && sudo sysctl --system
对于其他发行版,请参阅您的发行版的文档。此问题中显示了此错误的一个示例。
npm run mongo:dev如果和npm start的输出npm run client:dev看起来不错,请继续下一部分测试网站。如果您不能完全确定它们是否良好,请继续进行,但如果网站出现故障,您可能需要解决输出中显示的问题。

在浏览器中测试网站

打开浏览器访问http://localhost:8080以测试应用程序。该网站应该看起来与https://habitica.com相同,并且工作方式相同,只是在左下角的“任务”页面上会有一个“调试”菜单(暂时忽略它;它在链接的文档中有所描述在本页末尾,但您还不需要使用它)。

如果您到达网站的首页但没有完成加载,或者您到达登录屏幕但登录按钮没有任何作用,请清除“localhost”域的本地存储。您可以通过单击http://localhost:8080/static/clear-browser-data上的红色“清除数据”按钮或使用浏览器的 JavaScript 控制台(有关如何在首选浏览器中清除本地存储的信息谷歌)。然后重新加载首页。

为您的测试创建一个或多个帐户。本地安装使用的数据库托管在您的机器上;它与 Habitica 本身使用的数据库不同,因此您无法使用普通的 Habitica 帐户。

后续步骤:使用本地安装

现在您已经在本地安装了 Habitica 网站,请阅读使用您的本地安装来修改 Habitica 的网站和 API以了解如何贡献代码。

阅读《铁匠指南》也很重要,其中包含有关使用的技术、Habitica 代码的结构、如何提供帮助的想法以及其他信息的信息。

原文链接>>

0

评论区