TypeScript JavaScript का टाइप किया गया सुपरसेट है, जो सामान्य Apps स्क्रिप्ट को कंपाइल कर सकता है. जब आप Apps Script प्रोजेक्ट के डेवलपमेंट में टाइपस्क्रिप्ट का इस्तेमाल करते हैं, तो आपको ये फ़ायदे मिलते हैं:
- लोकल IDE ऑटोकंप्लीट
- वैकल्पिक स्ट्रक्चरल टाइपिंग
- टाइप का अनुमान, इंटरफ़ेस
- ES6 की सुविधाएं, जैसे कि classes और ऐरो फ़ंक्शन.
इस गाइड में, TypeScript के साथ Apps Script प्रोजेक्ट बनाने के कुछ सामान्य कामों के बारे में बताया गया है.
ज़रूरी शर्तें
अगर आप टाइपस्क्रिप्ट के बारे में कुछ भी नहीं जानते हैं, तो TypeScript दस्तावेज़ और TypeScript क्विकस्टार्ट को पढ़ें, ताकि आप इस गाइड में बताई गई किसी भी प्रक्रिया को आज़माने से पहले बुनियादी सिद्धांतों के बारे में जान सकें.
clasp के साथ Apps Script प्रोजेक्ट में टाइपस्क्रिप्ट का इस्तेमाल करने के लिए,
इन टूल की ज़रूरत होती है. हालांकि, Apps Script में टाइपस्क्रिप्ट का इस्तेमाल करने के लिए, clasp का इस्तेमाल करने की ज़रूरत नहीं है, लेकिन हम इसे इस्तेमाल करने का सुझाव देते हैं, क्योंकि यह प्रोसेस को बहुत आसान बना देता है.
नीचे दी गई किसी भी प्रोसेस को आज़माने से पहले, यह पक्का करें कि आपने अपने लोकल डेवलपमेंट एनवायरमेंट को चालू करने के लिए यह इंस्टॉल किया हो:
- नोड और npm
clasp:npm install -g @google/clasp- 'Apps स्क्रिप्ट' के लिए टाइप की परिभाषाएं:
npm i -S @types/google-apps-script - विज़ुअल स्टूडियो कोड (TypeScript IDE अपने-आप पूरा होने के लिए)
अगर आपने पहले clasp का इस्तेमाल नहीं किया है, तो clasp के दस्तावेज़
के बारे में अच्छे से जानें.
क्लैस्प प्रोजेक्ट में टाइपस्क्रिप्ट का इस्तेमाल करना
clasp का इस्तेमाल करके, फटाफट
एक नया लोकल Apps Script प्रोजेक्ट बनाया जा सकता है.
यह निर्देश एक appsscript.json और Code.gs बनाता है, जो Apps Script प्रोजेक्ट का बेस होता है.
किसी App Script फ़ाइल में TypeScript का इस्तेमाल करने के लिए, बस फ़ाइल एक्सटेंशन का नाम gs से बदलकर ts करें.
स्थानीय टाइपस्क्रिप्ट फ़ाइलों में बदलाव करें
अपने पसंदीदा एडिटर का इस्तेमाल करके, प्रोजेक्ट के फ़ोल्डर में लोकल टाइपस्क्रिप्ट फ़ाइलों को .ts
फ़ाइलों के तौर पर लिखा जा सकता है.
उदाहरण के लिए, index.ts नाम की फ़ाइल में यह टाइपस्क्रिप्ट कोड हो सकता है:
const greeter = (person: string) => {
return `Hello, ${person}!`;
}
let user = 'Grant';
Logger.log(greeter(user));
आपके पास ES6+ की सुविधाओं के साथ टाइपस्क्रिप्ट लिखने का विकल्प होता है, जैसे कि
ऐरो फ़ंक्शन
और स्ट्रिंग इंटरपोलेशन (${var}). प्रोजेक्ट को Apps Script सर्वर पर पुश करने पर, इन फ़ाइलों को Apps Script कंस्ट्रक्ट में बदल दिया जाता है.
कोई ऐसा लोकल Apps Script प्रोजेक्ट अपलोड करें जो TypeScript का इस्तेमाल करता हो
लोकल टाइपस्क्रिप्ट और Apps Script फ़ाइलों में बदलाव करने के बाद, इस clasp कमांड का इस्तेमाल करके लोकल फ़ाइलों को Google Drive पर अपलोड किया जा सकता है:
clasp push --watch
यह निर्देश, TypeScript फ़ाइल में होने वाले बदलावों पर नज़र रखता है. साथ ही, प्रोजेक्ट को Google Drive पर अपलोड करने के लिए, typescript का और कोड को कंपाइल करने के लिए clasp का इस्तेमाल करता है.
समस्याओं की शिकायत करें या सुविधा का अनुरोध करें
अगर आपको clasp टूल में कोई समस्या आती है, तो GitHub पर उसकी शिकायत करें.
अगर आपको TypeScript में कोई समस्या या गड़बड़ी मिलती है, तो TypeScript के GitHub रिपॉज़िटरी में इसकी शिकायत करें.