Tworzenie wdrożeń i zarządzanie nimi

Wdrożenie projektu Google Apps Script to wersja skryptu, która jest dostępna do użycia jako aplikacja internetowa, dodatek do Google Workspace lub plik wykonywalny interfejsu API. Tworząc wdrożenia i zarządzając nimi, możesz iteracyjnie rozwijać kod, śledzić zmiany i kontrolować wersję kodu, do której mają dostęp użytkownicy.

Istnieją 2 rodzaje wdrożeń:

  • Wdrożenia główne, które zawsze synchronizują się z kodem bieżącego projektu.
  • Wdrożenia z określoną wersją, które są połączone z konkretną wersją projektu.

Wdrożenia z nagłówka

Wdrożenie z nagłówka to kod bieżącego projektu. Gdy utworzysz projekt Apps Script, system automatycznie utworzy dla niego wdrożenie główne.

Wdrożenie główne zawsze synchronizuje się z ostatnio zapisanym kodem. Jeśli na przykład utworzysz wdrożenie z wersją, a potem zmodyfikujesz kod, zmiany te zostaną odzwierciedlone we wdrożeniu głównym, a wdrożenie z wersją pozostanie bez zmian.

Używaj wdrożeń head do testowania kodu. Nie używaj wdrożeń na głowę do użytku publicznego.

Każdy projekt Apps Script ma tylko 1 wdrożenie wersji głównej. Aby użyć wdrożenia w wersji głównej, musisz mieć co najmniej uprawnienia do odczytu projektu skryptu.

Wdrożenia z obsługą wersji

Wdrożenie z określoną wersją udostępnia konkretną wersję kodu projektu. Dzięki temu użytkownicy mogą nadal korzystać z działającej wersji, podczas gdy Ty wprowadzasz zmiany i ulepszenia w kodzie.

Gdy publikujesz aplikację do użytku publicznego, zawsze używaj wdrożenia z wersją. Możesz mieć jednocześnie kilka aktywnych wdrożeń z wersjami.

Ważne: nie można przenieść własności wdrożeń z wersjami. Jeśli przekażesz własność projektu skryptu, właściciel istniejących wdrożeń z wersjami nie ulegnie zmianie. Jeśli administrator usunie konto właściciela wdrożenia, wdrożenia mogą generować błędy skryptu.

Tworzenie wdrożenia z określoną wersją

Aby wdrożyć wersję dodatku, dodatku do edytora, aplikacji do obsługi czatu lub pliku wykonywalnego interfejsu API, musisz najpierw przełączyć powiązanie projektu Apps Script z domyślnego projektu Google Cloud na standardowy projekt.

Aby utworzyć wdrożenie z określoną wersją:

  1. Otwórz projekt Apps Script. <<../_common/snippets/create-new-deployment.md>>

Każde nowe wdrożenie można udostępnić jako bibliotekę. Jeśli udostępnisz skrypt jako bibliotekę, opis wdrożenia będzie widoczny dla użytkowników biblioteki.

Wyświetlanie wdrożeń z wersjami

Aby wyświetlić wdrożenia projektu Apps Script, u góry kliknij Wdróż > Zarządzaj wdrożeniami.

Aby wyświetlić kod konkretnej wersji, zapoznaj się z sekcją Wyświetlanie poprzedniej wersji.

Edytowanie wdrożenia z wersją

Możesz edytować wdrożenie z wersją, aby zmienić jego opis lub wersję. Aby edytować wdrożenie:

  1. Otwórz projekt Apps Script.
  2. Kliknij Wdróż > Zarządzaj wdrożeniami.
  3. Wybierz aktywną wdrożenie i kliknij Edytuj.
  4. Wprowadź zmiany i kliknij Wdróż.

Aby edytować zarchiwizowane wdrożenie, wdróż je ponownie, a następnie wykonaj opisane powyżej czynności.

Aby wdrożyć zmianę w kodzie projektu, utwórz nową wersję i zmodyfikuj wdrożenie, aby z niej korzystało. Wdrożenie automatycznie używa nowej wersji w przypadku wszystkich użytkowników.

Znajdowanie identyfikatora wdrożenia

Każde wdrożenie ma powiązany identyfikator w postaci ciągu znaków. Aby znaleźć ten identyfikator:

  1. Otwórz projekt Apps Script.
  2. W prawym górnym rogu kliknij Wdróż > Zarządzaj wdrożeniami.
  3. Wybierz aktywne wdrożenie, aby znaleźć jego identyfikator.

Identyfikatory wdrożenia pojawiają się tylko w przypadku aktywnych wdrożeń.

Testowanie wdrożenia

Sposób testowania wdrożenia zależy od typu tworzonej aplikacji.

Dodatek do Google Workspace

Aby przetestować wdrożenie dodatku, zapoznaj się z artykułem Testowanie dodatków.

Dodatek do edytora

Aby przetestować wdrożenie dodatku do edytora, zapoznaj się z artykułem Testowanie dodatku do edytora.

Aplikacja internetowa

Aby przetestować wdrożenie aplikacji internetowej, zapoznaj się z tym artykułem: Testowanie wdrożenia aplikacji internetowej

Komunikator Google Chat

Aby przetestować wdrożenie aplikacji do obsługi czatu, utwórz wdrożenie skryptu z obsługą wersji, aby uzyskać dostęp do jego identyfikatora wdrożenia.

Gdy uzyskasz identyfikator wdrożenia, podaj go w konfiguracji interfejsu Chat API i wykonaj czynności opisane w artykule testowanie funkcji interaktywnych.

Plik wykonywalny interfejsu API

Aby przetestować wdrożenie pliku wykonywalnego interfejsu API, utwórz wdrożenie z określoną wersją. Po utworzeniu wdrożenia wykonaj te czynności:

  1. W prawym górnym rogu projektu Apps Script kliknij Wdróż > Testowe wdrożenia.
  2. Obok opcji „Wybierz typ” kliknij Włącz typy wdrożenia > Plik wykonywalny interfejsu API.
  3. Skopiuj i użyj adresu URL, aby przetestować wdrożenie pliku wykonywalnego interfejsu API.

Archiwizowanie wdrożenia z wersjami

Nie możesz usuwać wdrożeń z wersjami. Możesz je zarchiwizować.

Aby zarchiwizować wdrożenie wersji:

  1. Otwórz projekt Apps Script.
  2. Kliknij Wdróż > Zarządzaj wdrożeniami.
  3. Wybierz wdrożenie i kliknij Zarchiwizuj wdrożenie .

Ponowne wdrażanie zarchiwizowanego wdrożenia

  1. Otwórz projekt Apps Script.
  2. W prawym górnym rogu kliknij Wdróż > Zarządzaj wdrożeniami.
  3. W sekcji Zarchiwizowano wybierz wdrożenie i kliknij Edytuj > Wdróż.