Apps Script 편집기가 아닌 터미널에서 Apps Script 프로젝트를 개발하고 관리하려면 clasp
이라는 오픈소스 도구를 사용하면 됩니다.
clasp
Codelab에서는 모든 clasp
기능을 간략하게 설명합니다.
기능
로컬에서 개발
clasp
을(를) 사용하면 Apps Script 프로젝트를 로컬에서 개발할 수 있습니다. 내 컴퓨터에서 코드를 작성한 후 완료되면 Apps Script에 업로드할 수 있습니다. 기존 Apps Script 프로젝트를 다운로드하여 오프라인에서 수정할 수도 있습니다. 코드가 로컬이므로 Apps Script 프로젝트를 빌드할 때 git
와 같이 원하는 개발 도구를 사용할 수 있습니다.
배포 버전 관리
프로젝트의 여러 배포를 만들고 업데이트하고 확인합니다.
코드 구조화
clasp
를 사용하면 코드를 디렉터리로 구성할 수 있으며 이 디렉터리는 스크립트.google.com에 코드를 업로드할 때 보존됩니다. 예:
# On script.google.com: ├── tests/slides.gs └── tests/sheets.gs # Locally: ├── tests/ │ ├─ slides.gs │ └─ sheets.gs
요구사항
clasp
는 Node.js로 작성되며 npm
도구를 통해 배포됩니다. clasp
를 사용하기 전에 Node.js 버전 4.7.4 이상이 설치되어 있어야 합니다.
Node.js를 설치하려면 관리자 권한이 필요합니다.
설치
Node.js를 설치한 후 다음 npm
명령어를 사용하여 clasp
를 설치할 수 있습니다.
npm install @google/clasp -g
설치 후 컴퓨터의 모든 디렉터리에서 clasp
명령어를 사용할 수 있습니다.
clasp
사용
clasp
를 사용하면 명령줄에서 다양한 작업을 처리할 수 있습니다. 이 섹션에서는 clasp
를 사용하여 개발할 때 사용할 수 있는 일반적인 작업을 설명합니다.
로그인
이 명령어는 로그인하고 Google 계정의 Apps Script 프로젝트 관리를 승인합니다. 실행이 완료되면 Apps Script 프로젝트가 저장된 Google 계정으로 로그인하라는 메시지가 표시됩니다.
clasp login
로그아웃
이 명령어는 명령줄 도구에서 로그아웃됩니다. clasp
를 계속 사용하려면 먼저 clasp login
를 사용하여 다시 로그인하여 Google에 다시 인증해야 합니다.
clasp logout
새 Apps Script 프로젝트 만들기
이 명령어는 현재 디렉터리에 선택적 스크립트 제목을 사용하여 새 스크립트를 만듭니다.
clasp create [scriptTitle]
이 명령어는 또한 현재 디렉터리에 두 개의 파일을 만듭니다.
- 스크립트 ID를 저장하는
.clasp.json
파일 - 프로젝트 메타데이터가 포함된
appsscript.json
프로젝트 매니페스트 파일
기존 프로젝트 클론
이 명령어는 현재 디렉터리의 기존 프로젝트를 클론합니다. 스크립트를 만들거나 Google 계정과 공유해야 합니다. 스크립트 ID를 제공하여 클론할 스크립트 프로젝트를 지정합니다.
프로젝트의 스크립트 ID를 찾으려면 다음 단계를 따르세요.
- Apps Script 프로젝트를 엽니다.
- 왼쪽에서 프로젝트 설정 을 클릭합니다.
ID 아래에서 스크립트 ID를 복사합니다.
clasp clone <scriptId>
스크립트 프로젝트 다운로드
이 명령어는 Apps Script 프로젝트를 Google Drive에서 컴퓨터의 파일 시스템으로 다운로드합니다.
clasp pull
스크립트 프로젝트 업로드
이 명령어는 컴퓨터에서 Google Drive로 스크립트 프로젝트의 모든 파일을 업로드합니다.
clasp push
프로젝트 버전 나열
이 명령어는 각 스크립트 프로젝트 버전의 번호와 설명을 나열합니다.
clasp versions
게시된 프로젝트 배포
스크립트 프로젝트를 웹 앱, 부가기능 또는 실행 파일로 배포할 수 있습니다. 스크립트 편집기, 프로젝트 매니페스트에서 또는 clasp
를 사용하여 배포를 만들 수 있습니다.
clasp
를 사용하여 프로젝트를 배포하려면 먼저 변경할 수 없는 버전의 Apps Script 프로젝트를 만듭니다. 버전은 스크립트 프로젝트의 '스냅샷'이며 읽기 전용 분기 출시와 유사합니다.
clasp version [description]
이 명령어는 새로 생성된 버전 번호를 표시합니다. 이 번호를 사용하면 프로젝트 인스턴스를 배포 및 배포 취소할 수 있습니다.
clasp deploy [version] [description]
clasp undeploy <deploymentId>
이 명령어는 새 버전과 설명으로 기존 배포를 업데이트합니다.
clasp redeploy <deploymentId> <version> <description>
배포 나열
이 명령어는 스크립트 프로젝트의 배포 ID, 버전, 설명을 나열합니다.
clasp deployments
Apps Script 편집기에서 프로젝트를 엽니다.
이 명령어는 Apps Script 편집기에서 스크립트 프로젝트를 엽니다. 편집기는 기본 웹브라우저에서 새 탭으로 실행됩니다.
clasp open
clasp
오픈소스 프로젝트에 참여
GitHub에서 clasp
에 참여하세요.