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.

claspCodelab zawiera omówienie wszystkich funkcji clasp.

Funkcje

Tworzenie lokalnie

clasp umożliwia lokalne tworzenie projektów Apps Script. 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 korzystać z ulubionych narzędzi programistycznych, takich jak git.

Zarządzanie wersjami wdrożeń

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

Kod struktury

clasp umożliwia porządkowanie kodu w katalogach, które są zachowywane podczas przesyłania na stronę 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ą wersję Node.js w wersji 4.7.4 lub nowszej. Instalowanie Node.js wymaga uprawnień 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 wyświetla numer i opis każdej 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 pliku manifestu 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 odwieszać 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 zostanie uruchomiony jako nowa karta w domyślnej przeglądarce.

clasp open

Wspieranie projektu open source clasp

Wspieraj projekt clasp na GitHub.