clasp ile komut satırı arayüzünü kullanma

Google Apps Komut Dosyası projelerini Apps Komut Dosyası düzenleyicisi yerine terminalinizden geliştirmek ve yönetmek için açık kaynaklı clasp aracını kullanın.

clasp Codelab, tüm clasp özelliklerine genel bir bakış sunar.

Özellikler

clasp aşağıdaki özellikleri içerir:

Yerel olarak geliştirme

clasp, Apps Komut Dosyası projelerinizi yerel olarak geliştirmenize olanak tanır. Kodu kendi bilgisayarınızda yazıp tamamladığınızda Apps Komut Dosyası'na yükleyin. Mevcut Apps Komut Dosyası projelerini indirip çevrimdışı olarak da düzenleyebilirsiniz. Apps Komut Dosyası projeleri oluştururken git gibi en sevdiğiniz geliştirme araçlarını kullanın.

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 dizinler halinde düzenlemenize olanak tanır. Bu dizinler, script.google.com'a yüklediğinizde korunur. Örneğin:

# On script.google.com:
├── tests/slides.gs
└── tests/sheets.gs

# Locally:
├── tests/
│   ├─ slides.gs
│   └─ sheets.gs

Proje türleri

Hem bağımsız hem de kapsayıcıya bağlı komut dosyası projelerini yönetmek için clasp kullanabilirsiniz.

Bağımsız projeler

Bağımsız bir proje, Google Drive'ınızda ayrı bir dosya olarak görünür. clasp create komutunu kullanarak yeni bir bağımsız komut dosyası oluşturabilirsiniz.

Kapsayıcıya bağlı projeler

Kapsayıcıya bağlı proje, Google Dokümanlar, E-Tablolar, Slaytlar veya Google Formlar dosyasına eklenir. clasp create komutunu kullanarak yeni bir dosyaya bağlı yeni bir kapsayıcıya bağlı komut dosyası oluşturabilirsiniz. --parentId işaretini kullanarak mevcut bir dosyaya yeni bir senaryo da ekleyebilirsiniz.

Diğer proje türleri

clasp, web uygulamaları ve API'ler için komut dosyaları oluşturmayı da destekler.

Şartlar

clasp, Node.js'de yazılır ve npm aracı kullanılarak dağıtılır. clasp kullanmadan önce Node.js 20.0.0 veya sonraki bir sürümünü yüklemiş olmanız gerekir. Node.js'nin yüklenebilmesi için yönetici ayrıcalıkları gerekir.

Kurulum

Node.js'yi yükledikten sonra npm yüklemek için aşağıdaki komutu kullanın: clasp

npm install @google/clasp -g

Yükleme işleminden sonra bilgisayarınızdaki herhangi bir dizinden clasp komutunu kullanın.

clasp hareketini kullanın

Komut satırından çeşitli görevleri yönetmek için clasp kullanın. Bu bölümde, clasp ile geliştirme yaparken kullanılabilecek yaygın işlemler açıklanmaktadır.

Giriş

Bu komut, Google Hesabınızın Apps Komut Dosyası projelerinde oturum açar ve bu projelerin yönetilmesine izin verir. Ç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 login ürününü kullanmaya devam etmeden önce Google ile yeniden kimlik doğrulamak için clasp login kullanarak yeniden oturum açın.clasp

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] [--type <projectType>] [--parentId <parentId>]

Bu komutta aşağıdaki isteğe bağlı parametreler kullanılır:

  • scriptTitle: Senaryo projesinin başlığı.
  • --type <projectType>: Oluşturulacak proje türü. İzin verilen değerler: standalone, docs, sheets, slides, forms, webapp ve api.
  • --parentId <parentId>: Yeni komut dosyası projesinin bağlanması gereken mevcut Google Drive dosyasının (Dokümanlar, E-Tablolar, Slaytlar veya Formlar) kimliği.

Bu komut, geçerli dizinde iki dosya da oluşturur:

  • Komut dosyası kimliğini depolayan bir .clasp.json dosyası.
  • Proje meta verilerini içeren bir appsscript.json proje manifest dosyası.

Mevcut bir projeyi klonlama

Bu komut, mevcut dizindeki mevcut bir projeyi klonlar. Komut dosyası, Google Hesabınızla oluşturulmalı veya paylaşılmalıdır. Komut dosyası kimliğini sağlayarak klonlanacak komut dosyası projesini belirtirsiniz. Hem bağımsız hem de kapsayıcıya bağlı projeleri klonlayabilirsiniz.

Projenin komut dosyası kimliğini bulmak için:

  1. Apps Komut Dosyası projesini açın.
  2. Sol tarafta Proje Ayarları'nı tıklayın.

  3. Kimlikler bölümünde Komut Dosyası Kimliği'ni kopyalayın.

    kilit klonu

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 Drive'a yükler.

clasp push

Proje sürümlerini listeleme

Bu komut, bir 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ı, Google Workspace eklentileri veya yürütülebilir dosyalar olarak dağıtın. Komut dosyası düzenleyicide, proje manifestinde veya clasp kullanarak dağıtımlar oluşturun.

clasp ile bir projeyi dağıtmak için öncelikle Apps Komut Dosyası projesinin değişmez bir sürümünü oluşturun. Sürüm, bir senaryo 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ğıtın ve dağıtımı kaldırın:

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üzenleyicisi'nde 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 başlatılır.

clasp open-script

clasp açık kaynak projesine katkıda bulunma

GitHub'da clasp'ya katkıda bulunun.