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