Android WebViews

Это руководство показывает, как встроить компонент WebView, поддерживающий Cordova, в более крупное приложение Android. Подробности о том, как эти компоненты могут взаимодействовать друг с другом, см. в разделе Плагины приложений.

Если вы не знакомы с Android, сначала ознакомьтесь с Руководством по платформе Android и установите последнюю версию Android SDK перед попыткой более необычного варианта разработки — встраивания WebView. Начиная с Cordova 1.9, платформа Android полагается на компонент CordovaWebView, который основан на устаревшем CordovaActivity компоненте, предшествующем релизу 1.9.

1. Чтобы следовать этим инструкциям, убедитесь, что у вас есть последняя версия дистрибутива Cordova. Скачайте его с сайта cordova.apache.org и разархивируйте его Android пакет.

2. Перейдите в каталог /framework пакета Android и запустите ant jar. Он создает файл Cordova .jar, сформированный как /framework/cordova-x.x.x.jar.

3. Скопируйте файл .jar в каталог /libs проекта Android.

4. Добавьте следующее в файл /res/xml/main.xml приложения, с layout_height, layout_width и id измененными в соответствии с приложением:

   <org.apache.cordova.CordovaWebView
       android:id="@+id/tutorialView"
       android:layout_width="match_parent"
       android:layout_height="match_parent" />
   

5. Измените активность так, чтобы она реализовывала CordovaInterface. Она должна реализовывать включенные методы. Вы можете скопировать их из /framework/src/org/apache/cordova/CordovaActivity.java, или же реализовать их самостоятельно. Следующий фрагмент кода демонстрирует базовое приложение, которое полагается на интерфейс. Обратите внимание, как идентификатор ссылки на вид соответствует атрибуту id, указанному в фрагменте XML, показанном выше:

   public class CordovaViewTestActivity extends Activity implements CordovaInterface {
       CordovaWebView cwv;
       /* Called when the activity is first created. */
       @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());
       }
   

6. Если приложение должно использовать камеру, реализуйте следующее:

   @Override
   public void setActivityResultCallback(CordovaPlugin plugin) {
       this.activityResultCallback = plugin;
   }
   /**
    * Launch an activity for which you would like a result when it finished. When this activity exits,
    * your onActivityResult() method is called.
    *
    * @param command           The command object
    * @param intent            The intent to start
    * @param requestCode       The request code that is passed to callback to identify the activity
    */
   public void startActivityForResult(CordovaPlugin command, Intent intent, int requestCode) {
       this.activityResultCallback = command;
       this.activityResultKeepRunning = this.keepRunning;
   
       // If multitasking turned on, then disable it for activities that return results
       if (command != null) {
           this.keepRunning = false;
       }
   
       // Start activity
       super.startActivityForResult(intent, requestCode);
   }
   
   @Override
   /**
    * Called when an activity you launched exits, giving you the requestCode you started it with,
    * the resultCode it returned, and any additional data from it.
    *
    * @param requestCode       The request code originally supplied to startActivityForResult(),
    *                          allowing you to identify who this result came from.
    * @param resultCode        The integer result code returned by the child activity through its setResult().
    * @param data              An Intent, which can return result data to the caller (various data can be attached to Intent "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);
       }
   }
   

7. Наконец, не забудьте добавить пул потоков, иначе плагины не имеют потоков для выполнения:

   @Override
   public ExecutorService getThreadPool() {
       return threadPool;
   }
   

8. Скопируйте файлы HTML и JavaScript приложения в каталог /assets/www проекта Android.

9. Скопируйте файл config.xml из /framework/res/xml в каталог /res/xml проекта.