Skip to main content

上架应用程序的要求

GitHub Marketplace 上的应用程序必须满足本页列出的要求才能发布上架。

注意:本文适用于仅在 GitHub Marketplace 中发布 GitHub Apps 的情况。 若要详细了解如何在 GitHub Marketplace 中发布 GitHub Actions,请参阅“在 GitHub Marketplace 中发布操作”。

在 GitHub Marketplace 中上架应用程序的要求取决于您是要提供免费应用程序还是付费应用程序。

对所有 GitHub Marketplace 上架产品的要求

GitHub Marketplace 中的所有上架产品应该是能够为 GitHub 社区提供价值的工具。 当你提交列表以供发表时,必须阅读并接受“GitHub Marketplace 开发人员协议”的条款。

所有应用程序的用户体验要求

所有上架产品应满足以下要求,无论它们是免费应用程序还是付费应用程序。

  • 上架信息不得主动诱导用户离开 GitHub。
  • 上架信息必须包含发布者的有效联系信息。
  • 上架信息必须包含应用程序的相关说明。
  • 上架信息必须指定定价计划。
  • 应用程序必须为客户提供价值,并通过身份验证以外的其他方式与平台集成。
  • 应用程序必须在 GitHub Marketplace 中公开可用,并且不能是测试版或只能通过邀请获取。
  • 应用程序必须设置 web 挂钩事件,以便在发生计划更改或取消时通过 GitHub Marketplace API 通知发布者。 有关详细信息,请参阅“在应用程序中使用 GitHub Marketplace API”。

有关提供良好客户体验的详细信息,请参阅“应用程序的客户体验最佳实践”。

所有应用程序的品牌和上架要求

为了保护您的客户,我们建议您还要遵循安全最佳实践。 有关详细信息,请参阅“GitHub Marketplace 上的应用的安全最佳做法”。

免费应用程序注意事项

GitHub Marketplace 鼓励使用免费应用程序,这是提供开源服务的好方法。 如果您在 GitHub Marketplace 的外部上架了应用程序的付费版本,则您在 GitHub Marketplace 中上架该应用程序时,必须提供至少一个付费计划。

付费应用程序的要求

要在 GitHub Marketplace 上发布应用程序的付费计划,您的应用程序必须由身份为经验证发布者的组织所拥有。 有关验证过程或转移应用所有权的详细信息,请参阅“为组织申请发布者验证”。

如果您的应用程序已发布,并且您是经验证的发布者,则您可以使用定价计划编辑器发布新的付费计划。 有关详细信息,请参阅“为上架产品设置定价计划”。

要发布付费应用程序(或提供付费计划的应用程序),您还必须满足以下要求:

  • GitHub Apps 应至少有 100 个安装设施。
  • OAuth apps 应至少有 200 个用户。
  • 所有付费应用程序必须处理关于新购买、升级、降级、取消和免费试用的 GitHub Marketplace 购买事件。 有关详细信息,请参阅下面的“付费应用的计费要求”。

当您准备在 GitHub Marketplace 上发布应用程序时,您必须请求验证应用程序上架信息。

注意:如果你想销售个人帐户拥有的应用,需要先将应用转移到组织,然后请求验证组织创建的列表。有关如何将应用转移到组织的信息,请参阅:“提交要发布的上架信息”。

付费应用程序的计费要求

您的应用程序无需处理付款,但需要使用 GitHub Marketplace 购买事件来管理新购买、升级、降级、取消和免费试用。 有关如何将这些事件集成到应用的信息,请参阅“在应用程序中使用 GitHub Marketplace API”。

GitHub 的计费 API 允许客户在不离开 GitHub 的情况下购买应用程序,并使用已附加到其在 GitHub.com 上帐户的付款方式来支付服务费用。

  • 应用程序必须在付费订阅计划中支持月度和年度计费。
  • 上架产品可提供免费和付费计划的任何组合。 免费计划是可选项,但建议提供。 有关详细信息,请参阅“为上架产品设置定价计划”。