عرض مصدر Cordova/webview android

<noinclude>{{DISPLAYTITLE:عوارض أندرويد في كوردوفا}}</noinclude>
[[تصنيف: Cordova]]
يوضح هذا الدليل كيفية تضمين مُكوّن (component) [[Cordova/webviews|عارض]] كوردوفا داخل تطبيقات أندرويد الكبيرة. لمزيد من التفاصيل حول كيفية جعل هذه المكونات تتواصل مع بعضها، راجع [[Cordova/plugins|دليل تطوير الإضافات]].

إذا لم تكن لديك خبرة بمنصة أندرويد، فعليك الاطلاع أولًا على [[Cordova/platforms android|دليل التطوير على منصة أندرويد]]، وتثبيت أحدث إصدارٍ من إطار العمل SDK الخاص بأندرويد قبل محاولة اعتماد الطرق الواردة في هذا الدليل لتضمين [[Cordova/webviews|العوارض]]. بدءًا من الإصدار 1.9 من كوردوفا، أصبحت منصة أندرويد تعتمد على المُكوِّن <code>CordovaWebView</code>، والذي بُنِي على المُكوِّن القديم <code>CordovaActivity</code> الذي كان معمولًا به قبل الإصدار 1.9. 
* لاتباع هذه التعليمات، تأكد من أنّ لديك أحدث توزيعة من كوردوفا. نزِّلها من الموقع [http://cordova.apache.org cordova.apache.org]، وفُكَّ ضغط حزمة أندرويد الموجودة فيها. 
* انتقل إلى مجلد حزمة أندرويد ‎<code>/framework</code>، ونفِّذ الأمرَ <code>ant jar</code>. والذي سيُنشئ الملف ‎<code>.jar</code> الخاص بكوروفا على النحو التالي ‎<code>/framework/cordova-x.x.x.jar</code>. 
* انسخ الملف ‎<code>.jar</code> إلى مجلد مشروع أندرويد ‎ <code>/libs</code> . 
* أضف المُدخلات التالية إلى الملف ‎<code>/res/xml/main.xml</code> مع تعديل <code>layout_height</code> و <code>layout_width</code> و <code>id</code> لتتناسب مع خصوصيات التطبيق: 
<syntaxhighlight lang="xml"><org.apache.cordova.CordovaWebView
    android:id="@+id/tutorialView"
    android:layout_width="match_parent"
    android:layout_height="match_parent" /></syntaxhighlight>
* قم بتعديل النشاط لكي ينفذ (implements) ‏<code>CordovaInterface</code> مع تنفيذ التوابع المُتضمّنة. قد ترغب في نسخها من ‎<code>/framework/src/org/apache/cordova/CordovaActivity.java</code>، أو يمكنك تنفيذها على النحو الذي تشاء. تعرض الشيفرة البرمجية التالية تطبيقًا بسيطًا يعتمد على الواجهة المُقدمة. لاحظ كيف يتطابق مُعرِّف [[Cordova/webviews|العارض]] المشار إليه مع الخاصية <code>id</code> المحددة في ملف XML الموضح أعلاه: 
<syntaxhighlight lang="javascript">public class CordovaViewTestActivity extends Activity implements CordovaInterface {
    CordovaWebView cwv;
    /* يُستدعى عند إنشاء النشاط لأول مرة */
    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.main);
        cwv = (CordovaWebView) findViewById(R.id.tutorialView);
        Config.init(this);
        cwv.loadUrl(Config.getStartUrl());
    }‎</syntaxhighlight> 
* إذا كان التطبيق يحتاج إلى استخدام الكاميرا، فعليك تنفيذ ما يلي: 
<syntaxhighlight lang="javascript">@Override
public void setActivityResultCallback(CordovaPlugin plugin) {
    this.activityResultCallback = plugin;
}
/**
 * ،أطلق نشاطا تريد الحصول منه على نتيجة بعد انتهائه. بعد انتهاء النشاط
 * onActivityResult() سيُستدعى التابع
 *
 * @param command           The command object (كائن الأمر)
 * @param intent            The intent to start (المقصد المُراد بدؤه)
 * @param requestCode       كود الطلبية الذي سيُمرّر إلى رد النداء لتحديد النشاط
 */
public void startActivityForResult(CordovaPlugin command, Intent intent, int requestCode) {
    this.activityResultCallback = command;
    this.activityResultKeepRunning = this.keepRunning;
    // عند تمكين تعدد المهام، فقم بتعطيله لأجل النشاطات التي تُعيد نتيجة
    if (command != null) {
        this.keepRunning = false;
    }
    // بدء النشاط
    super.startActivityForResult(intent, requestCode);
}
@Override
/**
 * الذي أطلقته به requestCode  يُستدعى عند انتهاء نشاطٍ أطلقته، مع إعطائك 
 * مع أي بيانات إضافية resultCode يُعيد
 * 
 * @param requestCode       startActivityForResult() كود الطلبية المُرسل أصلا إلى
 *                          ما يتيح لك تحديد مصدر هذه النتيجة
 * @param resultCode        العدد الصحيح الذي يمثل الكود المُعاد من قبل النشاط 
 *                          setResult() الفرعي عبر  
 * @param data              مقصدٌ يمكن أن يعيد بيانات النتيجة إلى المُستدعي، حيث  يمكن 
 *                          extras ربط عدة بيانات بالمقصد
 */ 
protected void onActivityResult(int requestCode, int resultCode, Intent intent) {
    super.onActivityResult(requestCode, resultCode, intent);
    CordovaPlugin callback = this.activityResultCallback;
    if (callback != null) {
        callback.onActivityResult(requestCode, resultCode, intent);
    }
}‎</syntaxhighlight> 
* أخيرًا، تذكر إضافة مُجمِّع المهام الفرعية (thread pool)، وإلا فلن تكون هناك أية مهام فرعية لتعمل عليها الإضافة: 
<syntaxhighlight lang="javascript">@Override
public ExecutorService getThreadPool() {
    return threadPool;
}‎</syntaxhighlight> 
* انسخ ملفات [[HTML]] و [[JavaScript]] الخاصة بالتطبيق إلى مجلد مشروع أندرويد ‎<code>/assets/www</code>. 
* انسخ الملف <code>[[Cordova/config ref|config.xml]]</code> من ‎<code>/framework/res/xml</code> إلى مجلد المشروع‎ <code>/res/xml</code>.

== انظر أيضًا ==
* [[Cordova/webview ios|العوارض في منصة iOS]]

* [[Cordova/webviews|دليل تضمين كوردوفا في تطبيق أصيل]]
* [[Cordova/platforms android|دليل التطوير على منصة أندرويد]]
* [[Cordova/plugins|دليل تطوير الإضافات في كوردوفا]]

==مصادر==
*[https://cordova.apache.org/docs/en/latest/guide/platforms/android/webview.html صفحة Android WebViews في توثيق كوردوفا الرسمي]