clasp - Apps Komut Dosyası KSA

1. Giriş

Apps Komut Dosyası KSA veya clasp, Apps Komut Dosyası projelerini yerel olarak oluşturmanızı, düzenlemenizi ve dağıtmanızı sağlayan bir araçtır. E-Tablolar, Dokümanlar, Formlar ve Slaytlar gibi ürünler için komut satırından web uygulamaları ile eklentiler oluşturup yayınlayabilmenizi sağlar. Apps Komut Dosyası'nı geliştirmenin iki yolu vardır: script.google.com'u kullanarak veya bilgisayarınızda yerel olarak. Bu bölümde, Apps Komut Dosyası'nın komut satırı aracı olan clasp'yı nasıl kullanacağınızı öğreneceksiniz.

Özellikler

• Yerel olarak geliştirin. clasp, kendi bilgisayarınızda kod yazmanıza ve tamamladığınızda Apps Komut Dosyası'na yüklemenize olanak tanır. Mevcut Apps Komut Dosyası projelerini indirip yerel olarak da düzenleyebilirsiniz. Kod yerel hale geldiğinde Apps Komut Dosyası projelerinde çalışmak için git gibi en sevdiğiniz geliştirme araçlarını kullanabilirsiniz.
• 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, script.google.com'daki düz proje yapınızı otomatik olarak klasörlere dönüştürür. Örneğin:

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

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

Neler öğreneceksiniz?

Bu codelab'de clasp ile 3 temel etkinliği nasıl yapacağınız gösterilmektedir:

• Yeni Apps Komut Dosyası projeleri oluşturma
• Mevcut projeleri klonlama, çekme ve gönderme
• Komut dosyalarınızın dağıtımlarını yönetme

2. Başlarken

KSA'yı indirme

Apps Komut Dosyası KSA'nın (clasp) yüklenebilmesi için Node.js'nin yüklü olması gerekir. Node.js'yi buradan yükleyin.

Not: clasp için Node.js >= 20.0.0 gereklidir. Node.js'yi aşağıdaki komutlarla güncelleyin:

sudo npm install n -g

sudo n latest

Node'u yükledikten sonra CLI'yı genel olarak yükleyin (diğer adı clasp):

npm i @google/clasp -g

3. Apps Komut Dosyası API'sini etkinleştirme

Clasp'ı kullanabilmek için Apps Komut Dosyası IDE'de Google Apps Komut Dosyası API'yi etkinleştirmeniz gerekir.

4. Giriş

Giriş

Clasp'i deneyelim. Hatırlamanız gereken tek komut clasp.

clasp

Bilgisayarımıza clasp global olarak yüklediğimiz için komut, dosya sisteminizin her yerinde çalışır.

Komut satırı aracını kullanmaya başlamadan önce giriş yapmamız gerekir. Bu komutu çalıştırın:

clasp login

veya SSH kullanılıyorsa:

clasp login --no-localhost

Bu noktada Google'da oturum açmanız istenir. CLI ile oluşturduğunuz tüm projeler bu Google Hesabı ile ilişkilendirilir.

5. Yeni proje oluşturma

Bağımsız proje oluşturma

Aşağıdaki komutu kullanarak bağımsız bir Google Apps Komut Dosyası projesi oluşturarak başlayın:

mkdir clasp_codelab;
cd clasp_codelab;
clasp create --title "Clasp Codelab"  --type standalone;

"clasp_codelab" klasöründe yeni bir Apps Komut Dosyası projesi oluşturdunuz.

Not: clasp create komutu bağımsız bir komut dosyası oluşturdu. Bu, projenin bir Google E-Tablosu, Dokümanı, Formu veya Sunusu'na bağlı olmadığı anlamına gelir. Ancak, bağlı komut dosyası oluşturma konusunu bir sonraki bölümde ele alacağız.

(İsteğe bağlı alternatif) Mevcut bir projeyi klonlama

Google Slaytlar eklentisi için kapsayıcıya bağlı bir komut dosyası oluşturmayı deneyelim.

Bunu yapmak için slides.google.com adresine gidip yeni bir sunu oluşturun. Sunu adını "clasp Codelab Test" olarak değiştirin. Slaytlar menü çubuğundaki Uzantılar menüsünde "Apps Komut Dosyası"nı seçin.

Bu işlem, Apps Komut Dosyası projenizi script.google.com adresinde açar.

Projeniz için yeni bir dizin oluşturun ve cd.

mkdir clasp_codelab_test
cd clasp_codelab_test

Bir projeyi klonlamak için Script ID gerekir. Bu kimliği, Apps Komut Dosyası proje URL'sinde /projects/ işaretinden sonra bulabilirsiniz. Değeri kopyalayıp aşağıdaki komuta yapıştırın:

clasp clone <scriptID>

Çıkış şu şekilde görünmelidir:

Proje, geçerli dizininize indirilir. Code.gs (boş bir işlev) içeriğini görüntülemek için favori düzenleyicinizi kullanın.

6. Dosyaları çekme ve gönderme

script.google.com adresinde kodu düzenleme

Artık projeleri klonlayabildiğinize göre dosyaları çekme ve gönderme işlemlerini öğrenelim. script.google.com üzerinden bulutta düzenleme yapma ve yerel olarak bilgisayarınıza çekme adımlarında size yol göstereceğiz. Komut dosyasını bulutta açalım:

clasp open-script

Online düzenleyiciye geçtiğimize göre, daha sonra clasp kullanarak getireceğimiz bazı kodları online olarak düzenleyeceğiz.

Yeni bir Apps Komut Dosyası oluşturmak için düzenleyicinin sol tarafında, Dosyalar'ın yanındaki Dosya ekle > Komut dosyası'nı tıklayın. Adı girin utils/strings. Yeni oluşturulan dosyada (utils/strings.gs), kodu aşağıdakilerle değiştirin:

var world = "世界";

Code.gs bölümünde mevcut kodu aşağıdakiyle değiştirin:

function hello() {
  Logger.log("Hello, " + world);
}

Üstte Kaydet'i tıklayın.

İşlevi çalıştırmak için düzenleyicinin üst kısmındaki işlev açılır listesinden hello simgesini seçin ve Çalıştır'ı tıklayın.

Selamlama, yürütme günlüğünün en altında görünür.

Kodu yerel olarak düzenleme

Projenin en son klonlandığı komut satırına geri dönelim. Kodumuzun artık online düzenleyiciyle senkronize olmadığını fark edebilirsiniz. Bunu düzeltmek için kodu online projemizden alalım.

clasp pull

Şimdi koda geri dönün. Yardımcı programlarımız için bir klasör olduğunu fark edeceksiniz. clasp CLI, eğik çizgi karakterini / yerel dosya sistemindeki klasörlere otomatik olarak dönüştürür.

Favori metin düzenleyicinizde util/strings.gs adresine gidin ve değişken adını world ile mondo olarak değiştirin. Ayrıca, Code.gs dosyasını world yerine mondo yazarak güncelleyin. script.google.com üzerinde güncellenen kodu güncellemek için düzenlediğiniz kodu gönderin.

clasp push

Hepsi bu kadar! Kodunuz script.google.com tarihinde güncellendi.

clasp push, script.google.com adresindeki kodun yerini alır ve clasp pull, tüm dosyaların yerel olarak yerini alır. Bu nedenle, aşağıdaki yönergeleri uygulayın:

• Kodu hem yerel olarak hem de script.google.com'da aynı anda düzenlemeyin.
• Git gibi bir sürüm denetim sistemi kullanın.

7. Sürüm oluşturma ve dağıtma

clasp, sürümleri ve dağıtımları yönetmenize olanak tanır. Öncelikle bazı kelimeler:

• Sürüm: Bir senaryo projesinin "anlık görüntüsü"dür. Bir sürüm, dağıtımlar için kullanılan salt okunur bir dal olarak kabul edilebilir.
• Dağıtım: Bir komut dosyası projesinin yayınlanmış sürümü (genellikle eklenti veya web uygulaması olarak). Sürüm numarası gereklidir.

Komut dosyamızın bir sürümünü oluşturalım:

clasp create-version "First version"

[version] yerine oluşturduğumuz kaydedilmiş sürüm dizesini kullanarak komut dosyasını dağıtabiliriz:

clasp create-deployment 1 "First deployment"

clasp deploy komutu, manifestinize bakar ve yeni bir sürüm oluşturulmuş dağıtım oluşturur. Kodunuz artık yürütülebilir bir dosya olarak dağıtılıyor. Bu konu hakkında daha fazla bilgiyi dağıtım kılavuzunda bulabilirsiniz.

8. İşte bu kadar.

Apps Komut Dosyası KSA'nın, Apps Komut Dosyası projelerini yönetmenize yardımcı olacak basit bir araç olduğunu umuyoruz.

İşlediğimiz konular

• Yeni Apps Komut Dosyası projeleri oluşturma
• Mevcut projeleri klonlama, gönderme ve çekme
• Komut dosyalarınızın dağıtımlarını yönetme

Clasp, GitHub'da kullanılabilir ve yeni özellikler ile yamalara açıktır.

Neler oluşturacağınızı görmek için sabırsızlanıyoruz.