हम Android संस्करणों के चिड़ियाघर के लिए एक वेब एप्लिकेशन तैयार कर रहे हैं

हाल ही में, और खुद के लिए काफी अप्रत्याशित रूप से, मैं एंड्रॉइड के लिए कार्यक्रम विकसित करने के लिए जिम्मेदार था। लेकिन मुझे एंड्रॉइड या जावा के तहत कुछ भी लिखना नहीं था। वेब एप्लिकेशन बनाना आवश्यक था, जैसे कि फोनगैप और अन्य, जो ब्राउज़र घटक में लगभग पूरी तरह से काम करता है। और यह सब २.२ - ४.३ (एसडीके) - १ 2.2) संस्करण के तहत है।

एंड्रॉइड ट्रिक्स के कुछ बिंदु से और उनके तहत बैसाखी उस व्यक्ति के दृष्टिकोण से जिसने पहली बार यह सब देखा, मैं बताना चाहूंगा। उम्मीद है कि यह हैलोवर्ल्ड के बिना निकला, “ओएमजी! जावा ”, आदि।

स्क्रीन रोटेशन / अभिविन्यास परिवर्तन
नेटवर्क पहुंच से बाहर है
हम स्थानीय संसाधनों को लोड करते हैं
जावा और जावास्क्रिप्ट के बीच का पुल


पूरा कार्यक्रम अनिवार्य रूप से एक वेबव्यू है, जिसमें स्थानीय संसाधन (संपत्ति) लोड किए गए हैं, और जावा में इसके लिए अतिरिक्त बाध्यकारी है। जेएस अपने आप से क्या नहीं कर सकता - जावा पर जावास्क्रिप्ट जावास्क्रिप्ट <=> पुल जेएस तुल्यकालिक / अतुल्यकालिक रूप से। बाद वाले को पृष्ठ पर "चुपचाप" अपहरण भी किया जा सकता है।

स्क्रीन रोटेशन

एंड्रॉइड में, डिवाइस ओरिएंटेशन में परिवर्तन गतिविधि (यूआई) के एक मनोरंजन में परिणाम करता है। WebView के लिए, यह वर्तमान पृष्ठ को पुनः लोड करता है। तदनुसार, इनपुट फ़ील्ड भरना, वर्तमान स्क्रॉल स्थिति, जेएस की स्थिति आदि खो जाती है।
इंटरनेट पर, प्रदर्शन की बदलती डिग्री और एसडीके के विभिन्न संस्करणों को ध्यान में रखते हुए इस स्थिति से निपटने के कई तरीके हैं। परिणामस्वरूप, एसडीके के सभी आवश्यक संस्करणों के लिए निम्नलिखित विकल्प काम कर रहा है:

हमें जिस गतिविधि की आवश्यकता है, उसके लिए, एंड्रॉइड में निर्दिष्ट करें: "स्क्रीनसाइज | ओरिएंटेशन" कॉन्फ़िगर करें। वे दोनों, अन्यथा एक संस्करण होगा जहां कुछ भी काम नहीं करेगा।
लेआउट में, हम WebView का वर्णन बिल्कुल नहीं करते हैं। हमारा ब्राउज़र कहाँ होगा, हम स्टब का वर्णन करते हैं:

<FrameLayout android:id="@+id/webViewPlaceholder" ... /> 

कोई ब्राउज़र नहीं - इससे कोई समस्या नहीं है :)

अब हमारी गतिविधि के वर्ग में:

 protected FrameLayout mWebViewPlaceholder; //    protected WebView mWebView; //  -    @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); initUI(); } protected void initUI() { mWebViewPlaceholder = ((FrameLayout)findViewById(R.id.webViewPlaceholder)); if (mWebView == null) { mWebView = new WebView(this); mWebView.loadUrl("file:///android_asset/index.html"); } mWebViewPlaceholder.addView(mWebView); } @Override public void onConfigurationChanged(Configuration newConfig) { if (mWebView != null) { mWebViewPlaceholder.removeView(mWebView); //     WebView  UI } super.onConfigurationChanged(newConfig); setContentView(R.layout.activity_main); initUI(); //  WebView   UI } @Override protected void onSaveInstanceState(Bundle outState) { super.onSaveInstanceState(outState); mWebView.saveState(outState); } @Override protected void onRestoreInstanceState(Bundle savedInstanceState) { super.onRestoreInstanceState(savedInstanceState); mWebView.restoreState(savedInstanceState); } 

परिणाम क्या है?
रोटेशन और रिज़ॉल्यूशन परिवर्तन की घटनाओं को संसाधित करते समय, UI से WebView को अस्थायी रूप से "बाहर निकालें"। उसी समय, हम स्वतंत्र रूप से WebView की स्थिति को सहेजते हैं और पुनर्स्थापित करते हैं, क्योंकि गतिविधि तब नष्ट हो जाती है जब आप सिस्टम / किसी अन्य प्रोग्राम की मुख्य स्क्रीन पर जाते हैं, या हमारे प्रोग्राम में अन्य गतिविधियों को खोलते हैं।
वैसे, यदि आपको पृष्ठ तत्वों (समान इनपुट) के मूल्यों को बचाने की आवश्यकता है, तो उन्हें एक आईडी सौंपा जाना चाहिए। अन्यथा इसे बचाया नहीं जाएगा।

नेटवर्क पहुंच से बाहर है

यदि आप अपने बाहरी सर्वर से WebView में एक पृष्ठ खोलते हैं, तो डिवाइस (एयर मोड, वाईफाई ऑफ ...) पर डिस्कनेक्ट किए गए नेटवर्क के साथ स्थिति बहुत मज़ेदार है। यह WebViewClient.onReceivedError और शपथ ग्रहण को पकड़ने लगता है। और यदि सब कुछ शांत है और WebViewClient.onPageFinished पर कॉल हुआ है, तो पृष्ठ हमारे साथ लोड हो गया है। यह पहले ठीक काम करता था, लेकिन 4.3 (sdk 18) onReceivedError को लोडिंग की शुरुआत के 2 मिनट बाद कहा जाता है। मैंने कौन-सी समय-सीमा सेटिंग की खोज करने और बदलने की कोशिश नहीं की ... onPageStarted काम करता है, और फिर सब कुछ, 2 मिनट के लिए मौन ...
समाधान? एक स्थानीय संसाधन खोलें, और इससे पहले से ही सर्वर से आवश्यक पंप करें।
अगर किसी को पता है कि मामला क्या है, तो टिप्पणियों में लिखें, शायद जब यह काम आए।

हम स्थानीय संसाधनों को लोड करते हैं

WebView में, नेटवर्क तक पहुंच के बिना, स्ट्रिंग लोडडेटा ("...") या स्थानीय संसाधन loadUrl ("फ़ाइल: /// ...") के पते को पास करके डेटा लोड किया जा सकता है। लोडडाटा के साथ पहला विकल्प अप्रत्याशित रूप से UTF-8 सिरिलिक वर्णमाला के साथ दिखाई दिया। इस तथ्य के बावजूद कि लोडडेटा एक स्ट्रिंग एन्कोडिंग को पैरामीटर में से एक के रूप में स्वीकार करता है, एंड्रॉइड में 4.1+ से (4.0 में, जहां तक ​​मुझे याद है, यह प्रकट नहीं हुआ), पृष्ठ को सिंगल-बाइट एन्कोडिंग में स्पष्ट रूप से प्रस्तुत किया गया है। और न तो मेटा charset = utf-8, और न ही webView.getSettings ()। SetDefaultTextEncodingName ("utf-8") ने स्थिति को ठीक नहीं किया।
समाधान? लोड से फ़ाइल लोड करके लोड करें।

जावा और जावास्क्रिप्ट के बीच का पुल

मानक ब्राउज़र घटक में एक पृष्ठ खोलने के लिए निश्चित रूप से केवल एक असंभव कार्य है । महत्वपूर्ण जावा के साथ जेएस कोड की बातचीत है, और दोनों पक्षों की पहल पर।
और एक और अधिक सुविधाजनक चीज प्रतीत होती है - AddJavascriptInterface (ऑफ डॉक्यूमेंटेशन से एक उदाहरण):

 class JsObject { @JavascriptInterface public String toString() { return "injectedObject"; } } webView.addJavascriptInterface(new JsObject(), "injectedObject"); webView.loadData("", "text/html", null); webView.loadUrl("javascript:alert(injectedObject.toString())"); 

हमने JS और उसके सभी के लिए "पुल" और उसका नाम निर्धारित किया है, हम इसका उपयोग करते हैं। पेज की सामग्री के बिना लोडडैटा को कॉल करना अजीब लग सकता है, लेकिन कम से कम कुछ लोड नहीं होने तक (आप एक खाली लाइन भी हो सकती है) जब तक इंटरेक्शन इंटरफ़ेस को आरंभीकृत नहीं किया जाता है (जेएस में इंजेक्शन नहीं बनाया गया है)।
जेएस से जावा में पैरामीटर पारित करना भी संभव है, संख्या और प्रकार के मापदंडों का मुख्य संयोग।
हम लिखते हैं, एमुलेटर और वास्तविक उपकरणों में चलते हैं: 4.3 - काम करता है, 4.2 - काम करता है, ... 2.3 - एप्लिकेशन क्रैश (ओएस स्टार्ट स्क्रीन पर क्रैश) ... रुको, क्या? ... 2.2 - काम करता है। फिर से 2.3 - पपड़ी के लिए।
जब इंजेक्शन इंजेक्ट किया जाता है तो दुर्घटना होती है। इंजेक्ट किया गया इंजेक्शन तक पहुँच शांत है।
बैकट्रेस में "callJNIMethod <>" की उपस्थिति निकट भविष्य में एक दिलचस्प अवकाश गतिविधि का वादा करती है ...
एसओ को गुग्लिंग और कॉम्बिंग करने से पता चलता है कि समस्या बड़ी है और पूरी लाइन 2.3 के लिए 100% के करीब संभावना के साथ होती है। * (Sdk 9 - 10)। यह कभी-कभी 2.2 (एसडीके 8) पर भी लगता है, लेकिन मैं केवल ऐसे संदेशों के एक जोड़े से मिला, और मेरे पास इस संस्करण पर एक वास्तविक उपकरण नहीं है, इसलिए मैं इसकी पुष्टि नहीं कर सकता। और एमुलेटर और रियल डिवाइस दोनों पर। मुख्य बात यह है कि वेबव्यू को जेएस इंजन के रूप में गैर-वी 8 इंजन का उपयोग करना चाहिए।
जनता की चीख और बग को ठीक करने के लिए Google से अनुरोध 2010 में शुरू हुआ, लेकिन उन्होंने एक आधिकारिक फिक्स जारी नहीं किया।

वर्षों से, समस्या के लिए कम से कम कुछ समाधान के लिए कई विकल्प उभरे हैं, विशेष रूप से 2.3 के तहत समाधान। *। विकल्पों पर विचार किए बिना, जब प्रोग्राम ने शाप दिया और प्रभावित संस्करणों के तहत काम करने से इनकार कर दिया, तो समाधानों को निम्नलिखित दृष्टिकोणों में विभाजित किया जा सकता है:

1. जावा के प्रत्यक्ष अनुरोधों के बजाय, हम प्रदर्शन करते हैं, आलंकारिक रूप से, निम्नलिखित:

  window.location = 'http://OurMegaPrefix:MethodName:Param0:Param1'; 

फिर जावा में हम इस तरह के अनुरोध को संसाधित करते हैं

 webView.setWebViewClient(new WebViewClient() { @Override public boolean shouldOverrideUrlLoading(WebView view, String url) { if (!url.startsWith("OurMegaPrefix")) { return false; } //  :  ,     ,   } //    : public void onPageFinished(WebView view, String url) { super.onPageFinished(view, url); if (javascriptInterfaceBroken) { String handleGingerbreadStupidity = "javascript:function openQuestion(id) { window.location='http://jshandler:openQuestion:'+id; }; " + "javascript: function handler() { this.openQuestion=openQuestion; }; " + "javascript: var jshandler = new handler();"; webView.loadUrl(handleGingerbreadStupidity); } } }); if (!javascriptInterfaceBroken) { webView.addJavascriptInterface(new JsObject(), "jshandler"); } 

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

2. एक अन्य विकल्प उपयोगकर्ता से एक तुल्यकालिक (जेएस के लिए) प्रतिक्रिया प्राप्त करने के लिए मानक जावास्क्रिप्ट इंटरफ़ेस का उपयोग करना है: प्रॉम्प्ट ()। मुख्य बात उसे पकड़ना है :)

 var res = prompt('OurMegaPrefix:meth:param0:param1'); 

Res में, किसी भी तरह आपको जावा से कॉल के परिणाम को बचाने की आवश्यकता है। और उपयोगकर्ता को कुछ भी नहीं दिखा रहा है।

 webView.setWebChromeClient(new WebChromeClient() { @Override public boolean onJsPrompt(WebView view, String url, String message, String defaultValue, JsPromptResult result) { final String prefix = JSAPI.class.getSimpleName(); if (!message.startsWith(prefix)) { return super.onJsPrompt(view, url, message, defaultValue, result); } //  return true; //   prompt   } }); 

यहां JSAPI प्रॉक्सी क्लास का नाम है (ऊपर इसे "JsObject" कहा गया था)।
एक तरह से या किसी अन्य विधि नाम और पैरामीटर (यदि कोई हो) प्राप्त करने के बाद, यह JSAPI से संबंधित विधि को कॉल करने के लिए बनी हुई है।

 var jsapi = new JSAPI(); 

लेख जावा में प्रतिबिंब के बारे में नहीं है, इसलिए इसे संक्षेप में इस तरह से करें:

 Method method = JSAPI.class.getMethod(methodName, new Class[] {String.class}); 

एक स्ट्रिंग पैरामीटर के साथ एक विधि को कॉल करने के लिए।
या तो बस नाम से खोज करने के लिए:

 Method method = null; for (Method meth : JSAPI.class.getMethods()) { if (meth.getName().equals(methodName)) { method = meth; break; } } 

फिर हम पाया विधि कहते हैं (फिर, एक पैरामीटर के लिए एक उदाहरण):

 method.invoke(jsapi, parameter); 

सामान्य स्थिति में, यह ऐडजैवस्क्रिप्ट इन्टरफेस को दरकिनार कर बातचीत के लिए पहले से ही पर्याप्त है। लेकिन मैं इस पूरे मामले पर अपना रैपर पेश करूंगा।
मैं खुद बैकएंड (php, python, bash, C, इत्यादि) हूं और मेरा JS इतना कूल नहीं है कि शर्मनाक न हो। मैं कोड में सुधार के लिए सुझाव स्वीकार करूंगा :)

तार से अधिक जटिल वस्तुओं को पास करने के लिए, json का उपयोग करें:

• JSON.stringify और JSON.parse के माध्यम से js की तरफ;
• JSONObject और JSONArray के माध्यम से जावा की तरफ।

और DOMContentLoaded द्वारा:

 if (typeof JSAPI == 'object') { return; } (function(){ var JSAPI = function() { function bridge(func) { var args = Array.prototype.slice.call(arguments.callee.caller.arguments, 0); var res = prompt('JSAPI.'+func, JSON.stringify(args)); try { res = JSON.parse(res); res = (res && res.result) ? res.result : null; } catch (e) { res = null; } return res; } this.getUserAccounts = function() { //    return bridge('getUserAccounts'); } }; window['JSAPI'] = new JSAPI(); })(window); 

यदि JSAPI घोषित नहीं किया गया है (addJavascriptInterface को नहीं बुलाया गया था) - मैं एक आवरण बनाता हूं।
आवरण का सार - हम संकेत देने के लिए एक कॉल बनाते हैं ('JSAPI.getUserAccounts', '[]'), जहाँ दूसरा पैरामीटर कॉल पैरामीटर का json सरणी है।
और प्रॉम्प्ट के परिणाम को {परिणाम: ANSWER} हमें वापस करना चाहिए।

अब, एंड्रॉइड एसडीके के संस्करण की परवाह किए बिना, हम अपनी विधि कहते हैं:

 var res = JSAPI.getUserAccounts(); //       json   : console.log(JSON.parse(res)[0]); 

जावा पक्ष में:

 webView.setWebChromeClient(new WebChromeClient() { @Override public boolean onJsPrompt(WebView view, String url, String message, String defaultValue, JsPromptResult result) { //     prompt(message='JSAPI.method', defaultValue='params') final String prefix = JSAPI.class.getSimpleName() + "."; if (!message.startsWith(prefix)) { return super.onJsPrompt(view, url, message, defaultValue, result); } final String meth_name = message.substring(prefix.length()); String json_result = null; try { //    json  final JSONArray params = new JSONArray(defaultValue); final int len = params.length(); final Object []paramValues = new Object[len]; for (int i = 0; i < len; ++i) { paramValues[i] = params.opt(i); } //  ,      Method method = null; for (Method meth : JSAPI.class.getMethods()) { if (meth.getName().equals(meth_name)) { method = meth; break; } } if (null == method) { throw new NoSuchMethodException(); } //      "{\"result\":}" final JSONObject res = new JSONObject(); res.put("result", method.invoke(new JSAPI(), paramValues)); json_result = res.toString(); } catch (JSONException e) { // ... } catch (NoSuchMethodException e) { // ... } catch (InvocationTargetException e) { // ... } catch (IllegalAccessException e) { // ... } result.confirm(json_result); return true; } }); 

और सीधे उदाहरण की अखंडता के लिए स्वयं विधि:

 class JSAPI { @JavascriptInterface public String getUserAccounts() { final JSONArray json = new JSONArray(); final String emailPattern = Patterns.EMAIL_ADDRESS.pattern(); final AccountManager am = AccountManager.get(getApplicationContext()); if (am != null) { for (Account ac : am.getAccounts()) { if (!ac.name.matches(emailPattern)) { continue; } final JSONArray item = new JSONArray(); item.put(ac.type); item.put(ac.name); json.put(item); } } return json.toString(); } } 

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

निष्कर्ष के रूप में, मैं यह भी कहना चाहता हूं कि अक्सर "टूटे हुए एंड्रॉइड" के रूप में बिल्ड कोड की जाँच होती थी। VERSION.RELEASE == "2.3"। खराब जाँच, बिल्ड के माध्यम से बेहतर। VERSION.RELEASE.startsWith ("2.3")। बेहतर अभी तक, IMHO, सीधे एसडीके संस्करण की जाँच करें: (Build.VERSION.SDK_INT == 9) || (Build.VERSION.SDK_INT == 10)।

जो लोग जेएस असेंबली (वी 8 पर, मैं दोहराता हूं, बग नहीं खेलता) की जांच करना चाहता हूं मैं चलने का सुझाव देता हूं, वहां सब कुछ सरल है।


शुरुआत के लिए, जावा द्वारा शुरू किया गया एक कॉल: जब जरूरत हो, या कॉलबैक के रूप में।

 public void callJS(final String jsCode) { runOnUiThread(new Runnable() { @Override public void run() { webView.loadUrl("javascript:" + jsCode); } }); } jsapi.callJS("alert('Hello, Habr!');"); 

RunJUiThread की आवश्यकता होती है यदि कॉलज गैर-यूआई थ्रेड पर कॉल किया जाता है (लगभग निश्चित रूप से यह होगा)।
लेकिन :) 2.2 में, इसने मेरे बिना काम किया। पुराने संस्करणों में, सही अधिक तार्किक हो गया।

यह मेरा पहला जावा एप्लीकेशन कैसे लिखा गया है :) मुझे आशा है कि किसी को दिलचस्पी थी या अचानक, यहां तक ​​कि उपयोगी भी।

पीएस एंड्रॉइड स्टूडियो हाल ही में 0.2.11 तक बढ़ गया है, और यदि आप JetBrains उत्पादों को पसंद करते हैं, तो इसका उपयोग करना पहले से ही संभव है। अप्रिय दोषों के बिना नहीं, लेकिन काफी कार्यात्मक।

PPS प्राप्त टिप्पणियों के आधार पर कोड उदाहरणों में कुछ बदलाव किए गए थे।