सी ++ के लिए एज़ोमियम

Awesomium आपके आवेदन में क्रोमियम-आधारित ब्राउज़र को एकीकृत करने के लिए एक पुस्तकालय है। Awesomium का पूरा आकर्षण यह है कि इसे लगभग किसी भी प्रकार के अनुप्रयोग में एकीकृत किया जा सकता है (Unity3D पर आधारित 3D गेम में एकीकरण के उदाहरण हैं), इसमें डेवलपर के लिए कई प्रकार की विशेषताएं हैं और, स्पष्ट रूप से, इसके साथ काम करना अच्छा है।

लेकिन, दुर्भाग्य से, पुस्तकालय में मामूली दस्तावेज हैं, व्यावहारिक रूप से कोई उदाहरण और समुदाय नहीं हैं (यह सी ++ के तहत विकास पर लागू होता है, सहयोगी अधिक भाग्यशाली हैं)। मुझे कुछ पलों को अलग-अलग स्रोतों से थोड़ा-थोड़ा करके इकट्ठा करना था, जबकि दूसरों को परीक्षण और त्रुटि की एक श्रृंखला के बाद समझ में आया।

और कुछ ज्ञान अर्जित करने के बाद, मैंने उन्हें साझा करने का फैसला किया। मुझे यकीन है कि मैं पहला नहीं हूं और आखिरी नहीं हूं जो इस तरह से जाएगा।

मैं आपको तुरंत चेतावनी देना चाहता हूं: शायद कुछ जगहों पर मुझे गलत समझा गया या गलत समझा गया, आपको कड़ाई से न्याय नहीं करना चाहिए, बस सही रास्ते पर आना चाहिए, मैं बहुत आभारी रहूंगा।

खिड़की और खिड़की रहित Awesomium

सबसे पहले, यह कहने योग्य है कि Awesomium का उपयोग करने वाले 2 प्रकार के अनुप्रयोग हैं:

• ऑफ़स्क्रीन - ब्राउज़र विंडो प्रदर्शित किए बिना (पृष्ठ पर लिपियों का सभी प्रतिपादन और कार्य पृष्ठभूमि में होता है और उपयोगकर्ता को प्रदर्शित नहीं होता है) या ब्राउज़र के प्रदर्शन के साथ, लेकिन प्रोग्रामर संदेशों को प्रस्तुत करने और संसाधित करने में लगा हुआ है
• खिड़की वाली - एज़ोसमियम कुछ खिड़की से "चिपक जाती है" और उस पर प्रदर्शित होती है। लाइब्रेरी के माध्यम से माउस और कीबोर्ड संदेशों का आरेखण, प्रसंस्करण किया जाता है

पहला यह दिलचस्प है कि यह आपको एक विंडो के बिना ब्राउज़र के साथ काम करने की अनुमति देता है। तुम भी एक सांत्वना आवेदन के साथ काम कर सकते हैं, उदाहरण के लिए, पृष्ठों के स्क्रीनशॉट बनाने के लिए। हम इस प्रकार पर ध्यान नहीं देंगे, क्योंकि इसके अच्छे उदाहरण हैं और मैंने वास्तव में इसके साथ काम नहीं किया। मुझे दूसरी विधा में दिलचस्पी थी - विंडोेड।

विंडोेड एवज़ोमियम का उपयोग तब किया जाता है जब आपको विंडो वाले एप्लिकेशन में एक पूर्ण ब्राउज़र की आवश्यकता होती है। इस मामले में, लाइब्रेरी मुख्य बात का ध्यान रखेगी - उपयोगकर्ता इंटरैक्शन। लेकिन यह न सोचें कि कार्यक्रम में कुछ पंक्तियों को जोड़ने से आपको पूर्ण ब्राउज़र मिलेगा, ऐसा नहीं है। कार्य का शेर का हिस्सा प्रोग्रामर के कंधों पर है, उदाहरण के लिए: फ़ाइल अपलोड / अपलोड संवाद (हाँ, मूल रूप से सभी संवाद), पॉप-अप मेनू, ड्रॉप-डाउन सूची, नए टैब बनाना, आदि।

पुस्तकालय की संरचना

पुस्तकालय की संरचना बहुत सरल है (हालांकि पहले यह बिल्कुल स्पष्ट नहीं था):

ब्राउज़र का मूल कोर ( वेबकोर ) है। प्रत्येक एप्लिकेशन में केवल एक कोर हो सकता है, और यह बदले में कुछ प्रतिबंध लगाता है। उदाहरण के लिए, यदि आप चाहते हैं कि कुछ टैब अन्य उपयोगकर्ता एजेंटों से रद्द हो, तो आप सफल नहीं होंगे, क्योंकि उपयोगकर्ता एजेंट का मूल्य कर्नेल सेटिंग्स में संग्रहीत होता है।

पदानुक्रम में अगला है WebView - यह एक ब्राउज़र विंडो है। प्रत्येक WebView बनाते समय, एक अलग क्रोमियम प्रक्रिया शुरू की जाती है। जब आपको WebView की आवश्यकता नहीं होती है, तो इसे साफ करना न भूलें, अन्यथा जब तक हम WebCore को नष्ट नहीं करते, तब तक यह प्रक्रिया लटकाएगी।

प्रत्येक WebView एक सत्र ( WebSession ) का उपयोग कर सकता है। एक सत्र उपयोगकर्ता डेटा (कुकीज़, कैश, प्रमाण पत्र, स्थानीय डेटाबेस, आदि) है। एक WebSession विभिन्न WebViews से जुड़ सकता है। WebSession महत्वपूर्ण ब्राउज़र सेटिंग्स (जो इस सत्र का उपयोग करते हैं) को भी संग्रहीत करता है, उदाहरण के लिए, प्रॉक्सी।

खैर, आखिरी (जो मुझे काम करना था) श्रोता हैं - ब्राउज़र के साथ बातचीत करने के लिए इंटरफेस। कई श्रोता हैं, और उनमें से प्रत्येक कुछ समस्याओं को हल करता है। उदाहरण के लिए, WebViewListener :: Dialog में डायलॉग बॉक्स के साथ काम करने के तरीके शामिल हैं, और WebViewListener :: डाउनलोड में फ़ाइल डाउनलोड की प्रगति के बारे में सूचित करने के तरीके हैं।

जन्म

सिद्धांत खत्म हो गया है, चलिए अभ्यास करते हैं। सबसे पहले, विंडो मोड में कर्नेल और ब्राउज़र टैब बनाने और शुरू करने की प्रक्रिया पर विचार करें।

सबसे पहले, आपको कर्नेल को इनिशियलाइज़ करने की आवश्यकता है:

WebCore* core = 0; WebConfig config; core = WebCore::Initialize(config); 

अगला, एक सत्र बनाएं (और उदाहरण के लिए, सत्र सेटिंग्स में, हम उपयोग किए गए प्रॉक्सी का उपयोग करते हैं)

 WebPreferences prefs; prefs.proxy_config = WSLit("198.1.99.26:3128"); WebSession * session = core->CreateWebSession(WSLit(""), prefs); 

और हां, WebView ऑब्जेक्ट बनाएं।

 WebView* view = core->CreateWebView(WIN_WIDTH, WIN_HEIGHT, session, kWebViewType_Window); view->set_parent_window(hwnd); 

अंतिम चरण में हम और अधिक विस्तार से लिखते हैं:

• सबसे पहले, यह ध्यान देने योग्य है कि आपको ब्राउज़र विंडो की प्रारंभिक चौड़ाई और ऊंचाई निर्दिष्ट करनी होगी। आप उन्हें बाद में बदल सकते हैं (उदाहरण के लिए, मूल विंडो का आकार बदलते समय)
• तीसरा पैरामीटर सत्र है। टैब के काम के दौरान सत्र को नहीं बदला जा सकता है, लेकिन इसकी पहुंच बनी हुई है, इसलिए सैद्धांतिक रूप से (मैंने जांच नहीं की) आप सेटिंग्स बदल सकते हैं और वे प्रभावी होंगे
• ब्राउज़र टैब निर्माण विधि का अंतिम पैरामीटर WebViewType है। यह या तो kWebViewType_Offscreen (default) या kWebViewType_Window हो सकता है। हम दूसरा निर्दिष्ट करते हैं, जैसा कि हम एक ओकेनी ब्राउज़र बनाते हैं
• KWebViewType_Window प्रकार के साथ एक WebView बनाने के बाद एक अनिवार्य कदम मूल विंडो के हैंडल को निर्दिष्ट करना है। हैंडल में उसी प्रक्रिया की खिड़कियां नहीं होती हैं जिसमें एज़ोमियम का उपयोग किया जाता है, उदाहरण के लिए, मेरे पास डेल्फी कार्यक्रम में एक हैंडल पैनल है और सब कुछ ठीक काम करता है

जीवन

उस उद्देश्य के आधार पर जिसके लिए Awesomium का उपयोग किया जाता है, उसके "जीवन" में काफी अंतर हो सकता है। मैं सिर्फ मुख्य बिंदुओं पर ध्यान केंद्रित करूंगा जब विंडो प्रकार के टैब के साथ काम करना होगा।

सबसे पहले, इस तथ्य के बावजूद कि विंडोेड एज़ोमियम आंशिक रूप से अपना जीवन जीता है, इसे अभी भी समय-समय पर काम करने के लिए प्रोत्साहित करने की आवश्यकता है। पुश अपडेट कर्नेल विधि द्वारा किया जाता है। इसे टाइमर में कॉल करने की अनुशंसा की जाती है, उदाहरण के लिए:

 // Create our WebCore Update timer, renders at a max of 66 FPS UINT myTimer = SetTimer ( hwnd, 0, 15, NULL ); ... case WM_TIMER: { if (core) { core->Update(); } } ... 

यह भी अनुशंसा की जाती है कि WebView के विनाश के बाद कर्नेल अपडेट किया जाए।

दूसरे, यदि आप चाहते हैं कि ब्राउज़र विंडो मूल विंडो के साथ-साथ आकार बदल जाए, तो आपको मूल विंडो के WM_SIZE संदेश को संसाधित करना होगा और ब्राउज़र को नए आयामों की रिपोर्ट करनी होगी। यह काफी सरलता से किया जाता है:

 case WM_SIZE: { if (view) { int nWidth = LOWORD(lParam); //    int nHeight = HIWORD(lParam); //    view->Resize(nWidth, nHeight); } } 

और तीसरा, ब्राउज़र को पूरी तरह से काम करने के लिए, आपको श्रोताओं के इंटरफेस को लागू करने और उन्हें प्रत्येक WebView से कनेक्ट करने की आवश्यकता है। इंटरफेस के कार्यान्वयन के साथ कोई समस्या नहीं होनी चाहिए, वे अच्छी तरह से प्रलेखित हैं। सभी आवश्यक संकेत WebViewListener.h फ़ाइल में देखे जा सकते हैं। ठीक है, उन्हें जोड़ना बिल्कुल मुश्किल नहीं है:

 DialogListener * dialog_lis = new DialogListener(); view->set_dialog_listener(dialog_lis); 

जैसा कि मैंने पहले कहा, विंडो मोड में काम करते समय, लाइब्रेरी इस बारे में बहुत चिंता करेगी: पेरेंट विंडो पर लोड किए गए पेज को रेंडर करना, कीबोर्ड और माउस के कीस्ट्रोक को हैंडल करना, माउस कर्सर को बदलना, आदि।

खैर, इस अध्याय के अंत में एक पेज खोलने और लोड होने की प्रतीक्षा करने का एक छोटा सा उदाहरण है:

 //   view->LoadURL(WebURL(WSLit("http://google.com/"))); //    while(view->IsLoading()) { Sleep(50); core->Update(); } //   (     ) view->Focus(); 

मौत

काम के बाद सफाई के साथ, सबसे बड़ी समस्याएं पैदा हुईं। इस विषय पर आधिकारिक दस्तावेज और Google में Windowed मोड में काम करने की जानकारी शून्य से थोड़ी अधिक है। परीक्षण और त्रुटि से, मैं निम्नलिखित आया:

1. WebView को नष्ट करने से पहले - पहले आपको मूल विंडो को नष्ट करने की आवश्यकता है (रिवर्स ऑर्डर से एप्लिकेशन क्रैश हो जाएगा)।

2. यदि आप चाहते हैं कि सत्र डेटा सहेजा जाए (यदि यह एक ज्ञापन सत्र नहीं है), तो आपको सत्र उदाहरण पर रिलीज़ विधि को कॉल करने की आवश्यकता है।

3. WebView विध्वंस विधि (और कुछ नहीं) को कॉल करके नष्ट कर दिया जाता है

4. कर्नेल को शटडाउन विधि को कॉल करके नष्ट कर दिया जाता है, जो वैसे भी गलत तरीके से नष्ट किए गए WebView को साफ कर सकता है (लेकिन इस प्रक्रिया को वैसे भी नियंत्रित करना बेहतर है)

मोटे तौर पर, यह इस तरह दिखता है:

 // -     ... //    (     ,      ,    ) view->Stop(); //      view->session()->Release(); //  WebView (    Chromium       ) view->Destroy(); //   (      ,      ) core->Update(); //   core->Shutdown(); 

कार्यक्रम समाप्त होने से पहले ही कर्नेल को नष्ट करना आवश्यक है। यदि आपको केवल एक ब्राउज़र टैब बंद करने की आवश्यकता है, तो आपको केवल इसे हटाने की आवश्यकता है और वेब टैब जो इस टैब पर था।

उपयोगी लिंक

Awesomium का अध्ययन करते समय, हेडर फ़ाइलों में टिप्पणियां, जो \ Awesomium SDK \ 1.7.1.0 \ में स्थित हैं, में \ Awesomium \ फ़ोल्डर और निम्न इंटरनेट पेज शामिल हैं, इससे मुझे बहुत मदद मिली:

- wiki.awesomium.com/general-use - आवेसोमियम के रचनाकारों से मामूली उपयोग के मामले। इस लाइब्रेरी का उपयोग करके प्रोजेक्ट कैसे बनाया जाए और एप्लिकेशन को काम करने के लिए किन फ़ाइलों की आवश्यकता है, इसका भी वर्णन है

- awesomium.com/docs/1_7_0/cpp_api/index.html#intro_sec - आधिकारिक दस्तावेज़ीकरण (अनिवार्य रूप से शामिल हेडर फ़ाइलों में टिप्पणियों की नकल करता है)

- gist.github.com/khrona - गिटहब पर उपयोगकर्ता ख्रोएन का विकास। पहला टेस्ट एप्लिकेशन बनाने में उन्होंने मेरी बहुत मदद की, विशेष रूप से इस उदाहरण में GDI / WinForms / WinAPI के साथ Awesomium r148 API का उपयोग करने का उदाहरण । सच है, वह इसे ऑफ़स्क्रीन मोड में एक विंडो मोड की तरह बनाने की कोशिश कर रहा है, जिसके कारण इसमें स्कैन की कार्यक्षमता है (उदाहरण के लिए, स्क्रॉल काम नहीं करता है और माउस कर्सर तब नहीं बदलता है जब आप लिंक पर हॉवर करते हैं), साथ ही साथ बहुत अधिक अतिरेक भी।

- answer.awesomium.com/index.html - उपयोगकर्ता के सवालों के जवाब। दुर्भाग्य से, सभी प्रश्नों के उत्तर नहीं मिलते हैं, इसलिए वहां बहुत उपयोगी जानकारी नहीं है, लेकिन है