TypeScript, JavaScript'in türü belirlenmiş bir üst kümesidir ve düz Apps Komut Dosyası'na derlenebilir. Apps Komut Dosyası projesi geliştirirken TypeScript kullandığınızda aşağıdaki avantajlardan yararlanırsınız:
- Yerel IDE'de otomatik tamamlama
- İsteğe bağlı yapısal yazma
- Tür çıkarımı, arayüzler
- Sınıflar ve ok işlevleri gibi ES6 özellikleri.
Bu kılavuzda, TypeScript ile Apps Komut Dosyası projesi geliştirirken kullanılan bazı yaygın görevler ele alınmaktadır.
Şartlar
TypeScript hakkında bilginiz yoksa bu kılavuzda açıklanan prosedürleri denemeden önce temel kavramları öğrenmek için TypeScript dokümanlarını ve TypeScript hızlı başlangıç kılavuzunu inceleyin.
Apps Komut Dosyası projelerinde clasp ile TypeScript'i kullanmak için aşağıdaki araçlar gereklidir. Apps Komut Dosyası'nda TypeScript kullanımını etkinleştirmek için clasp kullanmak kesinlikle gerekli olmasa da prosedürleri büyük ölçüde basitleştirdiği için şiddetle tavsiye edilir.
Aşağıda açıklanan işlemlerden herhangi birini denemeden önce, yerel geliştirme ortamınızı etkinleştirmek için aşağıdakileri yüklediğinizden emin olun:
- Node ve npm
clasp:npm install -g @google/clasp- Apps Komut Dosyası için tür tanımları:
npm i -S @types/google-apps-script - Visual Studio Code (TypeScript IDE otomatik tamamlama için)
clasp özelliğini daha önce kullanmadıysanız clasp dokümanlarını
inceleyin.
Clasp projesinde TypeScript kullanma
clasp kullanarak hızlı bir şekilde yeni bir yerel Apps Komut Dosyası projesi oluşturabilirsiniz.
Bu komut, Apps Komut Dosyası projesinin temeli olan appsscript.json ve Code.gs oluşturur.
Bir Apps Komut Dosyası dosyasında TypeScript kullanmak için dosya uzantısını gs yerine ts olarak değiştirmeniz yeterlidir.
Yerel TypeScript dosyalarını düzenleme
Tercih ettiğiniz düzenleyiciyi kullanarak proje klasöründeki .ts dosyaları olarak yerel TypeScript dosyaları yazabilirsiniz.
Örneğin, index.ts adlı bir dosya aşağıdaki TypeScript kodunu içerebilir:
const greeter = (person: string) => {
return `Hello, ${person}!`;
}
let user = 'Grant';
Logger.log(greeter(user));
ES6+ özellikleriyle (ör. ok işlevleri ve dize enterpolasyonu (${var})) TypeScript yazabilirsiniz. Bu dosyalar, projeyi Apps Komut Dosyası sunucusuna gönderdiğinizde Apps Komut Dosyası yapılarına dönüştürülür.
TypeScript kullanan yerel bir Apps Komut Dosyası projesi yükleme
Yerel TypeScript ve Apps Komut Dosyası dosyalarını düzenlemeyi tamamladığınızda aşağıdaki clasp komutunu kullanarak yerel dosyaları Google Drive'a yükleyebilirsiniz:
clasp push --watch
Bu komut, TypeScript dosya değişikliklerini izler ve kodu derlemek için typescript, projeyi Google Drive'a yüklemek için clasp kullanır.
Sorunları bildirme veya özellik isteğinde bulunma
clasp aracıyla ilgili bir sorunla karşılaşırsanız bunu GitHub'da bildirebilirsiniz.
TypeScript'in kendisiyle ilgili bir sorun veya hata ile karşılaşırsanız bunu TypeScript'in GitHub deposunda bildirebilirsiniz.