Aby tworzyć projekty Apps Script i nimi zarządzać za pomocą terminala (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
Programuj lokalnie
clasp
umożliwia tworzenie projektów Apps Script lokalnie. Możesz
napisać kod na własnym komputerze, a potem przesłać go do Apps Script. Możesz też pobrać istniejące projekty Apps Script, aby edytować je w trybie 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ądzaj wersjami wdrożenia
Twórz, aktualizuj i wyświetlaj wiele wdrożeń projektu.
Kod domu
clasp
umożliwia porządkowanie kodu w katalogi, które są zachowywane po przesłaniu go do 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 rozpowszechniany za pomocą narzędzia npm
. Aby móc używać clasp
, musisz mieć zainstalowany Node.js w wersji 4.7.4 lub nowszej.
Aby zainstalować Node.js, musisz mieć uprawnienia administratora.
Instalacja
Po zainstalowaniu Node.js możesz zainstalować clasp
przy użyciu tego polecenia npm
:
npm install @google/clasp -g
Po instalacji możesz użyć polecenia clasp
z dowolnego katalogu na komputerze.
Jak korzystać z aplikacji clasp
clasp
umożliwia wykonywanie różnych zadań z poziomu wiersza poleceń. W tej sekcji opisujemy typowe operacje, których możesz używać podczas programowania za pomocą clasp
.
Zaloguj się
To polecenie służy do logowania się i autoryzacji zarządzania projektami Apps Script na Twoim koncie Google. Po uruchomieniu wyświetli się prośba o zalogowanie się na konto Google, na którym są przechowywane Twoje projekty Apps Script.
clasp login
Wyloguj się
To polecenie powoduje wylogowanie z narzędzia wiersza poleceń. Musisz ponownie zalogować się przy użyciu clasp login
, aby ponownie uwierzytelnić się w Google przed dalszym używaniem usługi clasp
.
clasp logout
Tworzenie nowego projektu Apps Script
To polecenie tworzy w bieżącym katalogu nowy skrypt z opcjonalnym tytułem skryptu.
clasp create [scriptTitle]
To polecenie powoduje też utworzenie 2 plików w bieżącym katalogu:
- Plik
.clasp.json
z identyfikatorem skryptu. - Plik manifestu projektu
appsscript.json
zawierający metadane projektu.
Klonowanie istniejącego projektu
To polecenie sklonuje istniejący projekt w bieżącym katalogu. Skrypt należy utworzyć lub udostępnić Twojemu kontu Google. Projekt skryptu do sklonowania określasz, podając jego identyfikator skryptu.
Aby znaleźć identyfikator skryptu projektu, wykonaj te czynności:
- Otwórz projekt Apps Script.
- Po lewej stronie kliknij Ustawienia projektu .
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 Twojego komputera na Dysk Google.
clasp push
Wyświetlenie 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 skryptów, w manifest projektu lub za pomocą clasp
.
Aby wdrożyć projekt za pomocą narzędzia clasp
, najpierw utwórz stałą wersję projektu Apps Script. Wersja to „zrzut” projektu skryptu i jest podobna do wersji rozgałęzionej tylko do odczytu.
clasp version [description]
To polecenie wyświetla numer nowo utworzonej wersji. Na podstawie tej liczby możesz wdrażać i wycofywać instancje swojego 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 zawiera listę identyfikatorów wdrożeń, wersji i opisów wdrożeń projektu skryptu.
clasp deployments
Otwieranie projektu 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
Wspieraj projekt open source clasp
Przekaż darowiznę na clasp
w GitHub.