Web 应用 - CLI 安装
ZET 是一个 CLI 工具,可帮助开发者构建基于客户端的应用(应用市场的应用)并在本地进行测试。开发者可以在本地应用中编写代码并本地测试,而不必将应用文件上传至服务器。ZET 将帮助开发者完成以下操作:
- 使用基本必需文件和文件夹结构自动创建项目模板。
- 运行本地 HTTP 服务器以处理应用内容。
- 验证应用。
- 打包应用以便上传。
安装必要组件
前提条件:
- 从以下网址下载 nodejs 源代码:https://nodejs.org/en/download/。
- 安装 Node 后,通过运行以下命令进行验证。
$ node -v
$ npm -v
CLI 安装
运行以下命令以安装 zet cli node 包。
$ npm install -g zoho-extension-toolkit
备注:
- 如果您无权安装该工具,请在执行命令前使用 sudo。
- -g 选项确保以全局方式安装该模块。因此,可在任何位置访问该 cli 命令。
运行以下命令以确保安装成功。
$ zet // 有关“zet”命令的信息将会显示出来。
创建项目
运行以下命令以创建新项目。
$ zet init
此命令将显示您要为其创建项目模板的 Zoho 服务的列表。选择 Catalyst 作为服务。
要验证服务器是否成功启动,请在浏览器中打开以下 URL:http://localhost:5000/plugin-manifest.json 或者 http://localhost:5000/app/app_file.html
包含资源
呈现 web 应用时需要的所有文件出现在您项目的“app”文件夹中。
启动服务器
要启动本地 HTTP 服务器以允许在本地运行您的应用并在沙箱实例中进行测试,请运行以下命令:
$ zet run
这将在本地机器的端口 5000 中运行 HTTP 服务器。启动服务器之前,此端口不应被任何其他进程占用。
要验证服务器是否成功启动,请在浏览器中打开以下 URL:
http://127.0.0.1:5000/app/app_file.html
验证和打包 web 应用
运行以下命令时,将验证应用程序源代码以确保它遵循 <> 章节中提供的准则。
$ zet validate
接下来将提供验证结果。如果显示了任何验证错误,那么需要对其进行修正。如果未修正验证问题,那么无法在 Zoho 开发者控制台中上传该应用,因为在 zet 服务中上传该应用程序时将进行同一代码检查。
打包
您使用的项目文件夹包含应用源代码及进行本地测试所需的一些节点模块。在 Zoho 应用市场中上传该应用时,确保该 zip 文件仅包含该应用程序的相关文件和文件夹。
为简化打包过程,已提供名为“pack”的命令,此命令将单独使用该应用的相关文件创建 zip 文件(排除节点模块相关文件)。此 zip 现在可供上传。
$ zet pack