TypeScript, düz Apps Komut Dosyası olarak derlenebilen bir tür JavaScript üst kümesidir. Bir Apps Komut Dosyası projesinin geliştirilmesinde TypeScript'i kullandığınızda aşağıdaki avantajları elde edersiniz:
- Yerel IDE 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 bir Apps Komut Dosyası projesi geliştirmek için gerçekleştirilen bazı genel görevler ele alınmaktadır.
Koşullar
TypeScript'e aşina değilseniz 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.
clasp
ile Apps Komut Dosyası projelerinde TypeScript'i kullanmak için aşağıdaki araçlar gereklidir. Apps Komut Dosyası'nda TypeScript kullanımını etkinleştirmek için clasp
kullanılması kesinlikle gerekli olmasa da prosedürleri büyük ölçüde basitleştirdiği için kesinlikle önerilir.
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:
- Düğüm 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 Kodu (TypeScript IDE otomatik tamamlama için)
Daha önce clasp
kullanmadıysanız clasp
belgelerini
öğrenmeyi unutmayın.
Bir Clasp Projesinde TypeScript Kullanma
Hızla yeni bir yerel Apps Komut Dosyası projesi oluşturmak için clasp
kullanabilirsiniz.
Bu komut, bir Apps Komut Dosyası projesinin temeli olan appsscript.json
ve Code.gs
öğelerini oluşturur.
Bir App Komut Dosyası dosyasında TypeScript'i kullanmak için gs
olan dosya uzantısını ts
olarak yeniden adlandırmanız yeterlidir.
Yerel TypeScript dosyalarını düzenleme
Tercih ettiğiniz düzenleyiciyi kullanarak yerel TypeScript dosyalarını projenin klasörüne .ts
dosyaları olarak yazabilirsiniz.
Örneğin, index.ts
adlı bir dosya aşağıdaki TypeScript koduna sahip olabilir:
const greeter = (person: string) => {
return `Hello, ${person}!`;
}
let user = 'Grant';
Logger.log(greeter(user));
TypeScript'i ok işlevleri ve dize interpolasyonu (${var}
) gibi ES6+ özellikleriyle yazabilirsiniz. Projeyi Apps Komut Dosyası sunucusuna aktardığınızda bu dosyalar Apps Komut Dosyası yapılarına aktarılır.
TypeScript kullanan bir yerel Apps Komut Dosyası projesi yükleyin.
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.
Sorun bildirme veya özellik isteği gönderme
clasp
aracıyla ilgili bir sorunla karşılaşırsanız bu durumu GitHub'da bildirebilirsiniz.
TypeScript'in kendisinde bir sorun veya hatayla karşılaşırsanız bunu TypeScript'in GitHub deposunda bildirebilirsiniz.