Apps Script projelerini Apps Script düzenleyicisi yerine terminalinizden geliştirmek ve yönetmek için clasp adlı açık kaynaklı bir araç kullanabilirsiniz.
clasp Codelab, tüm clasp özelliklerine genel bir bakış sunar.
Özellikler
Yerel olarak geliştirme
clasp, Apps Komut Dosyası projelerinizi yerel olarak geliştirmenize olanak tanır. Kodu kendi bilgisayarınızda yazıp tamamladığınızda Apps Komut Dosyası'na yükleyebilirsiniz. Mevcut Apps Komut Dosyası projelerini indirerek çevrimdışıyken de düzenleyebilirsiniz. Kod yerel olduğundan Apps Komut Dosyası projeleri oluştururken git gibi en sevdiğiniz geliştirme araçlarını kullanabilirsiniz.
Dağıtım sürümlerini yönetme
Projenizin birden fazla dağıtımını oluşturun, güncelleyin ve görüntüleyin.
Yapı kodu
clasp, kodunuzu dizinler halinde düzenlemenize olanak tanır. Bu dizinler, script.google.com'a yüklediğinizde korunur. Örneğin:
# On script.google.com: ├── tests/slides.gs └── tests/sheets.gs # Locally: ├── tests/ │ ├─ slides.gs │ └─ sheets.gs
Şartlar
clasp, Node.js'de yazılır ve npm aracıyla dağıtılır. clasp'yı kullanmadan önce Node.js 4.7.4 veya sonraki bir sürümünü yüklemiş olmanız gerekir.
Node.js'nin yüklenebilmesi için yönetici ayrıcalıkları gerekir.
Kurulum
Node.js'yi yükledikten sonra clasp'i yüklemek için aşağıdaki npm komutunu kullanabilirsiniz:
npm install @google/clasp -g
Yükleme işleminden sonra bilgisayarınızdaki herhangi bir dizinden clasp komutunu kullanabilirsiniz.
clasp kullanılıyor
Komut satırından çeşitli görevleri yönetmek için clasp aracını kullanabilirsiniz. Bu bölümde, clasp ile geliştirme yaparken kullanabileceğiniz yaygın işlemler açıklanmaktadır.
Giriş
Bu komut, Google Hesabınızın Apps Komut Dosyası projelerinde oturum açar ve bu projelerin yönetilmesine izin verir. Çalıştırıldıktan sonra, Apps Komut Dosyası projelerinizin depolandığı bir Google Hesabı'nda oturum açmanız istenir.
clasp login
Çıkış
Bu komut, komut satırı aracından çıkış yapar. clasp uygulamasını kullanmaya devam etmeden önce Google ile yeniden kimlik doğrulamak için clasp login kullanarak yeniden giriş yapmanız gerekir.
clasp logout
Yeni bir Apps Komut Dosyası projesi oluşturma
Bu komut, geçerli dizinde isteğe bağlı bir komut dosyası başlığıyla yeni bir komut dosyası oluşturur.
clasp create [scriptTitle]
Bu komut, geçerli dizinde iki dosya da oluşturur:
- Komut dosyası kimliğini depolayan bir
.clasp.jsondosyası. - Proje meta verilerini içeren bir
appsscript.jsonproje manifest dosyası.
Mevcut bir projeyi klonlama
Bu komut, mevcut dizindeki mevcut bir projeyi klonlar. Komut dosyası, Google Hesabınızla oluşturulmalı veya paylaşılmalıdır. Komut dosyası kimliğini sağlayarak klonlanacak komut dosyası projesini belirtirsiniz.
Projenin komut dosyası kimliğini bulmak için aşağıdaki adımları uygulayın:
- Apps Komut Dosyası projesini açın.
- Sol tarafta Proje Ayarları'nı tıklayın.
Kimlikler bölümünde komut dosyası kimliğini kopyalayın.
clasp clone <scriptId>
Komut dosyası projesi indirme
Bu komut, Apps Komut Dosyası projesini Google Drive'dan bilgisayarınızın dosya sistemine indirir.
clasp pull
Komut dosyası projesi yükleme
Bu komut, bir komut dosyası projesinin tüm dosyalarını bilgisayarınızdan Google Drive'a yükler.
clasp push
Proje sürümlerini listeleme
Bu komut, bir komut dosyası projesinin her bir sürümünün numarasını ve açıklamasını listeler.
clasp versions
Yayınlanmış bir projeyi dağıtma
Komut dosyası projelerini web uygulamaları, eklentiler veya yürütülebilir dosyalar olarak dağıtabilirsiniz. Komut dosyası düzenleyicide, proje manifestinde veya clasp kullanarak dağıtımlar oluşturabilirsiniz.
clasp ile bir proje dağıtmak için önce Apps Komut Dosyası projesinin değişmez bir sürümünü oluşturun. Sürüm, komut dosyası projesinin "anlık görüntüsüdür" ve salt okunur dallanmış sürüme benzer.
clasp version [description]
Bu komut, yeni oluşturulan sürüm numarasını gösterir. Bu numarayı kullanarak projenizin örneklerini dağıtabilir ve dağıtımı kaldırabilirsiniz:
clasp deploy [version] [description]
clasp undeploy <deploymentId>
Bu komut, mevcut bir dağıtımı yeni bir sürüm ve açıklamayla günceller:
clasp redeploy <deploymentId> <version> <description>
Dağıtımları listeleyin
Bu komut, komut dosyası projesinin dağıtım kimliklerini, sürümlerini ve açıklamalarını listeler.
clasp deployments
Projeyi Apps Komut Dosyası Düzenleyici'de açma
Bu komut, Apps Komut Dosyası düzenleyicisinde bir komut dosyası projesi açar. Düzenleyici, varsayılan web tarayıcınızda yeni bir sekme olarak başlatılır.
clasp open
clasp açık kaynak projesine katkıda bulunma
GitHub'da clasp'a katkıda bulunun.