Apps Script एडिटर के बजाय, अपने टर्मिनल से Apps Script प्रोजेक्ट डेवलप और मैनेज करने के लिए, clasp नाम के ओपन सोर्स टूल का इस्तेमाल किया जा सकता है.
clasp कोडलैब में, clasp की सभी सुविधाओं की खास जानकारी मिलती है.
सुविधाएं
स्थानीय तौर पर डेवलप करना
clasp आपको अपने Apps Script प्रोजेक्ट को स्थानीय तौर पर डेवलप करने की सुविधा देता है.
अपने कंप्यूटर पर कोड लिखा जा सकता है और काम पूरा होने के बाद उसे Apps Script में अपलोड किया जा सकता है. आप मौजूदा Apps Script प्रोजेक्ट भी डाउनलोड कर सकते हैं, ताकि ऑफ़लाइन होने पर भी उनमें बदलाव किए जा सकें. कोड स्थानीय है, इसलिए Apps Script प्रोजेक्ट बनाते समय, git जैसे अपने पसंदीदा
डेवलपमेंट टूल इस्तेमाल किए जा सकते हैं.
डिप्लॉयमेंट वर्शन मैनेज करें
अपने प्रोजेक्ट के कई डिप्लॉयमेंट बनाएं, उन्हें अपडेट करें, और देखें.
स्ट्रक्चर कोड
clasp की मदद से, अपने कोड को डायरेक्ट्री में व्यवस्थित किया जा सकता है. ये डायरेक्ट्री, script.google.com में अपलोड करने के बाद सेव रहती हैं. उदाहरण के लिए:
# On script.google.com: ├── tests/slides.gs └── tests/sheets.gs # Locally: ├── tests/ │ ├─ slides.gs │ └─ sheets.gs
ज़रूरी शर्तें
clasp को Node.js में लिखा गया है और npm टूल की मदद से डिस्ट्रिब्यूट किया जाता है. clasp का इस्तेमाल करने से पहले, आपके पास
Node.js का 4.7.4 या इसके बाद का वर्शन इंस्टॉल होना चाहिए.
Node.js को इंस्टॉल करने के लिए, एडमिन के अधिकार होने ज़रूरी हैं.
इंस्टॉल करना
Node.js इंस्टॉल करने के बाद, clasp इंस्टॉल करने के लिए, इस npm कमांड का इस्तेमाल किया जा सकता है:
npm install @google/clasp -g
इंस्टॉल करने के बाद, अपने कंप्यूटर पर किसी भी डायरेक्ट्री से clasp कमांड का इस्तेमाल किया जा सकता है.
clasp का इस्तेमाल करना
कमांड लाइन से कई तरह के टास्क मैनेज करने के लिए, clasp का इस्तेमाल किया जा सकता है. इस
सेक्शन में, ऐसी कुछ सामान्य कार्रवाइयों के बारे में बताया गया है जिनका इस्तेमाल, clasp के साथ डेवलप करते समय किया जा सकता है.
लॉगिन
यह निर्देश लॉग इन करता है और आपके Google खाते के Apps Script प्रोजेक्ट को मैनेज करने की अनुमति देता है. इसके चलने के बाद, आपको उस Google खाते में साइन इन करने के लिए कहा जाता है जिसमें आपके Apps Script प्रोजेक्ट सेव किए जाते हैं.
clasp login
लॉगआउट करें
यह कमांड, कमांड लाइन टूल से लॉग आउट हो जाता है. clasp का इस्तेमाल जारी रखने से पहले, आपको Google पर फिर से पुष्टि करने के लिए, clasp login का इस्तेमाल करके फिर से लॉगिन करना होगा.
clasp logout
नया Apps Script प्रोजेक्ट बनाना
इस निर्देश से मौजूदा डायरेक्ट्री में एक नई स्क्रिप्ट बनाई जाती है, जिसमें वैकल्पिक स्क्रिप्ट टाइटल होता है.
clasp create [scriptTitle]
इस निर्देश से मौजूदा डायरेक्ट्री में दो फ़ाइलें भी बनती हैं:
- स्क्रिप्ट आईडी सेव करने वाली
.clasp.jsonफ़ाइल. appsscript.jsonप्रोजेक्ट मेनिफ़ेस्ट फ़ाइल, जिसमें प्रोजेक्ट मेटाडेटा है.
मौजूदा प्रोजेक्ट का क्लोन बनाएं
यह निर्देश, मौजूदा डायरेक्ट्री में मौजूद प्रोजेक्ट का क्लोन बनाता है. आपको स्क्रिप्ट बनानी होगी या आपके Google खाते के साथ शेयर करनी होगी. आपको स्क्रिप्ट प्रोजेक्ट का स्क्रिप्ट आईडी देकर, उसका क्लोन बनाना होता है.
प्रोजेक्ट का स्क्रिप्ट आईडी ढूंढने के लिए, यह तरीका अपनाएं:
- Apps Script प्रोजेक्ट खोलें.
- बाईं ओर, प्रोजेक्ट सेटिंग पर क्लिक करें.
आईडी में जाकर, स्क्रिप्ट आईडी कॉपी करें.
clasp clone <scriptId>
स्क्रिप्ट प्रोजेक्ट डाउनलोड करना
यह निर्देश, Google Drive से Apps Script प्रोजेक्ट को आपके कंप्यूटर के फ़ाइल सिस्टम पर डाउनलोड करता है.
clasp pull
स्क्रिप्ट प्रोजेक्ट अपलोड करें
यह निर्देश, स्क्रिप्ट प्रोजेक्ट की सभी फ़ाइलों को आपके कंप्यूटर से Google Drive पर अपलोड कर देता है.
clasp push
प्रोजेक्ट के वर्शन की सूची बनाएं
इस निर्देश में, स्क्रिप्ट प्रोजेक्ट के हर वर्शन की संख्या और जानकारी दी गई है.
clasp versions
पब्लिश किए गए प्रोजेक्ट को डिप्लॉय करना
स्क्रिप्ट प्रोजेक्ट को वेब ऐप्लिकेशन, ऐड-ऑन या एक्ज़ीक्यूटेबल के तौर पर डिप्लॉय किया जा सकता है. इसके लिए, स्क्रिप्ट एडिटर, प्रोजेक्ट मेनिफ़ेस्ट या clasp का इस्तेमाल करके डिप्लॉयमेंट बनाए जा सकते हैं.
clasp के साथ कोई प्रोजेक्ट डिप्लॉय करने के लिए, पहले Apps Script प्रोजेक्ट का ऐसा वर्शन बनाएं जिसमें बदलाव न किया जा सके. वर्शन किसी स्क्रिप्ट प्रोजेक्ट का "स्नैपशॉट" होता है और वह रीड-ओनली ब्रांच वाली रिलीज़ की तरह होता है.
clasp version [description]
यह निर्देश, बनाया गया नया वर्शन नंबर दिखाता है. इस नंबर का इस्तेमाल करके, अपने प्रोजेक्ट के इंस्टेंस को डिप्लॉय और डिप्लॉय नहीं किया जा सकता है:
clasp deploy [version] [description]
clasp undeploy <deploymentId>
यह निर्देश मौजूदा डिप्लॉयमेंट को नए वर्शन और ब्यौरे के साथ अपडेट करता है:
clasp redeploy <deploymentId> <version> <description>
डिप्लॉयमेंट की सूची बनाएं
यह निर्देश, स्क्रिप्ट प्रोजेक्ट के डिप्लॉयमेंट आईडी, वर्शन, और उनकी जानकारी की सूची बनाता है.
clasp deployments
प्रोजेक्ट को Apps Script एडिटर में खोलें
इस निर्देश से Apps Script एडिटर में स्क्रिप्ट प्रोजेक्ट खुलता है. एडिटर को आपके डिफ़ॉल्ट वेब ब्राउज़र में एक नए टैब के तौर पर लॉन्च किया जाता है.
clasp open
clasp ओपन-सोर्स प्रोजेक्ट में योगदान दें
GitHub पर clasp में योगदान दें.