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

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

Для разработки и управления проектами 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. Вы указываете проект сценария для клонирования, указав его идентификатор сценария.

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

  1. Откройте проект скрипта приложений.
  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

Откройте проект в редакторе сценариев приложений.

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

clasp open

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

Внесите свой вклад в clasp на GitHub .