Używanie interfejsu wiersza poleceń z zapięciem

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:

  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 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.