clasp로 명령줄 인터페이스 사용

터미널이 아닌 터미널에서 Apps Script 프로젝트를 개발하고 관리하려면 Apps Script 편집기에서 clasp라는 오픈소스 도구를 사용할 수 있습니다.

clasp Codelab에서는 기능 clasp개.

기능

로컬에서 개발

clasp를 사용하면 Apps Script 프로젝트를 로컬에서 개발할 수 있습니다. 다음과 같은 작업을 할 수 있습니다. 자신의 컴퓨터에 코드를 작성하고 완료되었습니다. 기존 Apps Script 프로젝트를 다운로드하여 오프라인일 때도 이용할 수 있습니다. 코드는 로컬이므로 Apps Script를 빌드할 때 git와 같은 개발 도구를 사용할 수 있습니다. 살펴보겠습니다

배포 버전 관리

여러 개를 만들고, 업데이트하고, 확인합니다. 배포일 수 있습니다.

집 코드

clasp를 사용하면 코드를 디렉터리로 정리할 수 있으며 이 디렉터리는 스크립트를 작성해 보세요. 예를 들면 다음과 같습니다.

# 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 프로젝트. 실행이 완료되면 로그인하라는 메시지가 표시됩니다. 계정에 로그인해야 합니다.

clasp login

로그아웃

이 명령어는 명령줄 도구에서 로그아웃합니다. 다음을 사용하여 다시 로그인해야 합니다. clasp을(를) 계속 사용하기 전에 clasp login하여 Google로 다시 인증합니다.

clasp logout

새 Apps Script 프로젝트 만들기

이 명령어는 현재 디렉터리에 선택적 스크립트 제목

clasp create [scriptTitle]

또한 이 명령어는 현재 디렉터리에 두 개의 파일을 만듭니다.

  • 스크립트 ID를 저장하는 .clasp.json 파일
  • 프로젝트 메타데이터가 포함된 appsscript.json 프로젝트 매니페스트 파일.

기존 프로젝트 클론

이 명령어는 현재 디렉터리의 기존 프로젝트를 클론합니다. 스크립트 Google 계정에서 만들거나 공유해야 합니다. 스크립트 지정 스크립트 ID를 제공하여 클론할 프로젝트입니다.

프로젝트의 스크립트 ID를 찾으려면 다음 단계를 따르세요.

  1. Apps Script 프로젝트를 엽니다.
  2. 왼쪽에서 프로젝트 설정 을 클릭합니다.

  3. ID 아래에서 스크립트 ID를 복사합니다.

     clasp clone <scriptId>

스크립트 프로젝트 다운로드

이 명령어는 Google Drive에서 컴퓨터의 파일 시스템으로서의 파일 시스템입니다.

clasp pull

스크립트 프로젝트 업로드

이 명령은 스크립트 프로젝트의 모든 파일을 컴퓨터에서 Google Drive

clasp push

프로젝트 버전 나열

이 명령어는 각 스크립트 프로젝트의 제공합니다

clasp versions

게시된 프로젝트 배포

스크립트 프로젝트를 웹 앱, 부가기능 또는 실행 파일로 배포할 수 있습니다. 다음과 같은 작업을 할 수 있습니다. 스크립트 편집기에서 배포를 만듭니다. 프로젝트 매니페스트에 넣거나 clasp를 사용합니다.

clasp를 사용하여 프로젝트를 배포하려면 먼저 변경할 수 없는 버전의 앱을 만드세요. 스크립트 프로젝트 버전은 '스냅샷'입니다. 스크립트 프로젝트의 스크립트 프로젝트이며 읽기 전용 브랜치 릴리스입니다.

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에 참여하세요.