प्रोजेक्ट स्ट्रक्चर, लाइफ़साइकल, और बंडलिंग

मिनी ऐप्लिकेशन का प्रोजेक्ट स्ट्रक्चर

जैसा कि पहले मार्कअप भाषाओं, स्टाइलिंग भाषाओं, और कॉम्पोनेंट के साथ होता है, मिनी ऐप्लिकेशन प्रोजेक्ट के स्ट्रक्चर के साथ भी, फ़ाइल एक्सटेंशन या डिफ़ॉल्ट नाम जैसी जानकारी अलग-अलग होती है. हालांकि, सुपर ऐप्लिकेशन की सेवा देने वाली सभी कंपनियों के लिए सब कुछ एक जैसा ही होता है. प्रोजेक्ट में हमेशा ये चीज़ें शामिल होती हैं:

  • रूट फ़ाइल app.js, जो मिनी ऐप्लिकेशन को शुरू करती है.
  • कॉन्फ़िगरेशन फ़ाइल app.json, जो आम तौर पर किसी वेब ऐप्लिकेशन मेनिफ़ेस्ट से मेल खाती है.
  • शेयर की गई डिफ़ॉल्ट शैलियों वाली एक सामान्य स्टाइल शीट फ़ाइल app.css.
  • project.config.json फ़ाइल, जिसमें बिल्ड की जानकारी होती है.

सभी पेज एक pages फ़ोल्डर में अलग-अलग सब-फ़ोल्डर में सेव किए जाते हैं. हर पेज सब-फ़ोल्डर में एक सीएसएस फ़ाइल, एक JS फ़ाइल, एक एचटीएमएल फ़ाइल, और एक वैकल्पिक कॉन्फ़िगरेशन JSON फ़ाइल होती है. फ़ाइल एक्सटेंशन के अलावा, सभी फ़ाइलों के नाम उनके शामिल फ़ोल्डर के नाम से होने चाहिए. इस तरह, मिनी ऐप्लिकेशन को app.json फ़ाइल (मेनिफ़ेस्ट जैसी फ़ाइल) में मौजूद डायरेक्ट्री के लिए सिर्फ़ एक पॉइंटर की ज़रूरत होती है. साथ ही, वह सभी सबरिसॉर्स को डाइनैमिक तौर पर ढूंढ सकता है. वेब डेवलपर के हिसाब से, मिनी ऐप्लिकेशन कई पेज वाले ऐप्लिकेशन होते हैं.

├── app.js               # Initialization logic
├── app.json             # Common configuration
├── app.css              # Common style sheet
├── project.config.json  # Project configuration
└── pages                # List of pages
   ├── index               # Home page
   │   ├── index.css         # Page style sheet
   │   ├── index.js          # Page logic
   │   ├── index.json        # Page configuration
   │   └── index.html        # Page markup
   └── other               # Other page
       ├── other.css         # Page style sheet
       ├── other.js          # Page logic
       ├── other.json        # Page configuration
       └── other.html        # Page markup

मिनी ऐप्लिकेशन का लाइफ़साइकल

दुनिया भर में तय किए गए App() तरीके को कॉल करके, मिनी ऐप्लिकेशन को सुपर ऐप्लिकेशन के साथ रजिस्टर करना ज़रूरी है. पहले बताए गए प्रोजेक्ट स्ट्रक्चर पर गौर करने पर, ऐसा app.js में होता है. मिनी ऐप्लिकेशन की लाइफ़साइकल में चार इवेंट होते हैं: launch, show, hide, और error. इन इवेंट के हैंडलर को App() तरीके में, कॉन्फ़िगरेशन ऑब्जेक्ट के तौर पर पास किया जा सकता है. इसमें एक globalData प्रॉपर्टी भी हो सकती है, जिसमें ऐसा डेटा होता है जो दुनिया भर में सभी पेजों पर उपलब्ध होना चाहिए.

/* app.js */
App({
  onLaunch(options) {
    // Do something when the app is launched initially.
  },
  onShow(options) {
    // Do something when the app is shown.
  },
  onHide() {
    // Do something when the app is hidden.
  },
  onError(msg) {
    console.log(msg);
  },
  globalData: "I am global data",
});

हमेशा की तरह, हर जानकारी अलग-अलग होती है, लेकिन WeChat, Alipay, Baidu, ByteDance, और Quick App के लिए भी इसका सिद्धांत एक ही है.

पेज का लाइफ़साइकल

ऐप्लिकेशन लाइफ़साइकल की तरह ही, पेज लाइफ़साइकल में भी लाइफ़साइकल इवेंट होते हैं, जिन्हें डेवलपर सुन सकता है और उस पर प्रतिक्रिया दे सकता है. ये मुख्य इवेंट load, show, ready, hide, और unload हैं. कुछ प्लैटफ़ॉर्म, pulldownrefresh जैसे दूसरे इवेंट भी ऑफ़र करते हैं. इवेंट हैंडलर सेट अप करने की प्रोसेस हर पेज के लिए तय किए गए Page() वाले तरीके में होती है. प्रोजेक्ट स्ट्रक्चर से पहले के index या other पेजों के लिए, ऐसा index.js या other.js में होगा.

/* index.js */
Page({
  data: {
    text: "This is page data.",
  },
  onLoad: function (options) {
    // Do something when the page is initially loaded.
  },
  onShow: function () {
    // Do something when the page is shown.
  },
  onReady: function () {
    // Do something when the page is ready.
  },
  onHide: function () {
    // Do something when the page is hidden.
  },
  onUnload: function () {
    // Do something when the page is closed.
  },
  onPullDownRefresh: function () {
    // Do something when the user pulls down to refresh.
  },
  onReachBottom: function () {
    // Do something when the user scrolls to the bottom.
  },
  onShareAppMessage: function () {
    // Do something when the user shares the page.
  },
  onPageScroll: function () {
    // Do something when the user scrolls the page.
  },
  onResize: function () {
    // Do something when the user resizes the page.
  },
  onTabItemTap(item) {
    // Do something when the user taps the page's tab.
  },
  customData: {
    foo: "bar",
  },
});

बिल्ड प्रोसेस

मिनी ऐप्लिकेशन बनाने की प्रोसेस को डेवलपर तक सीमित नहीं किया जाता. हुड में, यह ट्रांसपिलेशन और काट-छांट करने के लिए Babel कंपाइलर जैसे इंडस्ट्री के टूल और postcss सीएसएस ट्रांसफ़ॉर्मर का इस्तेमाल कर रहा है. बिल्ड प्रोसेस करने का अनुभव, Next.js या create-react-app से मिलता-जुलता है. अगर डेवलपर साफ़ तौर पर ऐसा नहीं करते हैं, तो वे कभी बिल्ड पैरामीटर को नहीं छूते. प्रोसेस होने के बाद, प्रोसेस होने वाली फ़ाइलें एक या कई (सब)पैकेज में रखी जाती हैं. साथ ही, इन्हें साइन, एन्क्रिप्ट (सुरक्षित), और पैकेज किया जाता है. इसके बाद, ये सुपर ऐप्लिकेशन की सेवा देने वाली कंपनियों के सर्वर पर अपलोड हो जाती हैं. सबपैकेज, लेज़ी लोडिंग के लिए होते हैं. इसलिए, मिनी ऐप्लिकेशन को एक बार में डाउनलोड करने की ज़रूरत नहीं है. पैकेजिंग की जानकारी निजी होती है और इसे दर्ज नहीं किया जाता है. हालांकि, WeChat के wxapkg फ़ॉर्मैट जैसे कुछ पैकेज फ़ॉर्मैट को बदला, इस्तेमाल किया जा सकता है.

स्वीकार हैं

इस लेख की समीक्षा जो मेडली, कायस बास्क्स, मिलिका मिहाजलिया, ऐलन केंट, और कीथ गू ने की है.