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. Komut satırından E-Tablolar, Dokümanlar, Formlar ve Slaytlar gibi ürünler için web uygulamaları ve eklentiler oluşturup yayınlamanıza olanak tanır. Script.google.com'u kullanarak veya bilgisayarınızda yerel olarak Apps Komut Dosyası'nı geliştirmenin iki yolu vardır. Apps Komut Dosyası'nın komut satırı aracı olan clasp
özelliğinin nasıl kullanılacağını öğreneceğiz.
Özellikler
- Yerel Olarak Geliştirin.
clasp
Kendi bilgisayarınıza kod yazmanıza ve bunu tamamladığınızda kodu Apps Komut Dosyası'na yüklemenize olanak tanır. Ayrıca, mevcut Apps Komut Dosyası projelerini indirip yerel olarak düzenleyebilirsiniz. Kod yerel hale geldikten 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ılandırılmış Kod.
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 temel etkinliğin nasıl yapılacağı gösterilmektedir:
- Yeni Apps Komut Dosyası projeleri oluşturma
- Mevcut projeleri klonlama, çekme ve aktarma
- Komut dosyalarınızın dağıtımlarını yönetme
KSA'yı indirme
Apps Komut Dosyası KSA (clasp
), Node.js >= v6.0.0 sürümünün yüklenmesini gerektirir. Node.js'yi buraya yükleyin.
Node'ı edindikten sonra CLI'yı global olarak yükleyin (takma ad clasp):
npm i @google/clasp -g
Giriş
clasp'i deneyelim! Hatırlamanız gereken tek komut clasp
.
clasp
Komut satırı aracını kullanmaya başlamadan önce giriş yapmamız gerekir. Şu komutu çalıştırın:
clasp login
Bu noktada Google'a giriş yapmanız istenir. KSA ile oluşturduğunuz projeler bu Google hesabıyla ilişkilendirilir.
Bağımsız 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";
Az önce "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 gidip yeni bir sunu oluşturun. Sunu adını "clip Codelab Testi" olarak değiştirin. Başlıkta, Araçlar bölümünde Komut Dosyası Düzenleyicisi...'ne basın.
Bu işlem, script.google.com adresinde Apps Komut Dosyası projenizi açar. Bir projeyi klonlamak için Script ID
kodunu bulmamız gerekir. Bu değeri, File > Proje özellikleri > Bilgi > Komut Dosyası Kimliği (bu değer, URL'de de bulunur) bölümüne giderek bulabilirsiniz. Değeri kopyalayıp aşağıdaki komuta yapıştırın:
clasp clone <scriptID>
Çıkış şu şekilde görünmelidir:
Şimdi geçerli dizininize projeyi indirdiniz. Favori içeriğinizi kullanarak Code.gs
içeriğini görüntüleyin (boş bir işlev).
script.google.com'da kodu düzenleyin
Bir projeyi klonlayabildiğinize göre şimdi dosyaları nasıl çekip aktaracağınızı öğrenelim. script.google.com
üzerinden bulutta düzenleme adımlarında size yol göstereceğiz ve bilgisayarınıza yerel olarak çekeceğiz. Komut dosyasını bulutta açalım:
clasp open
Şimdi online düzenleyicide olduğumuza göre, clasp
uygulamasını kullanarak daha sonra getireceğimiz bazı kodları çevrimiçi olarak düzenleyeceğiz.
Düzenleyicide Dosya > Yeni > Komut dosyası'nı seçerek yeni bir dosya oluşturun. utils/strings
adını girin. Yeni oluşturulan utils/strings.gs
dosyasında kodu şu şekilde değiştirin:
var world = "世界";
Code.gs
için mevcut kodu aşağıdaki gibi değiştirin:
function hello() {
Logger.log("Hello, " + world);
}
Tüm dosyaları kaydettiğinizden emin olun. Run > Run function > hello
düğmesine basarak işlevi çalıştırmayı deneyin.
Karşılamayı görmek için View > Logs
sayfasına gidin.
Kodu yerel olarak düzenle
Projeyi en son klonladığımız komut satırına geri dönelim. Kodumuzun artık online düzenleyiciyle senkronize olmadığını fark edebilirsiniz. Bu sorunu düzeltmek için kodu çevrimiçi projemizden alalım.
clasp pull
Şimdi koda geri dönün. Yardımcı araçlarımız için bir klasör olduğunu fark edeceksiniz. clasp
KSA, 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
kodunu mondo
ile değiştirerek Code.gs öğesini güncelleyin. script.google.com
üzerindeki güncellenmiş kodu güncellemek için düzenlenen kodunuzu aktarın.
clasp push
Hepsi bu kadar! Kodunuz script.google.com
tarihinde güncellendi.
clasp
sürümleri ve dağıtımları yönetmenize olanak tanır. Öncelikle, bazı kelimeler:
- Sürüm: Bir komut dosyası projesinin "snpshot"u. Sürümler, dağıtımlar için kullanılan salt okunur dal olarak kabul edilebilir.
- Dağıtım: Komut dosyası projesinin yayınlanmış sürümü (genellikle eklenti veya web uygulaması olarak). Sürüm numarası gerektirir.
Komut dosyamızın bir sürümünü oluşturalım:
clasp version "First version"
[version]
yerine oluşturduğumuz günlük kaydı dizesini kullanarak komut dosyasını dağıtabiliriz:
clasp deploy 1 "First deployment"
clasp deploy
komutu, manifest dosyanıza bakar ve yeni bir sürüm oluşturulmuş dağıtım oluşturur. Kodunuz artık yürütülebilir olarak dağıtılıyor. Dağıtım rehberinde bu konu hakkında daha fazla bilgi edinebilirsiniz.
Apps Komut Dosyası KSA'nın, Apps Komut Dosyası projelerini yönetmenize yardımcı olan basit bir araç olduğunu umuyoruz.
Ele aldığımız 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 kullanılabilir ve yeni özelliklere ve yamalara hoş geldiniz.
Geliştirdiğiniz şeyi görmek için sabırsızlanıyoruz.