1. Giriş
Apps Komut Dosyası KSA veya clasp, Apps Komut Dosyası projelerini yerel olarak oluşturmanıza, düzenlemenize ve dağıtmanıza olanak tanıyan bir araçtır. E-Tablolar, Dokümanlar, Formlar ve Slaytlar gibi ürünler için komut satırından web uygulamaları ve eklentiler oluşturup yayınlamanıza olanak tanır. Apps Komut Dosyası'nı iki şekilde geliştirebilirsiniz: script.google.com'u kullanarak veya yerel olarak bilgisayarınızda. İkinci olarak, Apps Komut Dosyası için komut satırı aracı olan clasp'nin nasıl kullanılacağını öğreneceğiz.
Özellikler
- Yerel Olarak Geliştirin.
clasp, bilgisayarınızda kod yazmanıza ve işiniz bittiğinde kodu Apps Komut Dosyası'na yüklemenize olanak tanır. Ayrıca, mevcut Apps Komut Dosyası projelerini indirip yerel olarak da düzenleyebilirsiniz. Kod yerelleştirildikten sonra Apps Komut Dosyası projelerinde çalışmak için git gibi favori geliştirme araçlarınızı 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 adresindeki düz projenizi 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 önemli etkinliği nasıl gerçekleştireceğiniz anlatılmaktadır:
- Yeni Apps Komut Dosyası projeleri oluşturma
- Mevcut projeleri klonlama, çekme ve aktarma
- Komut dosyalarınızın dağıtımlarını yönetme
2. Başlarken
KSA'yı indirme
Apps Komut Dosyası KSA (clasp) için Node.js >= v6.0.0 yüklü olmalıdır. Node.js'yi buradan yükleyin.
Düğümü oluşturduktan sonra CLI'yı genel olarak yükleyin (takma ad clasp):
npm i @google/clasp -g
3. Giriş
Giriş
Şimdi clasp'i deneyelim. Hatırlamanız gereken tek komut clasp şeklindedir.
clasp
Komut satırı aracını kullanmaya başlamadan önce giriş yapmamız gerekir. Bu komutu çalıştırın:
clasp login
veya SSH kullanıyorsanız:
clasp login --no-localhost
Bu noktada Google'a giriş yapmanız istenir. KSA ile oluşturduğunuz tüm projeler bu Google Hesabı ile ilişkilendirilir.
4. Yeni Proje Oluştur
Bağımsız bir proje oluşturma
Aşağıdaki komutla 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 bir Apps Komut Dosyası Projesi oluşturdunuz.
(İsteğe bağlı alternatif) Mevcut bir projeyi klonlama
Bir Google Slaytlar Eklentisi için kapsayıcıya bağlı bir komut dosyası oluşturmayı deneyelim.
Bunu yapmak için slides.google.com adresine gidin ve yeni bir sunu oluşturun. Sunu adını "clasp Codelab Test" olarak değiştirin. Başlıkta, Araçlar altında Komut Dosyası Düzenleyici... seçeneğine basın.
script.google.com adresinde Apps Komut Dosyası projeniz açılır. Bir projeyi klonlamak için Script ID öğesine ihtiyacımız var. Bu kimliği, /projects/ sonrasındaki Apps Komut Dosyası projesinin URL'sinde bulabilirsiniz. Değeri kopyalayıp aşağıdaki komuta yapıştırın:
clasp clone <scriptID>
Çıkış şu şekilde görünmelidir...
Artık projeyi geçerli dizininize indirdiniz. Code.gs (boş bir işlev) içeriğini görüntülemek için favori düzenleyicinizi kullanın.
5. Çekme ve Dosya Aktarma
code.google.com'da kodu düzenleyin
Artık bir projeyi klonlayabildiğinize göre şimdi dosyaları nasıl çekeceğinizi ve aktaracağınızı öğrenelim. script.google.com aracılığıyla bulutta düzenleme ve yerel olarak bilgisayarınıza çekme adımlarında size rehberlik edeceğiz. Komut dosyasını bulutta açalım:
clasp open
Artık online düzenleyicide olduğumuza göre bazı kodları internette düzenleyeceğiz ve sonrasında clasp kullanarak getireceğiz.
Yeni bir Apps Komut Dosyası oluşturmak için düzenleyicinin sol tarafında, Dosyalar'ın yanındaki Dosya ekle'yi 
> Komut dosyası. utils/strings adını girin. Yeni oluşturulan utils/strings.gs dosyasında, kodu aşağıdaki kodla değiştirin:
var world = "世界";
Code.gs ürününde, mevcut kodu aşağıdaki kodla 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 öğesini seçin ve Çalıştır'ı tıklayın.
Karşılama, yürütme günlüğünün alt kısmında görünür.
Kodu yerel olarak düzenleme
Projeyi en son klonladığımız komut satırına geri dönelim. Kodumuzun artık çevrimiçi düzenleyiciyle senkronize olmadığını fark edebilirsiniz. Bunu düzeltmek için online projemizden kodu alalım.
clasp pull
Şimdi koda geri dönün. Yardımcı araçlarımız için bir klasör olduğunu göreceksiniz. clasp CLI, eğik çizgi karakterini (/) otomatik olarak yerel dosya sistemindeki klasörlere dönüştürür.
Favori metin düzenleyicinizde, util/strings.gs bölümüne gidin ve world değişken adını mondo olarak değiştirin. Ayrıca, world yerine mondo kodunu kullanarak Code.gs'yi güncelleyin. script.google.com üzerinde güncellenen kodu güncellemek için düzenlediğiniz kodu aktarın.
clasp push
Hepsi bu kadar! Kodunuz artık script.google.com adresinde güncellendi.
6. Sürüm Oluşturma ve Dağıtma
clasp, sürümleri ve dağıtımları yönetmenize olanak tanır. İlk olarak bazı kelimeler:
- Sürüm: "Anlık görüntü" örneğidir. 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 bir eklenti veya web uygulaması olarak). Sürüm numarası gereklidir.
Komut dosyamızın bir sürümünü oluşturalım:
clasp version "First version"
[version] yerine oluşturduğumuz, günlüğe kaydedilmiş sürüm dizesini kullanarak komut dosyasını dağıtabiliriz:
clasp deploy 1 "First deployment"
clasp deploy komutu, manifest dosyanızı inceler ve sürümlü yeni bir dağıtım oluşturur. Kodunuz yürütülebilir olarak dağıtıldı. Bu konu hakkında daha fazla bilgiye dağıtım kılavuzundan ulaşabilirsiniz.
7. İşte bu kadar.
Apps Komut Dosyası KSA'sı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, aktarma ve çekme
- Komut dosyalarınızın dağıtımlarını yönetme
Clasp, GitHub'da mevcuttur ve yeni özellikler ile yamalardan yararlanabilir.
Neler geliştireceğinizi görmek için sabırsızlanıyoruz!