Antarmuka Command Line menggunakan gesper

Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

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

Codelab clasp menyediakan ringkasan semua fitur clasp.

Fitur

Kembangkan 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 agar dapat mengeditnya saat offline. Karena kode tersebut bersifat lokal, Anda dapat menggunakan alat pengembangan favorit seperti git saat mem-build 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. Penginstalan Node.js memerlukan hak istimewa administrator.

Penginstalan

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

npm install @google/clasp -g

Setelah diinstal, perintah clasp dapat digunakan 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.

Login

Perintah ini akan login dan mengizinkan pengelolaan project Apps Script Akun Google Anda. Setelah dijalankan, Anda akan diminta untuk login ke Akun Google tempat project Apps Script 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 dapat terus menggunakan clasp.

clasp logout

Membuat project skrip aplikasi baru

Perintah ini membuat skrip baru di direktori saat ini dengan judul skrip yang bersifat 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 sudah 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 berikut:

  1. Buka project Apps Script.
  2. Di sebelah kiri, klik Project Settings .
  3. Di bagian ID, salin ID Skrip.

     clasp clone <scriptId>
    

Mendownload project skrip

Perintah ini 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 ke Google Drive.

clasp push

Mencantumkan versi project

Perintah ini mencantumkan jumlah 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, dalam 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" dari project skrip dan mirip dengan rilis cabang hanya baca.

clasp version [description]

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

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

Perintah ini mengupdate deployment yang ada dengan versi dan deskripsi yang baru:

clasp redeploy <deploymentId> <version> <description>

Mencantumkan deployment

Perintah ini mencantumkan ID deployment, versi, dan deskripsi deployment project skrip.

clasp deployments

Membuka project di editor Apps Script

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

clasp open

Berkontribusi untuk project open source clasp

Berikan kontribusi untuk clasp di GitHub.