Programowanie lokalne

Wszystkie zadania związane z oprogramowaniem sprzęgającym można wykonywać w środowisku online Apps Script, jednak niektóre z nich mogą się z czasem powtarzać i być podatne na błędy.

dscc-gen to sprawdzone narzędzie do rozwiązywania tych powtarzających się zadań. Dzięki temu możesz skupić się na rozwiązywaniu problemów biznesowych, a nie na błędach, których można uniknąć dzięki automatyzacji.

Wymagania

Jak korzystać z aplikacji dscc-gen

dscc-gen może tworzyć nowe projekty oprogramowania sprzęgającego społeczności lub używać ich w dotychczasowych.

Istniejące oprogramowanie sprzęgające

dscc-gen można też używać w istniejących projektach. Najpierw skopiuj scriptId, a potem uruchom to polecenie (zastępując YOUR_SCRIPT_ID wartością scriptId):

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

Pojawi się prośba o podanie kilku szczegółów dotyczących oprogramowania sprzęgającego. Jeśli nie masz jeszcze wdrożenia o nazwie „Produkcja”, zostanie ono dla Ciebie utworzone. Dotychczasowy kod nie zostanie zmodyfikowany, ale będziesz mieć dostęp do wszystkich funkcji dscc-gen.

Nowe oprogramowanie sprzęgające

Aby utworzyć nowy łącznik społecznościowy z dscc-gen, uruchom to polecenie:

npx @google/dscc-gen connector

Pojawi się prośba o podanie kilku informacji o nowym oprogramowaniu sprzęgającym. Nowi użytkownicy będą proszeni o uwierzytelnienie clasp. 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 wyświetli wszystko, co potrafi.

Co dscc-gen może zrobić?

Polecenie Opis
npm run open Otwórz projekt w Apps Script.
npm run push Przekaż zmiany lokalne do Apps Script.
npm run watch Poszukaj lokalnych zmian i przekaż 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 Looker Studio.
npm run try_production Otwórz wdrożenie produkcyjne w Looker Studio.
npm run update_production Zaktualizuj wdrożenie produkcyjne, aby używać najnowszego kodu.

Jak należy go używać?

Użycie usługi dscc-gen często wygląda mniej więcej tak:

  1. Znajdź funkcję, którą chcesz dodać do oprogramowania sprzęgającego.
  2. Uruchomienie polecenia npm run watch, aby lokalne zmiany zostały przekazane do Apps Script.
  3. Wprowadź zmiany w kodzie za pomocą ulubionego JavaScript JavaScript.
  4. Uruchom npm run tryLatest i sprawdź, czy nowa funkcja działa zgodnie z oczekiwaniami.
  5. Uruchom npm run updateProduction, aby zaktualizować wdrożenie produkcyjne i udostępnić nową funkcję.
  6. Uruchom npm run tryProduction i dokładnie sprawdź, czy nowa funkcja działa.

Uzyskaj identyfikator skryptu

Aby uzyskać scriptId, otwórz istniejący projekt, a następnie skopiuj sekcję adresu URL za /d/, a przed /edit. Na przykład: ten adres URL:

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