开发者门户

它是什么?

开发者门户是一个 Pi 应用,您可以通过它注册成为开发者并获取开发者凭证,从而创建第三方 Pi 应用——这些 Web 应用可以通过 Pi 浏览器访问。通过在此处声明您的应用 URL,您的应用即可访问 Pi 应用平台,并与 Pi 服务器和 Pi 区块链进行通信。

您的应用将可通过树莓派浏览器上的自定义 URL 直接访问。您可以将应用放在任何您想要的域名下(包括 .pi 域名),并且仍然可以拥有一个功能齐全的树莓派应用。

要访问此功能,请在 Pi 浏览器中访问 develop.pi,或者打开 Pi 浏览器并单击 develop.pi 图标。

如果您之前没有确认 Pi 开发者协议,当您点击“注册应用”时,将会弹出窗口提醒您进行确认。

注册应用程序

在注册您的第一个应用程序之前,您必须在 Pi Mining 应用程序个人资料中验证您的电子邮件地址。您可以按照“入门清单”步骤 4 中列出的流程完成此操作。

创建新应用

打开开发者门户后,首页会简要介绍应用并显示一些重要信息。页面底部会显示“更多信息”和“注册新应用”按钮。如果您之前注册过应用,则会显示如下所示的“我的应用”页面。点击“新应用”按钮即可开始注册新应用。

申请创建表单包含以下步骤:

添加应用名称

如果你的应用关联了一个 Brainstorm 项目,则应使用相同的名称。

应用描述

选择网络

更多信息请参见下方标题。

未来,我们可能会在 Brainstorm 和开发者门户之间搭建一座桥梁,从而实现整个应用程序生命周期的无缝衔接。

选择网络

这是最关键的一步,它将决定您的应用连接到哪个网络。选择 Pi 主网后,当您在 Pi 浏览器中访问此应用时,它将连接到 Pi 主网区块链。Pi 主网上没有 Test-Pi 交易,所有交易都将用于真正的 Pi。Pi 测试网是用于测试的网络。所有测试网交易均使用 Test-Pi,并通过 Pi 钱包免费提供。建议所有项目首先构建一个测试网应用,并在测试完成后再创建一个用于主网的应用。

重要提示:为了方便交易,开发者最近一次访问的钱包地址将用作项目钱包地址。所有应用指向的网络交易都将使用此地址进行处理。如果开发者尚未在 Pi 测试网上创建钱包,则所有交易都将失败,直到创建钱包为止。如果您需要注册钱包,请通过 Pi 浏览器访问 wallet.pi 进行创建。在获得 Pi 主网钱包之前,必须完成 Pi KYC 流程,以确保每位 Pioneer 都是真人。鉴于此要求,建议开发者首先在测试网上发布其应用,任何人都可以在测试网上创建钱包。

应用注册成功后,开发者门户的首页将显示如下内容。您可以在此菜单中点击项目,即可加载该项目的应用控制面板。

开发者门户应用列表

仪表盘按钮

点击“?”了解开发者门户。

点击“+”号将创建一个新应用

👥是奖励功能,点击此处输入您的2022年黑客马拉松代码。

应用仪表盘

开发者门户中的应用仪表盘显示了与应用相关的所有信息。开发者可以通过此仪表盘更新信息。在“应用概览”视图和“应用详情”视图之间切换,即可查看与应用相关的所有信息。

下图显示了应用控制面板在开发者门户中的显示方式。


应用仪表盘

应用清单

本清单涵盖了应用程序注册和发布准备的所有步骤。本页共包含 9 个步骤,所有步骤均列于“入门清单”的第 5 步至第 13 步中。请查看该清单,了解具体步骤并熟悉应用程序发布所需的步骤。

步骤 8:验证域名所有权

如果您选择自行托管应用程序,则需要验证您的域名所有权。这是为了防止开发者从他们不拥有或不代表的网站创建应用程序。例如,您不应该能够冒充 wikipedia.com 域名。

为了证明您对该域名的所有权,您需要在域名根目录下放置一个特定文件。该文件的内容必须与开发者门户网站上灰色框中文本字段的内容完全一致。

将包含正确内容的文件放置到域名根目录后,您可以点击“验证域名”按钮。您可能会看到一条包含调试信息的错误提示,或者灰色方框消失,域名 URL 旁边会出现一个绿色对勾。至此,您的域名所有权已通过验证,您可以通过在地址栏中输入应用 URL,使用 Pi Browser 访问您的应用。

应用程序配置

以下所有字段均可在应用程序的控制面板中访问的应用程序配置功能中进行编辑。

白名单用户

如果注册的是连接到树莓派测试网的应用,开发者可以选择允许所有访客访问,或者仅允许特定先锋用户访问。如果您希望允许所有人测试该应用,请将此字段留空。否则,您可以添加最多 10 个树莓派用户名来限制访问权限。这些先锋用户可以在注册后进行更改、删除或添加。

托管选项:自行托管或由 Pi 核心团队托管

在表格中间,系统会询问您是否希望应用程序自行托管,还是由 Pi Core Team 托管。

自托管

自托管意味着您需要自行管理应用程序服务器和网站托管。您拥有自己的基础设施,并负责日常托管运维。如果您选择此选项,系统会要求您输入应用程序的前端 URL。请参阅下方的“前端验证”部分,了解如何验证此前端 URL。限时优惠,使用此链接注册Digital Ocean 托管服务,即可获得 200 美元免费额度。

即将推出 - 由 Pi 核心团队主办

Pi 核心团队将托管您的应用程序——您无需管理基础设施,也无需担心可用性问题,只需管理应用程序的代码库即可。虽然所有人都可以选择自行托管,但 Pi 核心团队托管选项需要获得 Pi 核心团队的批准。如果您的应用程序支持 Pi 核心团队托管,则可通过 Pi App Engine 进行托管。

最后,当您选择此操作时,系统会要求您输入 GitLab 用户名,而不是前端 URL。这有助于 Pi 核心团队为您提供一个已集成到 Pi 核心团队部署流程中的 GitLab 项目。

生产环境网址

在此字段中,您应该输入此应用程序的访问 URL。如果是主网应用程序,则此 URL 应该是您将提供给 Pioneer 的 URL,以便他们可以通过 Pi Browser 访问该应用程序。如果是测试网应用程序,则此 URL 应该是您的测试 URL,您可以选择是否公开此 URL。此 URL 必须包含 https:// 前缀。

开发网址

这是本地运行的开发应用程序的 URL(例如 http://localhost:3000/)。沙盒将使用此 URL 访问您的本地应用程序实例。有关在沙盒中运行开发应用程序的更多信息,请参阅“沙盒标志”部分。

API密钥

Pi 应用平台自带 Pi API,您可以通过它执行 HTTP 请求。目前,这些 API 仅用于处理用户验证和支付,但未来会添加更多功能,例如从您的应用程序在 Pi Chat 上创建聊天对话。

在项目应用控制面板底部,您可以看到一个名为“API密钥”的部分。作为应用开发者,您需要使用此密钥才能访问Pi后端。请妥善保管!任何拥有此密钥的人都可以冒充您。

请注意,访问公共 Pi 区块链无需任何 API 密钥。您只需使用 App 的私钥创建交易,并通过任何公共节点(例如,您自己的节点、Pi 核心团队的节点,或任何其他运行“区块链 API 服务”的节点)将其直接提交到区块链。但请注意,在当前的封闭主网期间,只有 Pi 核心团队的节点才能运行 Pi 主网区块链,而任何节点都可以运行 Pi 测试网区块链。更多详情,请参阅此处更新的白皮书章节草稿。

打赏 Pi 打赏 微信打赏