如需从终端(而非 Apps 脚本编辑器)开发和管理 Apps 脚本项目,您可以使用名为 clasp
的开源工具。
clasp
Codelab 简要介绍了所有 clasp
功能。
功能
在本地开发
clasp
可让您在本地开发 Apps 脚本项目。您可以在自己的计算机上编写代码,完成后将其上传到 Apps 脚本。您还可以下载现有的 Apps 脚本项目,以便在离线时对其进行修改。由于代码是本地的,因此您可以在构建 Apps 脚本项目时使用自己喜爱的开发工具,例如 git
。
管理部署版本
创建、更新和查看项目的多个部署。
结构化代码
clasp
可让您将代码整理到目录中,当您将代码上传到 script.google.com 时,这些目录会保留。例如:
# On script.google.com: ├── tests/slides.gs └── tests/sheets.gs # Locally: ├── tests/ │ ├─ slides.gs │ └─ sheets.gs
要求
clasp
是使用 Node.js 编写的,并通过 npm
工具分发。在使用 clasp
之前,您必须安装 Node.js 4.7.4 版或更高版本。安装 Node.js 需要管理员权限。
安装
安装 Node.js 后,您可以使用以下 npm
命令来安装 clasp
:
npm install @google/clasp -g
安装完成后,您可以在计算机上的任何目录中使用 clasp
命令。
使用 clasp
您可以使用 clasp
从命令行处理各种任务。本部分介绍了使用 clasp
进行开发时可以执行的常见操作。
登录
此命令用于登录并授权管理您的 Google 账号的 Apps 脚本项目。运行后,系统会要求您登录存储 Apps 脚本项目的 Google 账号。
clasp login
退出
此命令会退出命令行工具。您必须使用 clasp login
重新登录,以便重新通过 Google 进行身份验证,然后才能继续使用 clasp
。
clasp logout
创建新的 Apps 脚本项目
此命令会在当前目录中创建一个新脚本,并提供可选的脚本标题。
clasp create [scriptTitle]
此命令还会在当前目录中创建两个文件:
- 存储脚本 ID 的
.clasp.json
文件。 - 包含项目元数据的
appsscript.json
项目清单文件。
克隆现有项目
此命令会在当前目录中克隆现有项目。脚本必须由您的 Google 账号创建或与您的 Google 账号共享。您可以通过提供脚本 ID 来指定要克隆的脚本项目。
如需查找项目的脚本 ID,请按以下步骤操作:
- 打开 Apps 脚本项目。
- 点击左侧的项目设置图标 。
在“ID”下,复制脚本 ID。
clasp clone <scriptId>
下载脚本项目
此命令会将 Apps 脚本项目从 Google 云端硬盘下载到您计算机的文件系统。
clasp pull
上传脚本项目
此命令会将脚本项目的所有文件从您的计算机上传到 Google 云端硬盘。
clasp push
列出项目版本
此命令会列出脚本项目的每个版本的编号和说明。
clasp versions
部署已发布的项目
您可以将脚本项目部署为 Web 应用、插件或可执行文件。您可以在脚本编辑器中、项目清单中或使用 clasp
创建部署。
如需使用 clasp
部署项目,请先创建 Apps 脚本项目的不可变版本。版本是脚本项目的“快照”,类似于只读的分支版本。
clasp version [description]
此命令会显示新创建的版本号。使用该编号,您可以部署和取消部署项目的实例:
clasp deploy [version] [description] clasp undeploy <deploymentId>
此命令会使用新版本和说明更新现有部署:
clasp redeploy <deploymentId> <version> <description>
列出部署
此命令会列出脚本项目的部署 ID、版本及其说明。
clasp deployments
在 Apps 脚本编辑器中打开项目
此命令会在 Apps 脚本编辑器中打开一个脚本项目。编辑器会在默认网络浏览器中以新标签页的形式启动。
clasp open
为 clasp
开源项目做出贡献
在 GitHub 上为 clasp
贡献代码。