clasp - Apps Komut Dosyası KSA

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&quot" 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.