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