Programowanie lokalne

Wszystkie zadania związane z łącznikami możesz wykonywać w środowisku online Apps Script, ale niektóre z nich mogą z czasem stać się powtarzalne i podatne na błędy.

dscc-gen to narzędzie oparte na określonych założeniach, które ma na celu rozwiązanie tych powtarzalnych zadań, aby można było skupić się na rozwiązywaniu problemów biznesowych, a nie błędów, których można uniknąć dzięki automatyzacji.

Wymagania

npm w wersji 5.2.0 lub nowszej
Podstawowa znajomość wiersza poleceń.

Jak korzystać z aplikacji `dscc-gen`

dscc-gen może tworzyć nowe projekty łączników społecznościowych lub być używany z istniejącymi.

Istniejące oprogramowanie sprzęgające

dscc-gen można też używać w przypadku istniejących projektów. Najpierw skopiuj scriptId, a następnie uruchom to polecenie (zastępując YOUR_SCRIPT_ID swoim scriptId):

npx @google/dscc-gen connector --script_id YOUR_SCRIPT_ID

Pojawi się prośba o podanie kilku szczegółów dotyczących łącznika. Jeśli nie masz jeszcze wdrożenia o nazwie „Production”, zostanie ono utworzone. Żaden z Twoich dotychczasowych kodów nie zostanie zmodyfikowany, ale uzyskasz dostęp do wszystkich funkcji dscc-gen.

Nowe oprogramowanie sprzęgające

Aby utworzyć nowe złącze społeczności z dscc-gen, uruchom to polecenie:

npx @google/dscc-gen connector

Pojawi się prośba o podanie kilku szczegółów nowego łącznika. Nowi użytkownicy będą proszeni o uwierzytelnienieclasp. clasp to narzędzie do tworzenia i modyfikowania projektów Apps Script z poziomu wiersza poleceń.

Po wykonaniu instrukcji dscc-gen utworzy nowy projekt Apps Script i wypisze wszystkie swoje możliwości.

Co `dscc-gen` może zrobić?

Polecenie	Opis
`npm run open`	Otwórz projekt w Apps Script.
`npm run push`	Przekaż lokalne zmiany do Apps Script.
`npm run watch`	obserwować zmiany lokalne i przesyłać je do Apps Script;
`npm run prettier`	Sformatuj kod zgodnie ze standardami społeczności.
`npm run try_latest`	Otwórz wdrożenie z najnowszym kodem w Studiu danych.
`npm run try_production`	Otwórz wdrożenie produkcyjne w Studiu danych.
`npm run update_production`	Zaktualizuj wdrożenie produkcyjne, aby używać najnowszego kodu.

Jak z niej korzystać?

Częste korzystanie z usługi dscc-gen wygląda mniej więcej tak:

Określ funkcję, którą chcesz dodać do łącznika.
Uruchom npm run watch, aby lokalne zmiany zostały przesłane do Apps Script.
Wprowadź zmiany w kodzie za pomocą ulubionego JavaScript JavaScriptu.
Uruchom npm run tryLatest i sprawdź, czy nowa funkcja działa zgodnie z oczekiwaniami.
Uruchom polecenie npm run updateProduction, aby zaktualizować wdrożenie produkcyjne i dodać do niego nową funkcję.
Uruchom npm run tryProduction i upewnij się, że nowa funkcja działa.

Pobieranie identyfikatora skryptu

Aby uzyskać scriptId, otwórz istniejący projekt, a następnie skopiuj część adresu URL znajdującą się po /d/ i przed /edit. Na przykład ten adres URL:

Pierwotny adres URL:https://script.google.com/a/google.com/d/example-script-id/edit
Identyfikator skryptu: example-script-id