Tworzenie wdrożeń i zarządzanie nimi

Wdrożeniem projektu Apps Script jest wersja skryptu udostępniona do użycia jako aplikacja internetowa, dodatek lub plik wykonywalny interfejsu API. Dzięki tworzeniu i zarządzaniu wdrożeniami możesz iterować kod, śledzić zmiany i kontrolować dokładną wersję kodu, do której mają dostęp użytkownicy.

Istnieją 2 typy wdrożeń:

  • Główne wdrożenia, które są zawsze synchronizowane z bieżącym kodem projektu.
  • Wersje wdrożeń, które są powiązane z konkretną wersją projektu.

Wdrożenia z nagłówka

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

Rozmieszczenie główne jest zawsze zsynchronizowane z najnowszym zapisanym kodem. Jeśli na przykład utworzysz wdrożenie z wersjami, a następnie zmodyfikujesz kod, wdrożeniami z nagłówkiem zostaną uwzględnione te zmiany, a wdrożeniami z wersjami – nie.

Do testowania kodu używaj wdrożeń głowy. Nie używaj wdrożeń głowic do użytku publicznego.

Wdrożenia z obsługą wersji

Wdrożenie z wersjami udostępnia konkretną wersję kodu projektu. Dzięki temu użytkownicy będą mogli nadal korzystać z działającej wersji, podczas gdy Ty będziesz wprowadzać zmiany i ulepszać kod.

Gdy aplikacja jest publikowana publicznie, zawsze stosuj wersjonowane wdrożenie. Możesz mieć jednocześnie wiele aktywnych wdrożeń wersji.

Ważne: własności wdrożeń z wersjami nie można przenieść. Jeśli przekażesz komuś własność projektu skryptu, właściciel dotychczasowych wdrożonych wersji w ramach projektu nie ulegnie zmianie. Jeśli administrator usunie konto właściciela wdrożenia, mogą wystąpić błędy skryptu w przypadku jego wdrożeń.

Tworzenie wdrożenia z wersją

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

Aby utworzyć wdrożenie z wersjami:

  1. Otwórz projekt Apps Script.
  2. W prawym górnym rogu kliknij Wdróż > Nowe wdrożenie.
  3. Obok opcji Wybierz typ kliknij Włącz typy wdrożeń.
  4. Wybierz typ wdrożenia, które chcesz wdrożyć. W przypadku dodatków do Google Workspace, dodatków do edytora i aplikacji Google Chat wybierz Dodatek.

  5. Wpisz informacje o wdrożeniu i kliknij Wdróż.

Wyświetlanie wdrożonych wersji

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 artykułem Wyświetlanie wcześniejszej wersji.

Edytowanie wdrożenia z wersjami

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 aktywne wdrożenie, które chcesz zmienić, i kliknij Edytuj .

  4. Wprowadź zmiany i kliknij Wdróż.

    Jeśli chcesz edytować zarchiwizowane wdrożenie, musisz je ponownie wdrożyć, a potem wykonać opisane powyżej czynności.

    Jeśli chcesz wdrożyć zmianę w kodzie projektu, utwórz nową wersję i edytuj wdrożenie, aby jej użyć. Nowa wersja jest automatycznie używana przez wszystkich użytkowników, którzy korzystają z tej implementacji.

Znajdowanie identyfikatora wdrożenia

Każde wdrożenie ma powiązany identyfikator ciągu znaków, który jest tworzony automatycznie. Aby go znaleźć:

  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żeń pojawiają się tylko w przypadku aktywnych wdrożeń.

Testowanie wdrożenia

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

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

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

Aby przetestować wdrożenie aplikacji internetowej, zapoznaj się z artykułem Przetestuj wdrożenie aplikacji internetowej.

Aby przetestować wdrożenie aplikacji czatu, musisz najpierw utworzyć skonfigurowane wdrożenie skryptu, aby uzyskać dostęp do jego identyfikatora wdrożenia.

Po uzyskaniu identyfikatora wdrożenia określ go w konfiguracji interfejsu Chat API i wykonaj czynności, aby przetestować funkcje interaktywne.

Aby przetestować wdrożoną wersję wykonalną interfejsu API, musisz najpierw utworzyć wdrożoną wersję. Po utworzeniu wdrożenia wykonaj te czynności:

  1. W prawym górnym rogu projektu Apps Script kliknij Wdróż > Testuj wdrożeniami.
  2. Obok pozycji „Wybierz typ” kliknij Włącz typy wdrożenia  > Wykonalny interfejs API.
  3. Skopiuj adres URL i użyj go do przetestowania wdrożenia pliku wykonywalnego interfejsu API.

Archiwizowanie wdrożenia z wersjami

Wdrożeń z wersjami nie można usuwać. Zamiast tego możesz je zarchiwizować.

Aby zarchiwizować wdrożenie z wersjami:

  1. Otwórz projekt Apps Script.
  2. Kliknij Wdróż > Zarządzaj wdrożeniami.
  3. Wybierz wdrożenie, które chcesz zarchiwizować, i kliknij Archiwizuj wdrożenie .

Wdrażanie zarchiwizowanego wdrożenia

  1. Otwórz projekt Apps Script.
  2. W prawym górnym rogu kliknij Wdróż > Zarządzaj wdrożeniami.
  3. Po lewej stronie w sekcji Zarchiwizowane wybierz wdrożenie, które chcesz ponownie wdrożyć, i kliknij Edytuj  > Wdróż.