跳转到内容

Panel Studio

Panel Studio 是 PlaidCloud 中用于编辑 Panel 应用的编辑器。它在编辑器旁显示应用的文件,构建可打开的私有预览,并在准备就绪时发布应用。开始时无需 git 仓库。

  • 在项目的主页看板上,选择某个 Panel 应用的在 Studio 中打开。
  • 在应用中,选择应用所在行的 Studio。

要开始新应用,请选择新建应用 > Studio。它也位于项目主页选项卡应用与品牌设置卡片的 Studio 应用行中。要基于某个表构建应用,请在项目的表选项卡上选中该表,然后选择创建 Panel 应用。

新建 Studio 应用对话框提供五种起始来源:

起始来源 得到的内容
空白应用 包含 app.py 和 requirements.txt 的最小应用。
来自表 基于所选表构建的应用。
来自视图 同上,基于项目视图构建。
来自另一个 Studio 应用 您的某个 Studio 应用的副本。
来自应用库 工作区已在应用库中列出的某个应用的副本。

为应用命名,选择其项目,然后选择创建。Studio 会打开新应用,文件列在左侧。对于表或视图,Weave 构建应用首页的提示已准备好发送。请参阅创建 Panel 应用。

Studio 应用是工作区 apps 仓库中以应用命名的文件夹(<app-slug>/),该仓库位于 PlaidCloud Git 中,与其他 Panel 应用所在的仓库相同。Studio 不会为应用单独创建仓库,因此可以在 apps 中与其他应用一起查找和编辑其源代码。

  • 草稿分支。 尚未上线的工作保存在名为 studio-<app-slug> 的分支上。发布会将该分支上应用的文件夹复制到主分支。
  • 重新构建。 仅当某个应用的文件夹或仓库根目录的 requirements.txt 发生更改时,推送到 apps 才会重新构建该应用。
  • 现有应用。 原本位于独立仓库中的 Studio 应用会自动移入其文件夹。旧仓库会被归档:它会保留为只读,且永远不会被删除。

在列表中选择一个文件,即可在编辑器中编辑。在 requirements.txt 中列出 Python 依赖项,每行一个包。应用构建时会安装这些依赖项。

选择询问 Weave,让 Weave 为您编写或修改应用。请参阅使用 Weave 构建 Panel 应用。

保存 仅草稿 预览 仅编辑者 发布 线上应用
只有发布后,您的编辑才会对查看者生效。

保存会将更改存为草稿。线上应用不会改变,其他人也看不到草稿。

预览会将已保存的草稿构建为私有副本并打开。只有应用的编辑者才能打开预览。

  • 预览在 24 小时未保存后会被移除。
  • 一个工作区同时最多可有 10 个预览。
  • 再次保存并选择预览,即可查看最新的编辑。

发布会用已保存的草稿替换线上应用。它要求对应用所在项目具有编辑权限,Studio 会先请您确认。

如果在您打开应用后有其他人发布了更改,Studio 会报告冲突,而不是覆盖对方的工作。请重新加载应用,将您的编辑合并过去,然后再次发布。

构建选项卡显示最新构建的状态,并在运行时实时更新。构建失败时,该选项卡会列出每个错误及其所在文件和行号,便于直接跳转到相应行。requirements.txt 中的依赖项问题会附带修复提示。

错误和警告也会标记在编辑器中对应的行上,方便您在问题所在之处查看。

有关应用发布后各状态的含义,请参阅使用 Panel 应用。

历史记录选项卡按从新到旧的顺序列出应用的每个已发布版本及其构建状态。选择加载更多可查看更早的版本。

要回到早期版本,请在该版本上选择还原并确认。还原后的版本会成为线上应用并重新构建。您未保存的草稿不会丢失:它仍保留在草稿中,并在下次发布时叠加在还原后的版本之上上线。如果应用已与该版本一致,Studio 会提示这一点,且不做任何更改。如果在您还原期间有人发布,Studio 不会还原任何内容,并请您重试。

洞察选项卡显示用户如何使用应用以及应用的响应速度。可选择最近 7、14 或 30 天。

部分 显示内容
每日浏览量 应用每天被打开的次数。
页面加载 该时间段内页面加载的中位时间,以及 95% 的加载所快于的时间。
最慢的查询 耗时最长的查询,以及其运行频率及其中位、慢端和最慢耗时。
错误 该时间段内出错的情况,按错误类型及其在应用中发生的位置划分。

当某个时间段的活动量超过洞察所能读取的范围时,它会说明数据不完整。当页面加载超出应用的性能预算时,洞察会警告超出的数量以及哪些查询较慢。洞察从不显示查询返回的数据,也不显示打开应用的人员姓名。

历史记录和洞察选项卡要求应用已分配到某个项目;未分配的应用会显示分配提示。

选择提醒与摘要,可设置通知:监视应用数据中的某个数值并在其越过限值时通知您,或按计划发送摘要。请参阅提醒与摘要。

在 Studio 中选择应用库…。选择在应用库中列出,可将应用列为模板,任何能查看其项目的人都可据此创建自己的应用;选择从应用库中移除则将其移除。该按钮适用于属于某个项目的应用。您需要拥有该项目的编辑权限。请参阅应用库。

选择固定到主页,可将应用添加到项目的主页看板;选择从主页取消固定则将其移除。

删除 Panel 应用前会先请您确认。在应用中,使用应用所在行的减号图标。取消发布同样需要确认。