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.json
dosyası. - Proje meta verilerini içeren
appsscript.json
projesi 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.