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ć ich używać, gdy jesteś 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ądzaj wersjami wdrożenia

Tworzenie, aktualizowanie i wyświetlanie wielu jednostek wdrożenia projektu.

Kod domu

clasp umożliwia porządkowanie kodu w katalogi, które są zachowywane podczas przesyłania 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 zapisywany w Node.js i rozpowszechniany przez narzędzie npm. Przed rozpoczęciem korzystania z usługi clasp musisz mieć Zainstalowano 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 zainstaluj 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

clasp umożliwia wykonywanie różnych zadań z poziomu wiersza poleceń. Ten opisuje typowe operacje, których możesz używać podczas programowania z użyciem clasp.

Zaloguj się

To polecenie pozwala zalogować się na konto Google i autoryzować zarządzanie tymi kontami Projekty Apps Script. Po uruchomieniu wyświetli 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 w bieżącym katalogu nowy skrypt z opcjonalnym parametrem tytułu 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 stałą wersję Google Apps Projekt skryptu. 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.