Halaman ini diterjemahkan oleh Cloud Translation API.

Menggunakan antarmuka command line dengan gesper

Untuk mengembangkan dan mengelola project Apps Script dari terminal, bukan dari editor Apps Script, Anda dapat menggunakan alat open source yang disebut clasp.

Codelab clasp memberikan ringkasan semua fitur clasp.

Fitur

Mengembangkan secara lokal

clasp memungkinkan Anda mengembangkan project Apps Script secara lokal. Anda dapat menulis kode di komputer sendiri dan menguploadnya ke Apps Script setelah selesai. Anda juga dapat mendownload project Apps Script yang sudah ada sehingga dapat mengeditnya saat offline. Karena kode ini bersifat lokal, Anda dapat menggunakan alat pengembangan favorit seperti git saat membuat project Apps Script.

Mengelola versi deployment

Buat, update, 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. Misalnya:

# 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 menginstal Node.js versi 4.7.4 atau yang lebih baru. Menginstal Node.js memerlukan hak istimewa administratif.

Penginstalan

Setelah menginstal Node.js, Anda dapat menggunakan perintah npm berikut untuk menginstal clasp:

npm install @google/clasp -g

Setelah penginstalan, Anda dapat menggunakan perintah clasp dari direktori mana pun di komputer Anda.

Menggunakan `clasp`

Anda dapat menggunakan clasp untuk menangani berbagai tugas dari command line. Bagian ini menjelaskan operasi umum yang dapat Anda gunakan saat melakukan pengembangan dengan clasp.

Perintah ini login dan mengizinkan pengelolaan project Apps Script di akun Google Anda. Setelah dijalankan, Anda akan diminta untuk login ke Akun Google tempat project Apps Script disimpan.

clasp login

Logout

Perintah ini akan logout dari alat command line. Anda harus login kembali menggunakan clasp login untuk melakukan autentikasi ulang dengan Google sebelum melanjutkan menggunakan clasp.

clasp logout

Membuat project Apps Script baru

Perintah ini membuat skrip baru di direktori saat ini dengan judul skrip opsional.

clasp create [scriptTitle]

Perintah ini juga membuat dua file dalam 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. Skrip harus dibuat atau dibagikan ke Akun Google Anda. Anda menentukan project skrip yang akan di-clone dengan memberikan ID skripnya.

Untuk menemukan ID Skrip project, ikuti langkah-langkah di bawah ini:

Buka project Apps Script.
Di sebelah kiri, klik Setelan Project .
Di bagian ID, salin ID Skrip.
```
 clasp clone <scriptId>
```

Mendownload project skrip

Perintah ini akan mendownload project Apps Script dari Google Drive ke sistem file komputer Anda.

clasp pull

Mengupload project skrip

Perintah ini mengupload semua file project skrip dari komputer Anda ke Google Drive.

clasp push

Mencantumkan versi project

Perintah ini mencantumkan nomor dan deskripsi setiap versi project skrip.

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 membuat deployment di editor skrip, di manifes project, atau menggunakan clasp.

Untuk men-deploy project dengan clasp, pertama-tama buat versi project Apps Script yang tidak dapat diubah. Versi adalah "snapshot" project skrip dan mirip dengan rilis cabang hanya baca.

clasp version [description]

Perintah ini akan menampilkan nomor versi yang baru dibuat. Dengan nomor tersebut, 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, versi, dan deskripsi project skrip.

clasp deployments

Membuka project di editor Apps Script

Perintah ini akan membuka project skrip di editor Apps Script. Editor diluncurkan sebagai tab baru di browser web default Anda.

clasp open

Berkontribusi ke project open source `clasp`

Berikan kontribusi ke clasp di GitHub.