부가기능은 게시 전에 철저히 테스트하여 의도한 대로 작동하는지 확인해야 합니다. Apps Script를 사용하면 특정 Google Docs Sheets, Forms, Slides 파일에서 개발 중인 편집자 부가기능을 테스트할 수 있습니다. 이 API는 다음과 같은 용도로 사용할 수 있습니다.
- 독립형 스크립트로 작성된 부가기능이 시트, 문서, 프레젠테이션 또는 양식에 적용되었을 때 의도한 대로 작동하는지 확인합니다.
- 부가기능 설치 흐름이 특히 다양한 초기 승인 수명 주기 상태(설치됨, 사용 설정됨 또는 둘 다)에 맞게 의도한 대로 작동하는지 확인합니다.
- 특정 문서 및 그 콘텐츠에 대해 작업할 때 부가기능이 의도한 대로 작동하는지 확인합니다.
- 부가기능의 현재 버전과 이전 버전을 테스트하고 비교합니다.
테스트 배포 만들기
테스트 배포는 부가기능과 테스트 문서의 조합입니다. 스크립트 버전을 개발하여 부가기능으로 테스트하고 싶다면 다음 단계를 따르세요.
- 부가기능이 아직 없다면 스프레드시트, 문서, 프레젠테이션 또는 양식을 만들어 부가기능을 테스트합니다.
- 부가기능이 포함된 스크립트 프로젝트를 엽니다.
- 배포 > 배포 테스트를 클릭합니다.
- 유형 선택 옆에 있는 배포 유형 사용 설정 을 클릭하고 편집기 부가기능을 선택합니다.
- 새 테스트 만들기 또는 테스트 추가를 클릭합니다.
- 코드 버전을 선택하거나 최신 코드를 선택합니다.
- 구성 섹션에서 테스트의 초기 승인 상태를 선택합니다.
- 문서 테스트에서 선택된 문서 없음을 클릭합니다. 부가기능을 테스트하는 데 사용할 Sheets, Docs, Slides, Forms 파일을 선택하고 Insert를 클릭합니다.
- 테스트 저장을 클릭합니다.
저장된 모든 테스트 배포가 테스트 배포 대화상자에 표시됩니다. 이렇게 하면 나중에 동일한 테스트 배포를 다시 방문할 수 있습니다.
테스트 배포 실행
테스트 배포가 하나 이상 저장된 경우 다음 단계에 따라 테스트 배포 중 하나를 실행할 수 있습니다.
- 부가기능이 포함된 스크립트 프로젝트를 엽니다.
- 배포 > 배포 테스트를 클릭합니다.
- 저장된 테스트에서 실행하려는 저장된 테스트 배포 옆에 있는 라디오 버튼을 선택하고 실행을 클릭합니다.
테스트 문서가 새 탭에서 열립니다. 부가기능이 테스트 배포에 지정된 승인 상태입니다. 메뉴 및 UI 요소와 상호작용하여 부가기능이 의도대로 작동하는지 확인할 수 있습니다.
테스트 세부정보
다음과 같은 방법으로 편집기 부가기능을 테스트할 때 유의해야 할 사항이 몇 가지 있습니다.
- 테스트 시 설치 가능한 트리거는 지원되지 않습니다. 설치 가능한 트리거에 의존하는 기능은 테스트할 수 없습니다.
- 최신 코드로 테스트하도록 설정된 테스트 배포를 실행하는 동안 테스트 문서를 새로고침하여 부가기능 스크립트에 저장된 변경사항을 볼 수 있습니다.
- 테스트 문서에는 원본 테스트 문서의 편집자와 공유할 수 있는 URL이 있습니다. 이렇게 하면 테스트와 개발 중에 다른 사용자와 더 쉽게 공동작업할 수 있습니다.
- 부가기능에서 속성 서비스를 사용하는 경우 속성이 유지되고 다음에 테스트 배포가 실행될 때 사용할 수 있습니다.
- 또한 부가기능과 테스트 문서의 동일한 조합을 사용하는 모든 테스트 배포는 동일한 속성 정보에 액세스할 수 있습니다. 예를 들어 두 개의 테스트 배포를 만드는 경우 첫 번째 배포를 실행하는 동안 저장된 속성은 두 번째 배포를 실행하는 동안 사용 가능하며 그 반대의 경우도 마찬가지입니다. 단, 해당 배포에서 동일한 스크립트와 테스트 문서를 사용하는 경우에만 가능합니다.
- 테스트 배포를 실행하는 경우 이전에 스크립트를 실행하지 않은 경우 승인을 요청하는 메시지가 표시될 수 있습니다. 테스트 중에 스크립트를 승인하면 테스트 외부에서도 스크립트가 승인됩니다.