开发人员空间 - 开发扩展程序

您可通过开发人员空间中的“开发扩展程序”部分创建自己的 eWidget 扩展程序。您创建的扩展程序可以供其他用户从 Marketplace 安装并使用。 

Zoho Marketplace

Zoho Marketplace 是一个在线平台，提供扩展程序和小部件，可帮助用户增强跨多个应用程序的工作流程。用户可以从 Zoho Marketplace 安装扩展程序，从而在 Zoho 应用程序的现有功能基础上加以扩展。 

除了已经可用的扩展程序外，开发人员现在还可以为 Zoho Mail 创建更全面的扩展程序。可以构建这些扩展以将 Zoho Mail 的功能与第三方应用程序的功能集成在一起。这有助于用户构建适合自定义要求的扩展程序。 

构建扩展程序后，必须将其提交以供审核。分析功能后，您的扩展程序将获得批准，并将在 Zoho Marketplace 上发布，所有 Zoho 用户都可以安装和使用该应用程序。

开发扩展程序

您可以使用预先填充的 Zoho Mail 插件清单直接从 Zoho Sigma 平台开始构建扩展程序。或者，您也可以使用 ZET CLI 构建扩展程序，然后将文件上传到 Zoho Sigma 进行提交。 

在 Zoho Sigma 中创建扩展程序 

首先，在 Zoho Sigma 中为自己创建一个工作区，步骤如下：

1. 登录到 Zoho Sigma
2. 输入您的工作区名称
3. 单击创建工作区

创建工作空间后，单击右上角的新建扩展程序按钮。输入详细信息，例如名称和描述，然后从服务部分中选择 Zoho Mail。然后单击另存为草稿并按照此帮助页面中提供的详细说明，开始在 Sigma 中创建扩展程序。 

使用 ZET CLI 创建扩展程序

命令行界面 (CLI) 用于创建和打包小组件。Zet 命令是用于为 Zoho Mail 打包小部件的 CLI。

先决条件

为了为 Zoho Mail 创建自己的小部件，您需要下载 nodejs。您可以从这里下载它。（不支持 7 以下版本）

您可以通过运行以下命令来验证节点：

$ node -v 验证节点的版本。
$ npm -v 验证 npm 的版本。

安装

使用以下命令安装 ZET（Zoho 扩展套件）CLI。

$ npm install -g zoho-extension-toolkit@latest 

运行以下 ZET 命令来验证安装。将显示有关各种支持命令的帮助详细信息：

$ zet

创建一个项目

使用以下命令创建项目：

$ zet init

将显示 Zoho 服务的列表。选择 Zoho Mail 然后按 Enter 键。

系统将提示您提供项目名称。键入首选项目名称，然后按 Enter 键。

包括资源

输入项目名称后，将在系统上创建同名目录。它包含所有必需的文件夹、文件和软件包。

导航到项目目录并打开“App”文件夹。将小部件的资源包含到相关的子文件夹中。

运行服务器

运行以下命令启动在本地运行扩展程序的 http 服务器：

$ zet run

此命令使用本地计算机的 5000 端口。在启动服务器之前，请确保 5000 端口未被占用。

要验证服务器是否成功运行，请在浏览器中打开给定的 URL：

http://127.0.0.1:5000/

验证并打包

执行以下命令验证您的扩展程序：

$ zet validate

您的扩展程序需要遵循下面给出的规范。运行 validate 命令将识别任何违反规范的行为（如果有）。任何此类违规行为都需要在上传 zip 之前得到纠正。

运行以下 pack 命令来创建一个 zip 文件，其中包含运行扩展程序所需的所有文件和文件夹：

$ zet pack

zip 位于项目目录的 dist 文件夹中。您可以将此 zip 上传到 Marketplace。

规格

您的扩展的项目目录包含一个 plugin-manifest.json 文件。此文件包含扩展程序的配置详细信息。此文件中包含的密钥需要遵循以下配置：

• locale：这是扩展的默认语言环境。项目目录的 translation 文件夹应包含所有翻译文件。文件的格式应为“<locale-code>.json”。 
• *service：为其创建扩展程序的 Zoho 产品。 
  • 在为 Zoho Mail 创建扩展程序时，服务密钥将在清单中自动填充为 "service": "MAIL"。
• storage：如果您希望扩展程序存储应用程序数据，则应将此键的值设置为“true”。
• logo：您希望用作扩展程序徽标的图像的文件路径。例如：“apps/images/logo.png”
• *modules：小组件是用于 Zoho 邮件扩展程序的模块。它是扩展程序详细信息构成的阵列。小组件模块必须具有以下一组属性。
  • location：您的小组件在 Zoho 产品中的位置。对于 Zoho Mail 来说，它必须是“zoho.mail.preview.rightpanel”。
  • name：小组件的项目目录的名称。这是自动填充的。
  • url：这是为您的小组件定义的路径。

    清单示例：
    
    "modules": {
          "widgets": [
    ​                         {
                                    "location": "zoho.mail.preview.rightpanel",
                                    "name": "extension_name",
                                    "url": "/app/widget.html"
                             }
                        ]
    ​                 }