Для разработки и управления проектами Apps Script из терминала, а не из редактора Apps Script, вы можете использовать инструмент с открытым исходным кодом под названием clasp .
В лабораторной работе по clasp представлен обзор всех функций clasp .
Функции
Развиваться локально
clasp позволяет разрабатывать проекты Apps Script локально. Вы можете писать код на своём компьютере и загружать его в Apps Script по завершении. Вы также можете скачать существующие проекты Apps Script, чтобы редактировать их без подключения к Интернету. Поскольку код хранится локально, вы можете использовать ваши любимые инструменты разработки, например, git при сборке проектов Apps Script.
Управление версиями развертывания
Создавайте, обновляйте и просматривайте множественные развертывания вашего проекта.
Структурный код
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 .
Авторизоваться
Эта команда входит в систему и разрешает управление проектами Apps Script вашей учётной записи Google. После выполнения вам будет предложено войти в учётную запись Google, в которой хранятся ваши проекты Apps Script.
clasp login
Выйти
Эта команда завершает работу с инструментом командной строки. Необходимо повторно войти в систему с помощью clasp login для повторной аутентификации в Google, прежде чем продолжить использование clasp .
clasp logout
Создайте новый проект Apps Script
Эта команда создает новый скрипт в текущем каталоге с необязательным заголовком скрипта.
clasp create [scriptTitle]
Эта команда также создает два файла в текущем каталоге:
- Файл
.clasp.json, хранящий идентификатор скрипта. - Файл манифеста проекта
appsscript.json, содержащий метаданные проекта.
Клонировать существующий проект
Эта команда клонирует существующий проект в текущем каталоге. Скрипт должен быть создан или предоставлен в общий доступ к вашей учётной записи Google. Вы указываете проект скрипта для клонирования, указывая его идентификатор.
Чтобы найти идентификатор скрипта проекта, выполните следующие действия:
- Проект Open Apps Script.
- Слева нажмите проекта .
В разделе «Идентификаторы» скопируйте идентификатор скрипта.
clasp clone <scriptId>
Загрузить проект сценария
Эта команда загружает проект Apps Script из Google Диска в файловую систему вашего компьютера.
clasp pull
Загрузить проект сценария
Эта команда загружает все файлы проекта скрипта с вашего компьютера на Google Диск.
clasp push
Список версий проекта
Эта команда выводит список и описание каждой версии проекта скрипта.
clasp versions
Развернуть опубликованный проект
Вы можете развернуть проекты скриптов как веб-приложения, надстройки или исполняемые файлы. Развертывания можно создавать в редакторе скриптов, в манифесте проекта или с помощью clasp .
Чтобы развернуть проект с помощью clasp , сначала создайте неизменяемую версию проекта Apps Script. Версия — это «снимок» проекта скрипта, аналогичный релизу с веткой, доступному только для чтения.
clasp version [description]
Эта команда отображает номер только что созданной версии. Используя этот номер, вы можете разворачивать и отменять развёртывание экземпляров вашего проекта:
clasp deploy [version] [description]
clasp undeploy <deploymentId>
Эта команда обновляет существующее развертывание новой версией и описанием:
clasp redeploy <deploymentId> <version> <description>
Список развертываний
Эта команда выводит список идентификаторов развертывания проекта скрипта, версий и их описаний.
clasp deployments
Откройте проект в редакторе Apps Script.
Эта команда открывает проект скрипта в редакторе Apps Script. Редактор открывается в новой вкладке вашего веб-браузера по умолчанию.
clasp open
Внесите свой вклад в проект с открытым исходным кодом clasp
Внесите свой вклад в clasp на GitHub .