Apps Komut Dosyası projelerini Apps Komut Dosyası düzenleyicisi yerine terminalinizden geliştirip yönetmek için clasp adlı açık kaynaklı aracı 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. Ayrıca, çevrimdışıyken düzenleyebilmek için mevcut Apps Komut Dosyası projelerini de indirebilirsiniz. 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önetin
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ı üzerinden dağıtılır. clasp uygulamasını kullanmadan önce Node.js 4.7.4 veya sonraki bir sürümü yüklü olmalıdır.
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 uygulamasını kullanmaya devam etmeden önce Google ile yeniden kimlik doğrulamak için clasp login kullanarak yeniden giriş yapmalısınız.
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 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ği'ni 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, bilgisayarınızdaki bir komut dosyası projesinin tüm dosyalarını 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üzenleyicisinde, proje manifest 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 dallı 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 Komut Dosyası düzenleyicisinde açın.
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 bulunun
GitHub'da clasp projesine katkıda bulunun.