Ta strona została przetłumaczona przez Cloud Translation API.

Używanie interfejsu wiersza poleceń z zapięciem

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.

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.