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.

Dodatek do Google Workspace

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

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 artykułem Przetestuj wdrożenie aplikacji internetowej.

Aplikacja Google Chat

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.

Plik wykonywalny interfejsu API

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óż.