Menggunakan antarmuka command line dengan gesper

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 ada sehingga Anda dapat mengeditnya saat offline. 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 ada

Perintah ini meng-clone project yang ada di direktori saat ini. Naskah harus dibuat atau dibagikan dengan Akun Google Anda. Anda yang menentukan skrip untuk digandakan dengan memberikan ID skripnya.

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

  1. Buka project Apps Script.
  2. Di sebelah kiri, klik Setelan Project .
  3. 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. 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 nomor itu, 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

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.