Używanie interfejsu wiersza poleceń z zapięciem

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

W claspcodelabie znajdziesz omówienie wszystkichclasp funkcji.

Funkcje

Opracowywanie lokalne

clasp umożliwia tworzenie projektów Apps Script lokalnie. Możesz pisać kod na własnym komputerze i przesył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ć ulubionych narzędzi programistycznych, takich jak git.

Zarządzanie wersjami wdrożenia

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

Kod struktury

clasp umożliwia porządkowanie kodu w katalogach, które są zachowywane po przesłaniu go na stronę script.google.com. 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 dystrybuowany za pomocą narzędzia npm. Zanim zaczniesz korzystać z clasp, musisz mieć zainstalowaną wersję Node.js 4.7.4 lub nowszą. Instalacja Node.js wymaga uprawnień administracyjnych.

Instalacja

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

npm install @google/clasp -g

Po instalacji możesz używać 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ń. W tej sekcji opisujemy typowe operacje, których możesz używać podczas tworzenia aplikacji z clasp.

Zaloguj się

To polecenie loguje Cię i autoryzuje zarządzanie projektami Apps Script na Twoim koncie Google. Po 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 powoduje wylogowanie z narzędzia wiersza poleceń. Aby ponownie uwierzytelnić się w Google, musisz zalogować się ponownie za pomocą clasp login, zanim zaczniesz dalej korzystać z clasp.

clasp logout

Tworzenie nowego projektu Apps Script

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

clasp create [scriptTitle]

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

  • Plik .clasp.json zawierający identyfikator skryptu.
  • appsscript.json plik manifestu projektu 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 na Twoim koncie Google. Projekt skryptu do sklonowania określa się, podając jego identyfikator.

Aby znaleźć identyfikator skryptu projektu, wykonaj te czynności:

  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 skryptów, w manifeście 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, która jest podobna do rozgałęzionej wersji tylko do odczytu.

clasp version [description]

To polecenie wyświetla numer nowo utworzonej wersji. Za pomocą tego numeru możesz wdrażać i wycofywać 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 opisy projektu skryptu.

clasp deployments

Otwieranie projektu 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

Współtworzenie projektu open source clasp

Współtwórz clasp na GitHub.