Для разработки и управления проектами 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
Создайте новый проект скрипта приложений
Эта команда создает новый сценарий в текущем каталоге с необязательным заголовком сценария.
clasp create [scriptTitle]
Эта команда также создает два файла в текущем каталоге:
- Файл
.clasp.json, в котором хранится идентификатор скрипта. - Файл манифеста проекта
appsscript.json, содержащий метаданные проекта.
Клонировать существующий проект
Эта команда клонирует существующий проект в текущем каталоге. Сценарий должен быть создан или опубликован в вашей учетной записи Google. Вы указываете проект сценария для клонирования, указав его идентификатор сценария.
Чтобы найти идентификатор сценария проекта, выполните следующие действия:
- Откройте проект скрипта приложений.
- Слева нажмите проекта .
В разделе «Идентификаторы» скопируйте идентификатор сценария.
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
Откройте проект в редакторе сценариев приложений.
Эта команда открывает проект сценария в редакторе сценариев приложений. Редактор запускается как новая вкладка в веб-браузере по умолчанию.
clasp open
Внесите свой вклад в проект с открытым исходным кодом clasp
Внесите свой вклад в clasp на GitHub .