Используйте интерфейс командной строки с застежкой

Для разработки проектов Apps Script и управления ими с вашего терминала, а не из редактора Apps Script, вы можете использовать инструмент с открытым исходным кодом под названием clasp .

Лаборатория кода clasp предоставляет обзор всех функций clasp .

Функции

Разрабатывайте локально

clasp позволяет разрабатывать проекты Apps Script локально. Вы можете написать код на своем компьютере и загрузить его в Apps Script, когда закончите. Вы также можете загрузить существующие проекты Apps Script, чтобы редактировать их в автономном режиме. Поскольку код является локальным, при создании проектов Apps Script вы можете использовать свои любимые инструменты разработки, такие как 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 .

Авторизоваться

Эта команда входит в систему и разрешает управление проектами Apps Script вашей учетной записи Google. После запуска вам будет предложено войти в учетную запись Google, где хранятся ваши проекты Apps Script.

clasp login

Выход из системы

Эта команда выходит из инструмента командной строки. Прежде чем продолжать использовать clasp вам необходимо повторно войти в систему, используя clasp login для повторной аутентификации в Google.

clasp logout

Создайте новый проект Apps Script.

Эта команда создает новый сценарий в текущем каталоге с необязательным заголовком сценария.

clasp create [scriptTitle]

Эта команда также создает два файла в текущем каталоге:

  • Файл .clasp.json в котором хранится идентификатор сценария.
  • Файл манифеста проекта appsscript.json содержащий метаданные проекта.

Клонировать существующий проект

Эта команда клонирует существующий проект в текущем каталоге. Сценарий должен быть создан или опубликован в вашей учетной записи Google. Вы указываете проект сценария для клонирования, указывая его идентификатор сценария.

Чтобы найти идентификатор сценария проекта, выполните следующие действия:

  1. Откройте проект Apps Script.
  2. Слева нажмите параметров проекта .

  3. В разделе «Идентификаторы» скопируйте идентификатор сценария.

     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.

Эта команда открывает проект сценария в редакторе сценариев приложений. Редактор запускается как новая вкладка в веб-браузере по умолчанию. 

clasp open

Внесите свой вклад в проект clasp с открытым исходным кодом.

Примите участие в clasp на GitHub .