Do tworzenia projektów Apps Script i zarządzania nimi za pomocą terminala
Apps Script, możesz użyć narzędzia open source o nazwie clasp
.
Ćwiczenie z programowania dotyczące clasp
zawiera omówienie wszystkich
clasp
funkcje.
Funkcje
Programuj lokalnie
clasp
umożliwia tworzenie projektów Apps Script lokalnie. Dostępne opcje
Napisać kod na własnym komputerze i przesłać go do Apps Script
gotowe. Możesz też pobrać istniejące projekty Apps Script, aby edytować je offline. Kod jest lokalny, więc możesz użyć swojego
narzędzi dla programistów, takich jak git
do tworzenia Apps Script.
w projektach AI.
Zarządzanie wersjami wdrożeń
Tworzenie, aktualizowanie i wyświetlanie wielu jednostek wdrożenia projektu.
Kod domu
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 zapisywany w Node.js i rozpowszechniany przez
narzędzie 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 instalacji możesz użyć polecenia clasp
z dowolnego katalogu
Twój komputer.
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ą pakietu clasp
.
Zaloguj się
To polecenie pozwala zalogować się na konto Google i autoryzować zarządzanie tymi kontami Projekty Apps Script. 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 powoduje wylogowanie z narzędzia wiersza poleceń. Musisz ponownie zalogować się, używając
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 nowy skrypt w bieżącym katalogu 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 musi zostać utworzona lub udostępniona Twojemu kontu Google. Ty określasz skrypt projektu do sklonowania, 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 na w systemie plików komputera.
clasp pull
Przesyłanie projektu skryptu
To polecenie przesyła wszystkie pliki projektu skryptu z Twojego komputera do Dysk Google.
clasp push
Wyświetlenie listy wersji projektu
To polecenie zawiera liczbę i opis poszczególnych tagów projektu skryptu wersji.
clasp versions
Wdrażanie opublikowanego projektu
Projekty skryptów możesz wdrażać jako aplikacje internetowe, dodatki lub pliki wykonywalne. Dostępne opcje
utwórz wdrożenia w edytorze skryptów,
w projekcie manifest lub przy użyciu clasp
.
Aby wdrożyć projekt za pomocą clasp
, najpierw utwórz niezmienną wersję projektu Apps Script. Wersja jest „zrzutem” projektu skryptu i jest podobny do
wersji rozgałęzionej tylko do odczytu.
clasp version [description]
To polecenie wyświetla numer nowo utworzonej wersji. Użycie tego numeru może 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żenia, wersje i ich identyfikatory wdrożenia projektu skryptu tekstów reklamy.
clasp deployments
Otwieranie projektu w edytorze Apps Script
To polecenie otwiera projekt skryptu w edytorze Apps Script. Redaktorem jest uruchomiono jako nową kartę w domyślnej przeglądarce internetowej.
clasp open
Wspieraj projekt open source clasp
Przekaż darowiznę na clasp
w GitHub.