Для разработки проектов 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. Вы указываете проект сценария для клонирования, указывая его идентификатор сценария.
Чтобы найти идентификатор сценария проекта, выполните следующие действия:
- Откройте проект 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.
Эта команда открывает проект сценария в редакторе сценариев приложений. Редактор запускается как новая вкладка в веб-браузере по умолчанию.
clasp open
Внесите свой вклад в проект clasp
с открытым исходным кодом.
Примите участие в разработке clasp
на GitHub .