Halaman ini diterjemahkan oleh Cloud Translation API.

Menggunakan antarmuka command line dengan gesper

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

Codelab clasp memberikan ringkasan tentang semua fitur clasp.

Fitur

Mengembangkan secara lokal

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

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. 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 mengembangkan dengan clasp.

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

clasp login

Logout

Perintah ini logout dari alat command line. Anda harus login 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 judul skrip opsional.

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 ada

Perintah ini meng-clone project yang ada di direktori saat ini. Skrip harus dibuat atau dibagikan dengan 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:

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 Anda.

clasp pull

Upload 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 manifest project, atau menggunakan clasp.

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

clasp version [description]

Perintah ini menampilkan nomor versi yang baru dibuat. Dengan menggunakan jumlah tersebut, Anda dapat men-deploy dan membatalkan deployment instance project:

clasp deploy [version] [description]
clasp undeploy <deploymentId>

Perintah ini akan memperbarui 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 pada project open source `clasp`

Berkontribusilah pada clasp di GitHub.