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 का इस्तेमाल जारी रखने के लिए, आपको clasp login का इस्तेमाल करके फिर से लॉग इन करना होगा. इससे Google के साथ फिर से पुष्टि की जा सकेगी.
clasp logout
नया Apps Script प्रोजेक्ट बनाना
इस कमांड से, मौजूदा डायरेक्ट्री में एक नई स्क्रिप्ट बनती है. इसमें स्क्रिप्ट का टाइटल देना ज़रूरी नहीं है.
clasp create [scriptTitle]
इस कमांड से, मौजूदा डायरेक्ट्री में दो फ़ाइलें भी बनती हैं:
- यह
.clasp.jsonफ़ाइल, स्क्रिप्ट आईडी सेव करती है. appsscript.jsonप्रोजेक्ट मेनिफ़ेस्ट फ़ाइल, जिसमें प्रोजेक्ट का मेटाडेटा होता है.
किसी मौजूदा प्रोजेक्ट का क्लोन बनाना
इस कमांड से, मौजूदा डायरेक्ट्री में किसी मौजूदा प्रोजेक्ट को क्लोन किया जाता है. स्क्रिप्ट को आपके Google खाते से बनाया या शेयर किया जाना चाहिए. आपको स्क्रिप्ट आईडी देकर, क्लोन करने के लिए स्क्रिप्ट प्रोजेक्ट तय करना होगा.
प्रोजेक्ट का स्क्रिप्ट आईडी ढूंढने के लिए, यह तरीका अपनाएं:
- Apps Script प्रोजेक्ट खोलें.
- बाईं ओर, प्रोजेक्ट सेटिंग पर क्लिक करें.
आईडी में जाकर, स्क्रिप्ट आईडी कॉपी करें.
clasp clone <scriptId>
स्क्रिप्ट प्रोजेक्ट डाउनलोड करना
इस कमांड से, Apps Script प्रोजेक्ट को Google Drive से आपके कंप्यूटर के फ़ाइल सिस्टम में डाउनलोड किया जाता है.
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 में योगदान दें.