Untuk mengembangkan dan mengelola project Apps Script dari terminal Anda, bukan dari
Editor Apps Script, Anda dapat menggunakan alat open source yang disebut clasp
.
Codelab clasp
memberikan ringkasan tentang semua
clasp
fitur.
Fitur
Mengembangkan secara lokal
clasp
memungkinkan Anda mengembangkan project Apps Script secara lokal. Anda dapat
menulis kode di komputer Anda sendiri dan mengunggahnya ke Apps Script saat Anda
selesai. Anda juga dapat mendownload project Apps Script yang sudah ada agar dapat diedit
mereka ketika Anda sedang {i>offline<i}. Karena kode tersebut bersifat lokal, Anda dapat menggunakan
alat pengembangan seperti git
saat membuat Apps Script
project secara terprogram.
Mengelola versi deployment
Buat, perbarui, dan lihat beberapa deployment project Anda.
Kode struktur
clasp
memungkinkan Anda mengatur kode ke dalam direktori, yang dipertahankan
saat Anda menguploadnya ke script.google.com. Contoh:
# On script.google.com: ├── tests/slides.gs └── tests/sheets.gs # Locally: ├── tests/ │ ├─ slides.gs │ └─ sheets.gs
Persyaratan
clasp
ditulis dalam Node.js dan didistribusikan melalui
alat npm
. Sebelum menggunakan clasp
, Anda harus memiliki
Node.js versi 4.7.4 atau yang lebih baru terinstal.
Menginstal Node.js memerlukan hak istimewa administratif.
Penginstalan
Setelah menginstal Node.js, Anda dapat menggunakan perintah npm
berikut untuk
instal clasp
:
npm install @google/clasp -g
Setelah penginstalan, Anda dapat menggunakan perintah clasp
dari direktori mana pun di
seperti di komputer Anda.
Menggunakan clasp
Anda dapat menggunakan clasp
untuk menangani berbagai tugas dari command line. Ini
menjelaskan operasi umum yang dapat Anda gunakan saat mengembangkan dengan clasp
.
Login
Perintah ini login dan memberikan otorisasi atas pengelolaan Project Apps Script. Setelah dijalankan, Anda akan diminta untuk login ke akun tempat project Apps Script Anda disimpan.
clasp login
Logout
Perintah ini logout dari alat command line. Anda harus masuk kembali menggunakan
clasp login
untuk melakukan autentikasi ulang dengan Google sebelum melanjutkan penggunaan clasp
.
clasp logout
Membuat project Apps Script baru
Perintah ini membuat skrip baru di direktori saat ini dengan skrip opsional judul skrip.
clasp create [scriptTitle]
Perintah ini juga membuat dua file di direktori saat ini:
- File
.clasp.json
yang menyimpan ID skrip. - File manifes project
appsscript.json
yang berisi metadata project.
Meng-clone project yang sudah ada
Perintah ini meng-clone project yang ada di direktori saat ini. Naskah harus dibuat atau dibagikan dengan Akun Google Anda. Anda menentukan skrip untuk digandakan dengan memberikan ID skripnya.
Untuk menemukan ID Skrip project, ikuti langkah-langkah di bawah:
- Buka project Apps Script.
- Di sebelah kiri, klik Project Settings .
Di bagian ID, salin Script ID.
clasp clone <scriptId>
Mendownload project skrip
Perintah ini mendownload project Apps Script dari Google Drive ke sistem file komputer.
clasp pull
Upload project skrip
Perintah ini mengunggah semua file proyek skrip dari komputer Anda ke Google Drive.
clasp push
Mencantumkan versi project
Perintah ini mencantumkan jumlah dan deskripsi setiap resource versi.
clasp versions
Men-deploy project yang dipublikasikan
Anda dapat men-deploy project skrip sebagai aplikasi web, add-on, atau file yang dapat dieksekusi. Anda dapat
buat deployment di editor skrip,
dalam manifes project, atau menggunakan clasp
.
Untuk men-deploy project dengan clasp
, pertama-tama buat versi Aplikasi yang tidak dapat diubah
Project skrip. Sebuah versi adalah "snapshot" dari suatu proyek naskah dan mirip dengan
rilis bercabang hanya baca.
clasp version [description]
Perintah ini menampilkan nomor versi yang baru dibuat. Dengan menggunakan nomor itu, Anda dapat men-deploy dan membatalkan deployment instance project:
clasp deploy [version] [description]
clasp undeploy <deploymentId>
Perintah ini mengupdate deployment yang ada dengan versi dan deskripsi baru:
clasp redeploy <deploymentId> <version> <description>
Mencantumkan deployment
Perintah ini mencantumkan ID deployment project skrip, versi, dan deskripsi.
clasp deployments
Buka project di editor Apps Script
Perintah ini akan membuka project skrip di editor Apps Script. Editornya adalah diluncurkan sebagai tab baru di {i>browser<i} web {i>default<i} Anda.
clasp open
Berkontribusi pada project open source clasp
Berkontribusi ke clasp
di GitHub.