Używanie interfejsu wiersza poleceń z zapięciem

Aby tworzyć projekty Apps Script i zarządzać nimi w terminalu, a nie w edytorze Apps Script, możesz użyć narzędzia open source o nazwie clasp.

claspĆwiczenie z programowania zawiera omówienie wszystkich funkcji clasp.

Funkcje

Tworzenie lokalnie

clasp umożliwia tworzenie projektów Apps Script lokalnie. Możesz napisać kod na swoim komputerze i przesłać go do Apps Script, gdy skończysz. Możesz też pobrać istniejące projekty Apps Script, aby edytować je offline. Ponieważ kod jest lokalny, podczas tworzenia projektów Apps Script możesz używać swoich ulubionych narzędzi dla programistów, takich jak git.

Zarządzanie wersjami wdrożeń

Tworzenie, aktualizowanie i wyświetlanie wielu wdrożeń projektu.

Kod struktury

clasp pozwala uporządkować kod w katalogach, które są zachowywane podczas przesyłania na script.google.com. Na przykład:

# On script.google.com:
├── tests/slides.gs
└── tests/sheets.gs

# Locally:
├── tests/
│   ├─ slides.gs
│   └─ sheets.gs

Wymagania

clasp jest napisany w Node.js i rozprowadzany za pomocą narzędzia npm. Przed użyciem clasp musisz mieć zainstalowaną Node.js w wersji 4.7.4 lub nowszej. Aby zainstalować Node.js, musisz mieć uprawnienia administratora.

Instalacja

Po zainstalowaniu Node.js możesz użyć tego polecenia npm, aby zainstalować clasp:

npm install @google/clasp -g

Po zainstalowaniu możesz użyć polecenia clasp z dowolnego katalogu na komputerze.

Jak korzystać z aplikacji clasp

Za pomocą narzędzia clasp możesz wykonywać różne zadania z poziomu wiersza poleceń. Ta sekcja opisuje typowe operacje, których możesz używać podczas tworzenia aplikacji za pomocą clasp.

Zaloguj się

To polecenie loguje się na konto Google i autoryzuje zarządzanie projektami Apps Script na tym koncie. Po jego uruchomieniu pojawi się prośba o zalogowanie się na konto Google, na którym są przechowywane projekty Apps Script.

clasp login

Wyloguj się

To polecenie wyloguje Cię z narzędzia wiersza poleceń. Zanim będzie można dalej korzystać z clasp, musisz się ponownie zalogować, używając clasp login, aby ponownie uwierzytelnić się w Google.

clasp logout

Tworzenie nowego projektu Apps Script

To polecenie tworzy nowy skrypt w bieżącym katalogu z opcjonalnym tytułem skryptu.

clasp create [scriptTitle]

To polecenie tworzy też 2 pliki w bieżącym katalogu:

  • Plik .clasp.json zawierający identyfikator skryptu.
  • Plik manifestu projektu appsscript.json zawierający metadane projektu.

Klonowanie istniejącego projektu

To polecenie klonuje istniejący projekt w bieżącym katalogu. Skrypt musi zostać utworzony lub udostępniony Twojemu kontu Google. Aby określić projekt skryptu do sklonowania, podaj jego identyfikator.

Aby znaleźć identyfikator skryptu projektu:

  1. Otwórz projekt Apps Script.
  2. Po lewej stronie kliknij Ustawienia projektu .

  3. W sekcji Identyfikatory skopiuj identyfikator skryptu.

     clasp clone <scriptId>

Pobieranie projektu skryptu

To polecenie pobiera projekt Apps Script z Dysku Google do systemu plików komputera.

clasp pull

Przesyłanie projektu skryptu

To polecenie przesyła wszystkie pliki projektu skryptu z komputera na Dysk Google.

clasp push

Wyświetlanie listy wersji projektu

To polecenie zawiera liczbę i opis poszczególnych wersji projektu skryptu.

clasp versions

Wdrażanie opublikowanego projektu

Projekty skryptów możesz wdrażać jako aplikacje internetowe, dodatki lub pliki wykonywalne. Wdrożenia możesz tworzyć w edytorze skryptu, w manifest projektu lub za pomocą clasp.

Aby wdrożyć projekt za pomocą clasp, najpierw utwórz niezmienną wersję projektu Apps Script. Wersja to „migawka” projektu skryptu i jest podobna do gałęzi tylko do odczytu.

clasp version [description]

To polecenie wyświetla nowo utworzony numer wersji. Za pomocą tego numeru możesz wdrażać i odwoływać instancje projektu:

clasp deploy [version] [description]
clasp undeploy <deploymentId>

To polecenie aktualizuje istniejące wdrożenie o nową wersję i opis:

clasp redeploy <deploymentId> <version> <description>

Wyświetlenie listy wdrożeń

To polecenie wyświetla identyfikatory wdrożeń, wersje i ich opisy projektu skryptu.

clasp deployments

Otwórz projekt w edytorze Apps Script

To polecenie otwiera projekt skryptu w edytorze Apps Script. Edytor jest uruchamiany jako nowa karta w domyślnej przeglądarce.

clasp open

Wspieranie projektu open source clasp

Współtwórz clasp w GitHub.