Apps Komut Dosyası projelerini Apps Komut Dosyası düzenleyicisi yerine terminalinizden geliştirip yönetmek için clasp adlı açık kaynaklı bir aracı kullanabilirsiniz.
clasp codelab'i tüm clasp özelliklerine genel bir bakış sunar.
Özellikler
Yerel olarak geliştir
clasp, Apps Komut Dosyası projelerinizi yerel olarak geliştirmenize olanak tanır. Kendi bilgisayarınızda kod yazabilir ve işiniz bittiğinde kodu Apps Komut Dosyası'na yükleyebilirsiniz. Ayrıca mevcut Apps Komut Dosyası projelerini indirerek internete bağlı değilken de düzenleyebilirsiniz. Kod yerel olduğundan, Apps Komut Dosyası projeleri oluştururken git gibi favori geliştirme araçlarınızı kullanabilirsiniz.
Dağıtım sürümlerini yönetin
Projeniz için birden fazla dağıtım oluşturun, güncelleyin ve görüntüleyin.
Yapı kodu
clasp, kodunuzu Script.google.com'a yüklediğinizde korunan dizinler halinde düzenlemenize olanak tanır. Örneğin:
# On script.google.com: ├── tests/slides.gs └── tests/sheets.gs # Locally: ├── tests/ │ ├─ slides.gs │ └─ sheets.gs
Koşullar
clasp, Node.js dilinde yazılmıştır ve npm aracı üzerinden dağıtılır. clasp kullanmadan önce, Node.js 4.7.4 veya sonraki bir sürümünün yüklü olması gerekir.
Node.js'yi yüklemek için yönetici ayrıcalıkları gerekir.
Döşeme
Node.js'yi yükledikten sonra clasp yüklemek için aşağıdaki npm komutunu kullanabilirsiniz:
npm install @google/clasp -g
Yükleme işleminden sonra, clasp komutunu bilgisayarınızdaki herhangi bir dizinden kullanabilirsiniz.
clasp kullanılıyor
Çeşitli görevleri komut satırından gerçekleştirmek için clasp kullanabilirsiniz. Bu bölümde clasp ile geliştirme yaparken kullanabileceğiniz genel işlemler açıklanmaktadır.
Giriş yap
Bu komut, Google hesabınızın Apps Komut Dosyası projelerine giriş yapar ve bu projelerin yönetimini yetkilendirir. 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ından çıkış yapar. clasp uygulamasını kullanmaya devam etmeden önce Google ile yeniden kimlik doğrulamak için clasp login ile 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 ayrıca geçerli dizinde iki dosya oluşturur:
- Komut dosyası kimliğini saklayan bir
.clasp.jsondosyası. - Proje meta verilerini içeren
appsscript.jsonprojesi manifest dosyası.
Mevcut bir projeyi klonlama
Bu komut, geçerli dizindeki mevcut bir projeyi klonlar. Komut dosyası oluşturulmalı veya Google hesabınızla paylaşılmalıdır. Klonlanacak komut dosyası projesini, komut dosyası kimliğini sağlayarak belirtirsiniz.
Projenin komut dosyası kimliğini bulmak için aşağıdaki adımları izleyin:
- Apps Komut Dosyası projesini açın.
- Solda Proje Ayarları'nı tıklayın.
Kimlikler bölümünde, komut dosyası kimliğini kopyalayın.
clasp clone <scriptId>
Komut dosyası projesi indirin
Bu komut, Apps Komut Dosyası projesini Google Drive'dan bilgisayarınızın dosya sistemine indirir.
clasp pull
Komut dosyası projesi yükleyin
Bu komut, bir komut dosyası projesinin tüm dosyalarını bilgisayarınızdan Google Drive'a yükler.
clasp push
Proje sürümlerini listeleyin
Bu komut, bir komut dosyası projesinin her bir sürümünün sayısını ve açıklamasını listeler.
clasp versions
Yayınlanmış bir projeyi dağıtma
Komut dosyası projelerini web uygulamaları, eklenti veya yürütülebilir dosya olarak dağıtabilirsiniz. Komut dosyası düzenleyicide, proje manifestinde veya clasp kullanarak dağıtım oluşturabilirsiniz.
Bir projeyi clasp ile dağıtmak için öncelikle Apps Komut Dosyası projesinin sabit bir sürümünü oluşturun. Sürüm, bir komut dosyası projesinin "anlık görüntüsü"dür ve salt okunur dallara ayrılmış sürüme benzer.
clasp version [description]
Bu komut, yeni oluşturulan sürüm numarasını görüntüler. Bu numarayı kullanarak projenizin örneklerini dağıtabilir ve bunların dağıtımını kaldırabilirsiniz:
clasp deploy [version] [description]
clasp undeploy <deploymentId>
Bu komut, mevcut 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üzenleyicisinde aç
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 bulunun
GitHub'da clasp için katkıda bulunun.