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'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 bu kodu Apps Komut Dosyası'na 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 komutlar.google.com'a yüklediğinizde saklanan dizinler halinde düzenlemenizi sağlar. Örneğin:
# On script.google.com: ├── tests/slides.gs └── tests/sheets.gs # Locally: ├── tests/ │ ├─ slides.gs │ └─ sheets.gs
Koşullar
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.
Döşeme
Node.js'yi yükledikten sonra clasp
uygulamasını yüklemek için aşağıdaki npm
komutunu kullanabilirsiniz:
npm install @google/clasp -g
Yükleme işleminden sonra clasp
komutunu bilgisayarınızda herhangi bir dizinden kullanabilirsiniz.
clasp
kullanılıyor
Komut satırından çeşitli görevleri yürütmek için clasp
öğesini kullanabilirsiniz. Bu bölümde, clasp
ile geliştirme yaparken kullanabileceğiniz genel işlemler açıklanmaktadır.
Giriş
Bu komut, giriş yapar ve Google hesabınızın Apps Komut Dosyası projelerinin yönetilmesini yetkilendirir. Komut dosyası çalıştırıldıktan sonra sizden 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ş 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ğinin depolandığı bir
.clasp.json
dosyası. - Proje meta verilerini içeren
appsscript.json
proje manifest dosyası.
Mevcut bir projeyi klonlama
Bu komut, geçerli dizinde mevcut bir projeyi klonlar. Komut dosyası oluşturulmalı veya Google Hesabınızla 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.
- Solda Proje Ayarları'nı tıklayın.
Kimlikler bölümünün altında komut dosyası kimliğini kopyalayın.
clasp clone <scriptId>
Komut dosyası projesini 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, bilgisayarınızdaki bir komut dosyası projesinin tüm dosyalarını Google Drive'a yükler.
clasp push
Proje sürümlerini listeleyin
Bu komut, bir komut dosyası projesinin her 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. Dağıtımları komut dosyası düzenleyicide, proje manifest'te veya clasp
kullanarak oluşturabilirsiniz.
Bir projeyi clasp
ile dağıtmak için önce 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 dallı sürüme benzer.
clasp version [description]
Bu komut, yeni oluşturulan sürüm numarasını gösterir. Bu sayıyı kullanarak projenizin örneklerini dağıtabilir ve bunların dağıtımını 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ı projesini 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
için katkıda bulunun.