Apps Script projelerini Apps Script düzenleyici 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. Kendi bilgisayarınızda kod yazabilir ve tamamladığınızda Apps Script'e yükleyebilirsiniz. Mevcut Apps Komut Dosyası projelerini de indirerek çevrimdışıyken düzenleyebilirsiniz. Kod yerel olduğundan Apps Komut Dosyası projeleri geliştirirken 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 dizinlere ayırmanıza olanak tanır. Bu dizinler, script.google.com'a yüklendiğinde 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ı aracılığıyla dağıtılır. clasp'ü kullanmadan önce Node.js 4.7.4 veya sonraki bir sürümü yüklemiş olmanız gerekir.
Node.js'yi yüklemek için yönetici ayrıcalıkları gerekir.
Kurulum
Node.js'i 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'ü kullanabilirsiniz. Bu bölümde, clasp ile geliştirirken kullanabileceğiniz yaygın işlemler açıklanmaktadır.
Giriş
Bu komut, giriş yapar ve Google Hesabınızın Apps Komut Dosyası projelerinin yönetimine yetki verir. Komut dosyası ç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ının oturumunu kapatır. clasp'u kullanmaya devam etmeden önce Google ile kimliğinizi yeniden doğrulamak için clasp login'ü kullanarak tekrar giriş yapmanız gerekir.
clasp logout
Yeni bir Apps Komut Dosyası projesi oluşturma
Bu komut, mevcut 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şturulmuş veya paylaşılmış olmalıdır. Komut dosyası kimliğini sağlayarak kopyalanacak 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, 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'i kullanarak dağıtım oluşturabilirsiniz.
Bir projeyi clasp ile dağıtmak için önce Apps Script projesinin değiştirilemez 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ğıtmayı 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 Script düzenleyicisinde 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 açılır.
clasp open
clasp açık kaynak projesine katkıda bulunma
GitHub'da clasp'e katkıda bulunun.