跳转到内容

Panel Studio

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

  • 在项目的 主页 看板上,选择 Panel 应用上的 Open in Studio。
  • 在 我的 Panel 应用 中,选择应用所在行上的 Open in Studio。

若要开始新应用,请在任一位置选择 Create app。

Create app 对话框提供五种起点:

起始来源 您将获得
Blank 一个包含 app.py 和 requirements.txt 的最简应用。
表 基于您所选表构建的应用。
视图 同样,但基于项目视图构建。
模板 来自 Panel 应用套件的现成应用。
From the gallery 工作区已列入应用库的应用的副本。

为应用命名,选择其 项目,然后选择 创建。Studio 会打开新应用,文件列在左侧。

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

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

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

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

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

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

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

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

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

错误和警告也会标记在编辑器中的对应行上,让您在问题所在位置看到它。

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

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

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

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

部分 显示内容
Views per day 应用每天被打开的次数。
Page load 加载时间的中位数,以及 95% 的加载所快于的时间,取自该期间的页面加载。
Slowest queries 耗时最长的查询,以及其运行频率及中位数、慢端和最慢耗时。
错误 该期间出了什么问题,按错误类型及其在应用中发生的位置划分。

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

两个选项卡都要求应用已分配到项目;未分配的应用会显示分配提示。

选择 Alerts & Digests 可设置通知,用于监视应用数据中的某个数值并在其越过限值时通知您,或按计划发送摘要。请参阅警报和摘要。

选择 Gallery… 可将应用列为模板,让任何可以查看其项目的人都能据此创建自己的应用,也可以将其从应用库中移出。请参阅应用库。

选择 Pin to Home 可将应用添加到项目的 主页 看板,选择 Unpin from Home 则将其移除。

删除 Panel 应用时会先要求您确认。在 我的 Panel 应用 中,使用应用所在行上的 减号 图标。取消发布也会要求您确认。