http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/f061b980/www/docs/es/dev/guide/platforms/wp8/vmware.md ---------------------------------------------------------------------- diff --git a/www/docs/es/dev/guide/platforms/wp8/vmware.md b/www/docs/es/dev/guide/platforms/wp8/vmware.md new file mode 100644 index 0000000..23d3894 --- /dev/null +++ b/www/docs/es/dev/guide/platforms/wp8/vmware.md @@ -0,0 +1,53 @@ +--- +license: > + Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +title: Configuración de VMWare Fusion +--- + +# Configuración de VMWare Fusion + +Esta sección le muestra cómo configurar VMWare Fusion en un Mac para que Córdoba puede utilizar para generar aplicaciones de Windows Phone. + +La [Microsoft Developer Network][1] proporciona instrucciones generales sobre cómo ejecutar Windows bajo VMWare Fusion. Después de instalar Windows, siga estos pasos: + + [1]: http://msdn.microsoft.com/en-US/library/windows/apps/jj945426 + +1. Dentro de VMWare Fusion, seleccione la imagen de disco de Windows 8 que ha preparado y elija **configuración**. + +2. Elija las opciones de configuración de **los procesadores y memoria** . Asegúrese de especificar *dos* núcleos de procesador y que **permiten a las aplicaciones de hipervisor en esta máquina Virtual**: + + ![][2] + + El emulador de Windows Phone solo utiliza la mitad de un gigabyte de memoria, asà que en general que se debe reservar por lo menos 2GB para VMWare. + +3. Elija la configuración **avanzada** . Activar el **motor de virtualización preferido: Intel VT-x con EPT** opción: + + ![][3] + +4. Modificar el archivo *VMX* para agregar o modificar los siguientes parámetros: + + hypervisor.cpuid.v0 = "FALSE" + mce.enable = "TRUE" + vhv.enable = "TRUE" + + + [2]: {{ site.baseurl }}/static/img/guide/platforms/wp8/vmware_memory_opts.png + [3]: {{ site.baseurl }}/static/img/guide/platforms/wp8/vmware_advanced_opts.png + +Una vez que complete estos pasos, entonces estás listo para instalar el SDK de Windows Phone. Consulte a la guÃa de plataforma de Windows Phone 8 para más detalles.
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/f061b980/www/docs/es/dev/guide/platforms/wp8/webview.md ---------------------------------------------------------------------- diff --git a/www/docs/es/dev/guide/platforms/wp8/webview.md b/www/docs/es/dev/guide/platforms/wp8/webview.md new file mode 100644 index 0000000..2fcfc55 --- /dev/null +++ b/www/docs/es/dev/guide/platforms/wp8/webview.md @@ -0,0 +1,45 @@ +--- +license: > + Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +title: Windows Phone 8,0 WebViews +--- + +# Windows Phone 8,0 WebViews + +Esta guÃa le muestra cómo incrustar un componente WebView Cordova habilitado dentro de una aplicación Windows Phone 8.0 más grande. + +Para seguir estas instrucciones, asegúrate de que tienes la última distribución de Córdoba. Descargar desde [cordova.apache.org](http://cordova.apache.org) y descomprime el paquete Windows Phone 8.0 (cordova-wp8-*.zip). + + 1. Desplácese hasta el paquete `wp8/framework` Directorio y construir `WPCordovaClassLib.sln` . Se crea el`Bin\Debug[Release]\WPCordovaClassLib.dll`. + + 2. Copia el `WPCordovaClassLib.dll` archivo en del proyecto Windows Phone 8 `/libs` directorio e incluyen `WPCordovaClassLib.dll` a través de su proyecto `Project->References->Add Reference` . Alternativamente, se puede hacer referencia directamente el `wp8/framework/WPCordovaClassLib.csproj` archivo. + + 3. Añadir `CordovaView` componente a tu página (por ejemplo,`MainPage.xaml`). + + xmlns:my="clr-namespace:WPCordovaClassLib;assembly=WPCordovaClassLib"> + ... + <my:CordovaView HorizontalAlignment="Stretch" Margin="0,0,0,0" + StartPageUri="html/index.html" x:Name="CordovaView" VerticalAlignment="Stretch" /> + + + 4. Copia `common/www/cordova.js` junto con archivos HTML y JavaScript de la aplicación del proyecto de Windows Phone 8 `html` directorio e incluyen nuevos archivos al proyecto. + + 5. Copia el `wp8/template/config.xml` al directorio raÃz del proyecto y + +Las instrucciones anteriores se enlace Cordova componentes solamente, ver usando Plugman para gestionar Plugins para enlazar Cordova plugins. \ No newline at end of file http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/f061b980/www/docs/es/dev/guide/support/index.md ---------------------------------------------------------------------- diff --git a/www/docs/es/dev/guide/support/index.md b/www/docs/es/dev/guide/support/index.md new file mode 100644 index 0000000..4ce0f77 --- /dev/null +++ b/www/docs/es/dev/guide/support/index.md @@ -0,0 +1,864 @@ +--- +license: > + Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +title: Soporte de plataformas +--- + +# Soporte de plataformas + +A continuación muestra el conjunto de herramientas de desarrollo y dispositivo IPAs disponibles para cada plataforma móvil. Las APIs de dispositivos a continuación son proporcionadas por extensiones de núcleo, incluyendo las disponibles por [extensiones de terceros][1]. Los encabezados de columna muestran de la CLI. + + [1]: http://plugins.cordova.io + +<!-- START HTML --> + +<table class="compat" width="100%"> + <tr> + <th> + </td> <th> + <tt>Amazon-fireos</tt> + </th> + + <th> + <tt>Android</tt> + </th> + + <th> + <tt>blackberry10</tt> + </th> + + <th> + <tt>Firefox OS</tt> + </th> + + <th> + <tt>Ios</tt> + </th> + + <th> + <tt>Ubuntu</tt> + </th> + + <th> + <tt>WP8</tt><br />(Windows Phone 8) + </th> + + <th> + <tt>Windows</tt><br />(8.0, 8.1, 10,<br />Teléfono 8.1) + </th> + + <th> + <tt>Tizen</tt> + </th></tr> </thead> + + <tr> + <th> + <a href="../cli/index.html">cordova<br />CLI</a> + </th> + + <td data-col="amazon-fireos" class="y"> + Mac, Windows, Linux + </td> + + <td data-col="android" class="y"> + Mac, Windows, Linux + </td> + + <td data-col="blackberry10" class="y"> + Mac, Windows + </td> + + <td data-col="firefoxos" class="y"> + Mac, Windows, Linux + </td> + + <td data-col="ios" class="y"> + Mac + </td> + + <td data-col="ubuntu" class="y"> + Ubuntu + </td> + + <td data-col="winphone8" class="y"> + Windows + </td> + + <td data-col="win8" class="y"> + </td> + + <td data-col="tizen" class="n"> + </td> + </tr> + + <tr> + <th> + <a href="../hybrid/webviews/index.html">Embedded<br />WebView</a> + </th> + + <td data-col="amazon-fireos" class="y"> + <a href="../platforms/amazonfireos/webview.html">(ver detalles)</a> + </td> + + <td data-col="android" class="y"> + <a href="../platforms/android/webview.html">(ver detalles)</a> + </td> + + <td data-col="blackberry10" class="n"> + </td> + + <td data-col="firefoxos" class="n"> + </td> + + <td data-col="ios" class="y"> + <a href="../platforms/ios/webview.html">(ver detalles)</a> + </td> + + <td data-col="ubuntu" class="y"> + </td> + + <td data-col="winphone8" class="n"> + </td> + + <td data-col="win8" class="n"> + </td> + + <td data-col="tizen" class="n"> + </td> + </tr> + + <tr> + <th> + <a href="../hybrid/plugins/index.html">Plug-in<br />Interface</a> + </th> + + <td data-col="amazon-fireos" class="y"> + <a href="../platforms/amazonfireos/plugin.html">(ver detalles)</a> + </td> + + <td data-col="android" class="y"> + <a href="../platforms/android/plugin.html">(ver detalles)</a> + </td> + + <td data-col="blackberry10" class="y"> + <a href="../platforms/blackberry10/plugin.html">(ver detalles)</a> + </td> + + <td data-col="firefoxos" class="n"> + </td> + + <td data-col="ios" class="y"> + <a href="../platforms/ios/plugin.html">(ver detalles)</a> + </td> + + <td data-col="ubuntu" class="y"> + </td> + + <td data-col="winphone8" class="y"> + <a href="../platforms/wp8/plugin.html">(ver detalles)</a> + </td> + + <td data-col="win8" class="y"> + </td> + + <td data-col="tizen" class="n"> + </td> + </tr> + + <tr> + <th> + </th> + + <th colspan="20"> + API de la plataforma + </th> + </tr> + + <tr> + <th> + <a href="https://www.npmjs.com/package/cordova-plugin-device-motion";>Acelerómetro</a> + </th> + + <td data-col="amazon-fireos" class="y"> + </td> + + <td data-col="android" class="y"> + </td> + + <td data-col="blackberry10" class="y"> + </td> + + <td data-col="firefoxos" class="y"> + </td> + + <td data-col="ios" class="y"> + </td> + + <td data-col="ubuntu" class="y"> + </td> + + <td data-col="winphone8" class="y"> + </td> + + <td data-col="win8" class="y"> + </td> + + <td data-col="tizen" class="y"> + </td> + </tr> + + <tr> + <th> + <a href="https://www.npmjs.com/package/cordova-plugin-battery-status";>HomeScreen PlusPlus</a> + </th> + + <td data-col="amazon-fireos" class="y"> + </td> + + <td data-col="android" class="y"> + </td> + + <td data-col="blackberry10" class="y"> + </td> + + <td data-col="firefoxos" class="y"> + </td> + + <td data-col="ios" class="y"> + </td> + + <td data-col="ubuntu" class="n"> + </td> + + <td data-col="winphone8" class="y"> + </td> + + <td data-col="win8" class="y"> + * Windows Phone 8.1 sólo + </td> + + <td data-col="tizen" class="y"> + </td> + </tr> + + <tr> + <th> + <a href="https://www.npmjs.com/package/cordova-plugin-camera";>Cámara</a> + </th> + + <td data-col="amazon-fireos" class="y"> + </td> + + <td data-col="android" class="y"> + </td> + + <td data-col="blackberry10" class="y"> + </td> + + <td data-col="firefoxos" class="y"> + </td> + + <td data-col="ios" class="y"> + </td> + + <td data-col="ubuntu" class="y"> + </td> + + <td data-col="winphone8" class="y"> + </td> + + <td data-col="win8" class="y"> + </td> + + <td data-col="tizen" class="y"> + </td> + </tr> + + <tr> + <th> + <a href="https://www.npmjs.com/package/cordova-plugin-media-capture";>Captura</a> + </th> + + <td data-col="amazon-fireos" class="y"> + </td> + + <td data-col="android" class="y"> + </td> + + <td data-col="blackberry10" class="y"> + </td> + + <td data-col="firefoxos" class="n"> + </td> + + <td data-col="ios" class="y"> + </td> + + <td data-col="ubuntu" class="y"> + </td> + + <td data-col="winphone8" class="y"> + </td> + + <td data-col="win8" class="y"> + </td> + + <td data-col="tizen" class="n"> + </td> + </tr> + + <tr> + <th> + <a href="https://www.npmjs.com/package/cordova-plugin-device-orientation";>Brújula</a> + </th> + + <td data-col="amazon-fireos" class="y"> + </td> + + <td data-col="android" class="y"> + </td> + + <td data-col="blackberry10" class="y"> + </td> + + <td data-col="firefoxos" class="n"> + </td> + + <td data-col="ios" class="y"> + (3GS+) + </td> + + <td data-col="ubuntu" class="y"> + </td> + + <td data-col="winphone8" class="y"> + </td> + + <td data-col="win8" class="y"> + </td> + + <td data-col="tizen" class="y"> + </td> + </tr> + + <tr> + <th> + <a href="https://www.npmjs.com/package/cordova-plugin-network-information";>Conexión</a> + </th> + + <td data-col="amazon-fireos" class="y"> + </td> + + <td data-col="android" class="y"> + </td> + + <td data-col="blackberry10" class="y"> + </td> + + <td data-col="firefoxos" class="n"> + </td> + + <td data-col="ios" class="y"> + </td> + + <td data-col="ubuntu" class="y"> + </td> + + <td data-col="winphone8" class="y"> + </td> + + <td data-col="win8" class="y"> + </td> + + <td data-col="tizen" class="y"> + </td> + </tr> + + <tr> + <th> + <a href="https://www.npmjs.com/package/cordova-plugin-contacts";>Contactos</a> + </th> + + <td data-col="amazon-fireos" class="y"> + </td> + + <td data-col="android" class="y"> + </td> + + <td data-col="blackberry10" class="y"> + </td> + + <td data-col="firefoxos" class="y"> + </td> + + <td data-col="ios" class="y"> + </td> + + <td data-col="ubuntu" class="y"> + </td> + + <td data-col="winphone8" class="y"> + </td> + + <td data-col="win8" class="p"> + parcialmente + </td> + + <td data-col="tizen" class="n"> + </td> + </tr> + + <tr> + <th> + <a href="https://www.npmjs.com/package/cordova-plugin-device";>Dispositivo</a> + </th> + + <td data-col="amazon-fireos" class="y"> + </td> + + <td data-col="android" class="y"> + </td> + + <td data-col="blackberry10" class="y"> + </td> + + <td data-col="firefoxos" class="y"> + </td> + + <td data-col="ios" class="y"> + </td> + + <td data-col="ubuntu" class="y"> + </td> + + <td data-col="winphone8" class="y"> + </td> + + <td data-col="win8" class="y"> + </td> + + <td data-col="tizen" class="y"> + </td> + </tr> + + <tr> + <th> + <a href="../../cordova/events/events.html">Eventos</a> + </th> + + <td data-col="amazon-fireos" class="y"> + </td> + + <td data-col="android" class="y"> + </td> + + <td data-col="blackberry10" class="y"> + </td> + + <td data-col="firefoxos" class="n"> + </td> + + <td data-col="ios" class="y"> + </td> + + <td data-col="ubuntu" class="y"> + </td> + + <td data-col="winphone8" class="y"> + </td> + + <td data-col="win8" class="y"> + </td> + + <td data-col="tizen" class="y"> + </td> + </tr> + + <tr> + <th> + <a href="https://www.npmjs.com/package/cordova-plugin-file";>Archivo</a> + </th> + + <td data-col="amazon-fireos" class="y"> + </td> + + <td data-col="android" class="y"> + </td> + + <td data-col="blackberry10" class="y"> + </td> + + <td data-col="firefoxos" class="n"> + </td> + + <td data-col="ios" class="y"> + </td> + + <td data-col="ubuntu" class="y"> + </td> + + <td data-col="winphone8" class="y"> + </td> + + <td data-col="win8" class="y"> + </td> + + <td data-col="tizen" class="n"> + </td> + </tr> + + <tr> + <th> + <a href="https://www.npmjs.com/package/cordova-plugin-file-transfer";>Transferencia de archivos</a> + </th> + + <td data-col="amazon-fireos" class="y"> + </td> + + <td data-col="android" class="y"> + </td> + + <td data-col="blackberry10" class="y"> + * No apoyan onprogress ni abortar + </td> + + <td data-col="firefoxos" class="n"> + </td> + + <td data-col="ios" class="y"> + </td> + + <td data-col="ubuntu" class="n"> + </td> + + <td data-col="winphone8" class="y"> + * No apoyan onprogress ni abortar + </td> + + <td data-col="win8" class="y"> + * No apoyan onprogress ni abortar + </td> + + <td data-col="tizen" class="n"> + </td> + </tr> + + <tr> + <th> + <a href="https://www.npmjs.com/package/cordova-plugin-geolocation";>Geolocalización</a> + </th> + + <td data-col="amazon-fireos" class="y"> + </td> + + <td data-col="android" class="y"> + </td> + + <td data-col="blackberry10" class="y"> + </td> + + <td data-col="firefoxos" class="y"> + </td> + + <td data-col="ios" class="y"> + </td> + + <td data-col="ubuntu" class="y"> + </td> + + <td data-col="winphone8" class="y"> + </td> + + <td data-col="win8" class="y"> + </td> + + <td data-col="tizen" class="y"> + </td> + </tr> + + <tr> + <th> + <a href="https://www.npmjs.com/package/cordova-plugin-globalization";>Globalización</a> + </th> + + <td data-col="amazon-fireos" class="y"> + </td> + + <td data-col="android" class="y"> + </td> + + <td data-col="blackberry10" class="y"> + </td> + + <td data-col="firefoxos" class="n"> + </td> + + <td data-col="ios" class="y"> + </td> + + <td data-col="ubuntu" class="y"> + </td> + + <td data-col="winphone8" class="y"> + </td> + + <td data-col="win8" class="y"> + </td> + + <td data-col="tizen" class="n"> + </td> + </tr> + + <tr> + <th> + <a href="https://www.npmjs.com/package/cordova-plugin-inappbrowser";>InAppBrowser</a> + </th> + + <td data-col="amazon-fireos" class="y"> + </td> + + <td data-col="android" class="y"> + </td> + + <td data-col="blackberry10" class="y"> + </td> + + <td data-col="firefoxos" class="n"> + </td> + + <td data-col="ios" class="y"> + </td> + + <td data-col="ubuntu" class="y"> + </td> + + <td data-col="winphone8" class="y"> + </td> + + <td data-col="win8" class="p"> + utiliza el iframe + </td> + + <td data-col="tizen" class="n"> + </td> + </tr> + + <tr> + <th> + <a href="https://www.npmjs.com/package/cordova-plugin-media";>Los medios de comunicación</a> + </th> + + <td data-col="amazon-fireos" class="y"> + </td> + + <td data-col="android" class="y"> + </td> + + <td data-col="blackberry10" class="y"> + </td> + + <td data-col="firefoxos" class="n"> + </td> + + <td data-col="ios" class="y"> + </td> + + <td data-col="ubuntu" class="y"> + </td> + + <td data-col="winphone8" class="y"> + </td> + + <td data-col="win8" class="y"> + </td> + + <td data-col="tizen" class="y"> + </td> + </tr> + + <tr> + <th> + <a href="https://www.npmjs.com/package/cordova-plugin-dialogs";>Notificación</a> + </th> + + <td data-col="amazon-fireos" class="y"> + </td> + + <td data-col="android" class="y"> + </td> + + <td data-col="blackberry10" class="y"> + </td> + + <td data-col="firefoxos" class="n"> + </td> + + <td data-col="ios" class="y"> + </td> + + <td data-col="ubuntu" class="y"> + </td> + + <td data-col="winphone8" class="y"> + </td> + + <td data-col="win8" class="y"> + </td> + + <td data-col="tizen" class="y"> + </td> + </tr> + + <tr> + <th> + <a href="https://www.npmjs.com/package/cordova-plugin-splashscreen";>SplashScreen</a> + </th> + + <td data-col="amazon-fireos" class="y"> + </td> + + <td data-col="android" class="y"> + </td> + + <td data-col="blackberry10" class="y"> + </td> + + <td data-col="firefoxos" class="n"> + </td> + + <td data-col="ios" class="y"> + </td> + + <td data-col="ubuntu" class="y"> + </td> + + <td data-col="winphone8" class="y"> + </td> + + <td data-col="win8" class="y"> + </td> + + <td data-col="tizen" class="n"> + </td> + </tr> + + <tr> + <th> + <a href="https://www.npmjs.com/package/cordova-plugin-statusbar";>Barra de estado</a> + </th> + + <td data-col="amazon-fireos" class="n"> + </td> + + <td data-col="android" class="y"> + </td> + + <td data-col="blackberry10" class="n"> + </td> + + <td data-col="firefoxos" class="n"> + </td> + + <td data-col="ios" class="y"> + </td> + + <td data-col="ubuntu" class="n"> + </td> + + <td data-col="winphone8" class="y"> + </td> + + <td data-col="win8" class="y"> + Windows Phone 8.1 sólo + </td> + + <td data-col="tizen" class="n"> + </td> + </tr> + + <tr> + <th> + <a href="../../cordova/storage/storage.html">Almacenamiento de información</a> + </th> + + <td data-col="amazon-fireos" class="y"> + </td> + + <td data-col="android" class="y"> + </td> + + <td data-col="blackberry10" class="y"> + </td> + + <td data-col="firefoxos" class="n"> + </td> + + <td data-col="ios" class="y"> + </td> + + <td data-col="ubuntu" class="y"> + </td> + + <td data-col="winphone8" class="y"> + <a href="../../cordova/storage/localstorage/localstorage.html">localStorage</a> & indexedDB + </td> + + <td data-col="win8" class="y"> + <a href="../../cordova/storage/localstorage/localstorage.html">localStorage</a> & indexedDB + </td> + + <td data-col="tizen" class="y"> + </td> + </tr> + + <tr> + <th> + <a href="https://www.npmjs.com/package/cordova-plugin-vibration";>Vibración</a> + </th> + + <td data-col="amazon-fireos" class="y"> + </td> + + <td data-col="android" class="y"> + </td> + + <td data-col="blackberry10" class="y"> + </td> + + <td data-col="firefoxos" class="y"> + </td> + + <td data-col="ios" class="y"> + </td> + + <td data-col="ubuntu" class="n"> + </td> + + <td data-col="winphone8" class="y"> + </td> + + <td data-col="win8" class="y"> + * Windows Phone 8.1 sólo + </td> + + <td data-col="tizen" class="n"> + </td> + </tr></table> + + <!-- END HTML --> \ No newline at end of file http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/f061b980/www/docs/es/dev/index.md ---------------------------------------------------------------------- diff --git a/www/docs/es/dev/index.md b/www/docs/es/dev/index.md new file mode 100644 index 0000000..fbe720a --- /dev/null +++ b/www/docs/es/dev/index.md @@ -0,0 +1,163 @@ +--- +license: > + Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +title: GuÃas +--- + +<div id="home"> + <h1> + GuÃas + </h1> + + <ul> + <li> + <h2> + <a href="guide/overview/index.html">Resumen</a> + </h2> + + <span>Comience aquà si usted es nuevo a Córdoba. Incluye la instalación y próximos pasos.</span> + </li> + <li> + <h2> + <a href="guide/support/index.html">Soporte de plataformas</a> + </h2> + + <span>Tabla de compatibilidad para todas las funciones principales.</span> + </li> + <li> + <h2> + <a href="guide/cli/index.html">La interfaz de linea de comandos</a> + </h2> + + <span>Crear, construir y desplegar desde la lÃnea de comandos.</span> + </li> + <li> + <h2> + <a href="guide/platforms/index.html">GuÃas de plataformas</a> + </h2> + + <span>Configurar cada plataforma SDK y actualización de proyectos.</span> + </li> + <li> + <h2> + <a href="plugin_ref/plugman.html">Utilizando Plugman para administrar Plugins</a> + </h2> + + <span>Administrar plugins sin la CLI cuando se utiliza el flujo de trabajo centrado en plataforma.</span> + </li> + <li> + <h2> + <a href="config_ref/index.html">El archivo config.xml</a> + </h2> + + <span>Personalizar las caracterÃsticas de su aplicación.</span> + </li> + <li> + <h2> + Los iconos y las pantallas Splash + </h2> + + <span>Personalizar imágenes muestra de su aplicación.</span> + </li> + <li> + <h2> + <a href="guide/hybrid/webviews/index.html">Incrustar WebViews</a> + </h2> + + <span>Implementar la Cordova WebView en su proyecto nativo.</span> + </li> + <li> + <h2> + <a href="guide/hybrid/plugins/index.html">GuÃa de desarrollo de plugin</a> + </h2> + + <span>Desarrollar tu propio plugin.</span> + </li> + <li> + <h2> + <a href="guide/appdev/privacy/index.html">GuÃa de privacidad</a> + </h2> + + <span>Aprenda sobre cuestiones de privacidad móvil importantes.</span> + </li> + <li> + <h2> + <a href="guide/appdev/security/index.html">GuÃa de seguridad</a> + </h2> + + <span>Información y consejos para la creación de una aplicación segura.</span> + </li> + <li> + <h2> + <a href="platform_plugin_versioning_ref/index.html">Plataformas y gestión de versiones de Plugins</a> + </h2> + + <span>Guardar y restaurar proyectos CLI a un estado conocido sin problemas.</span> + </li> + <li> + <h2> + <a href="guide/appdev/whitelist/index.html">GuÃa de lista blanca</a> + </h2> + + <span>Una aplicación acceso a recursos externos.</span> + </li> + <li> + <h2> + <a href="cordova/storage/storage.html">Almacenamiento de información</a> + </h2> + + <span>Un resumen de opciones de almacenamiento de información nativo.</span> + </li> + <li> + <h2> + <a href="guide/appdev/hooks/index.html">Ganchos de guÃa</a> + </h2> + + <span>Extender la funcionalidad de Cordova por defecto añadiendo scripts personalizados.</span> + </li> + <li> + <h2> + Pasos a seguir + </h2> + + <span>Un vistazo a temas que se encontrarán con nuevos desarrolladores Cordova.</span> + </li> + </ul> + + <h1> + Referencia de la API + </h1> + + <ul> + <li> + <h2> + <a href="cordova/events/events.html">Eventos</a> + </h2> + + <span>Hooks a eventos nativos a través de JavaScript.</span> + </li> + <li> + <h2> + <a href="cordova/plugins/pluginapis.html">Plugin APIs</a> + </h2> + + <span>Descubra qué plugins Cordova están disponibles para usar en su proyecto.</span> + </li> + </ul> +</div> http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/f061b980/www/docs/es/dev/page_index.md ---------------------------------------------------------------------- diff --git a/www/docs/es/dev/page_index.md b/www/docs/es/dev/page_index.md new file mode 100644 index 0000000..d90c872 --- /dev/null +++ b/www/docs/es/dev/page_index.md @@ -0,0 +1,4 @@ +--- +title: Ãndice de palabras clave +--- +{% include docs_index.html %} http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/f061b980/www/docs/es/dev/platform_plugin_versioning_ref/index.md ---------------------------------------------------------------------- diff --git a/www/docs/es/dev/platform_plugin_versioning_ref/index.md b/www/docs/es/dev/platform_plugin_versioning_ref/index.md new file mode 100644 index 0000000..e800834 --- /dev/null +++ b/www/docs/es/dev/platform_plugin_versioning_ref/index.md @@ -0,0 +1,167 @@ +--- +license: > + Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +title: Plataformas y gestión de versiones de Plugins +--- + +# Plataformas y gestión de versiones de Plugins + +De versión 4.3.0 en adelante, Córdoba ofrece la posibilidad de guardar y restaurar de plugins y plataformas. + +Esta caracterÃstica permite a los desarrolladores guardar y restaurar la aplicación a un estado conocido sin tener que comprobar en todo el código fuente de plataforma y plugin. + +El comando 'save' almacena información sobre la plataforma de aplicación y versiones de plugin en el archivo config.xml. El paso de 'restauración' se produce automáticamente cuando una **'cordova prepare'** , haciendo uso de la información previamente guardada en el archivo config.xml. + +Un escenario donde guardar/restaurar las capacidades vienen en prácticas es en grandes equipos que trabajan en una aplicación, con cada miembro del equipo centrado en una plataforma o plugin. Esta caracterÃstica hace más fácil compartir el proyecto y reducir la cantidad de código redundante que se comprueba en el repositorio. + +## Versiones de la plataforma + +### Guardando plataformas + +Para guardar una plataforma, ejecuta el siguiente comando: + + $ cordova platform add <platform[@<version>] | directory | git_url> --save + + +Después de ejecutar el comando anterior, el archivo config.xml resultante se parece: + + <?xml version='1.0' encoding='utf-8'?> + ... + <engine name="android" spec="~4.0.0" /> + ... + </xml> + + +Algunos ejemplos: + + * **'plataforma Córdoba añadir android--guardar'** => recupera la versión fijada de la plataforma android, agrega al proyecto y luego actualiza el archivo config.xml. + * **'plataforma Córdoba añadir [email protected]'** => recupera la plataforma android, versión 3.7.0 de MNP, agrega al proyecto y actualizaciones config.xml. + * **'plataforma Córdoba añadir android @https://github.com/apache/cordova-android.git--guardar'** => clones el repositorio especificado git cordova-android, agrega la plataforma android al proyecto, entonces actualiza el archivo config.xml y apunta su versión git-dirección url especificada. + * **'plataforma Córdoba Añadir C:/ruta/a/android/plataforma, guardar'** => recupera la plataforma android en el directorio especificado, lo añade al proyecto, luego actualizaciones config.xml y punto al directorio. + +### Masa de ahorro plataformas sobre un proyecto existente + +El '--guardar ' bandera descrita sólo es útil cuando Recuerdas a utilizar durante la adición de la plataforma. Si tienes un proyecto ya existente y desea guardar todas las plataformas actualmente agregadas en su proyecto, usted puede utilizar: + + $ cordova platform save + + +### Actualización / eliminación de plataformas + +También es posible actualizar/eliminar del archivo config.xml durante los comandos 'cordova platform update' y 'cordova platform remove': + + $ cordova platform update <platform[@<version>] | directory | git_url> --save + $ cordova platform remove <platform> --save + + +Algunos ejemplos: + + * **'Córdoba plataforma actualización android--guardar'** => además de actualizar la plataforma android a la versión anclada, actualización config.xml entrada + * **'Córdoba plataforma update [email protected]'** => además de actualizar la plataforma android a la versión 3.8.0, actualización config.xml entrada + * **'Córdoba plataforma update /path/to/android/platform--guardar'** => además de actualizar la plataforma android a la versión en la carpeta, actualizar archivo config.xml entrada + * **'plataforma cordova quitar android--guardar'** => extrae el proyecto de la plataforma android y elimina su entrada del archivo config.xml. + +### Restauración de plataformas + +Plataformas se restauran automáticamente de config.xml cuando se ejecuta el comando **'cordova preparar'** . + +Si agrega una plataforma sin especificar una versión/carpeta/git_url, la versión a instalar es tomada de config.xml, **si encuentran**. + +Ejemplo: + +Supongamos que el archivo config.xml contiene la entrada siguiente: + + <?xml version='1.0' encoding='utf-8'?> + ... + <engine name="android" spec="3.7.0" /> + ... + </xml> + + +Si ejecuta el comando **'plataforma Córdoba añadir android'** (no versión/carpeta/git_url especificado), se instalará la plataforma '[email protected]' (como Obtenido de config.xml). + +* * * + +## Versión del plugin + +*(Los comandos de plugin son un espejo de los comandos de plugin)* + +### Guardando plugins + +Para guardar un plugin, ejecuta el siguiente comando: + + $ cordova plugin add <plugin[@<version>] | directory | git_url> --save + + +Después de ejecutar el comando anterior, el archivo config.xml resultante se parece: + + <?xml version='1.0' encoding='utf-8'?> + ... + <plugin name="cordova-plugin-console" spec="~1.0.0" /> + ... + </xml> + + +Algunos ejemplos: + + * **'cordova plugin add cordova-plugin-consola - '** => recupera la versión del plugin consola anclada, agrega al proyecto y luego actualiza el archivo config.xml. + * **'Córdoba plugin add [email protected]'** => recupera el plugin de android, versión 0.2.13 del MNP, agrega al proyecto y actualizaciones config.xml. + * **'cordova plugin add https://github.com/apache/cordova-plugin-console.git--guardar'** => clones el CVS console especificado plugin, agrega el plugin de la consola para el proyecto, entonces actualiza el archivo config.xml y apunta su versión git-dirección url especificada. + * **'Córdoba plugin Añadir C:/ruta/a/consola/plugin--guardar'** => recupera el plugin de la consola en el directorio especificado, agrega el proyecto, luego actualizaciones config.xml y punto al directorio. + +### Masa de ahorro plugins en un proyecto existente + +El '--guardar ' bandera descrita sólo es útil cuando Recuerdas a utilizar durante la adición del plugin. Si tienes un proyecto ya existente y desea guardar todos actualmente habÃa añadido plugins en el proyecto, se puede utilizar: + + $ cordova plugin save + + +### Actualizar / eliminar plugins + +También es posible actualizar/eliminar del archivo config.xml durante los comandos 'cordova plugin update' y 'quitar plugin de Córdoba': + + $ cordova plugin update <plugin[@<version>] | directory | git_url> --save + $ cordova plugin remove <plugin> --save + + +Algunos ejemplos: + + * **'Córdoba plugin update cordova-plugin-consola - guardar'** => además de actualizar el plugin de la consola a la versión anclada, actualización config.xml entrada + * **'Córdoba plugin update [email protected]'** => además de actualizar el plugin de android a la versión 3.8.0, actualización config.xml entrada + * **'Córdoba plugin update /path/to/console/plugin--guardar'** => además de actualizar el plugin de la consola a la versión en la carpeta, actualizar archivo config.xml entrada + * **'plugin cordova cordova-plugin-consola - excepto ' quitar** => quita el complemento de consola del proyecto y elimina su entrada del archivo config.xml. + +### Restauración de plugins + +Plugins se restauran automáticamente de config.xml cuando se ejecuta el comando **'cordova preparar'** . + +Si añades un plugin sin especificar una versión/carpeta/git_url, la versión a instalarse se toma del archivo config.xml, **si encuentran**. + +Ejemplo: + +Supongamos que el archivo config.xml contiene la entrada siguiente: + + <?xml version='1.0' encoding='utf-8'?> + ... + <plugin name="cordova-plugin-console" spec="0.2.11" /> + ... + </ xml> + + +Si ejecuta el comando **'cordova plugin add cordova-plugin-consola'** (no versión/carpeta/git_url especificado), se instalará el plugin '[email protected]' (como Obtenido de config.xml). \ No newline at end of file http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/f061b980/www/docs/es/dev/plugin_ref/plugman.md ---------------------------------------------------------------------- diff --git a/www/docs/es/dev/plugin_ref/plugman.md b/www/docs/es/dev/plugin_ref/plugman.md new file mode 100644 index 0000000..9627257 --- /dev/null +++ b/www/docs/es/dev/plugin_ref/plugman.md @@ -0,0 +1,210 @@ +--- +license: > + Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +title: Utilizando Plugman para administrar Plugins +--- + +# Utilizando Plugman para administrar Plugins + +Desde la versión 3.0 adelante, Cordova implementa todas las APIs del dispositivo como plugins y les deja desactivado por defecto. También soporta dos formas diferentes para agregar y quitar plugins, dependiendo de su elección de flujo de trabajo discutida en la Descripción: + +* Si utiliza un flujo de trabajo multiplataforma, utiliza el `cordova` utilidad CLI para agregar plugins, tal como se describe en la interfaz de lÃnea de comandos. La CLI modifica plugins para todas las plataformas especificadas a la vez. + +* Si utiliza un flujo de trabajo centrado en plataforma, utilice una interfaz de comandos de [Plugman][1] de nivel inferior, por separado para cada plataforma de destino. + + [1]: https://github.com/apache/cordova-plugman/ + +Esta sección detalla la utilidad Plugman. Para más información sobre consumo de Plugman como un módulo de nodo o modificar el código fuente, vea [el archivo Léame en su repositorio][2]. + + [2]: https://github.com/apache/cordova-plugman/blob/master/README.md + +## Instalando Plugman + +Para instalar Plugman, tu debes tener [node][3] instalado en tu computadora. A continuación, puede ejecutar el siguiente comando desde cualquier parte en su entorno para instalar plugman en todo el mundo, que está disponible desde cualquier directorio: + + [3]: http://nodejs.org/ + + $ npm install -g plugman + + +Además debes tener `git` en tu `PATH` para poder instalar los plugins directamente desde URLs remotas de git. + +**TIP**: Si encuentras que después de instalar el plugman con `npm` no es todavÃa capaz de ejecutar cualquiera `plugman` comandos, asegúrese de que ha agregado la `/npm/` Directorio en tu`PATH`. + +**Nota**: puede omitir este paso si no quieres contaminar su global `npm` espacio de nombres mediante la instalación de Plugman en todo el mundo. Si este es el caso, entonces cuando se crea un proyecto de Córdoba con las herramientas de shell, habrá un `node_modules` directorio dentro de su proyecto que contiene Plugman. Dado que no se instalar en todo el mundo, hace falta invocar `node` para cada comando Plugman, por ejemplo `node +./node_modules/plugman/main.js -version` . El resto de esta guÃa asume que ha instalado Plugman en todo el mundo, significa que usted puede invocar con sólo`plugman`. + +## Crear un proyecto Cordova + +Antes de que puedas utilizar Plugman, debes crear un proyecto Cordova. Puedes hacer esto del mismo modo utilizando la Interfaz de lÃnea de comandos o bien con scripts shell de bajo nivel. Las instrucciones para utilizar los scripts del shell para crear tu proyecto se encuentran en las guÃas "Herramientas de lÃnea de comandos" listadas en la página de las [GuÃas de plataformas](../guide/platforms/index.html). + +## Añadir un Plugin + +Una vez que has instalado Plugman y creado un proyecto Cordova, puedes comenzar a añadir plugins a la plataforma utilizando el siguiente comando: + + $ plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project <directory> --plugin <name|url|path> [--plugins_dir <directory>] [--www <directory>] [--variable <name>=<value> [--variable <name>=<value> ...]] + + +Usando una mÃnima cantidad de parámetros, este comando instala un plugin en un proyecto Cordova. Debes especificar una plataforma y la ubicación de un proyecto Cordova para dicha plataforma. Además, debes especificar un plugin con las diferentes formas del parámetro `--plugin` , las mismas son: + +* `name`: El nombre del directorio en dnde reside el plugin. Este debe ser un directorio dentro del path `--plugins_dir` (ve más abajo por más información) o un plugin del Cordova registry. +* `url`: Una URL que comience https:// o git://, y apunte a un repositorio git válido que es clonable y contenga el archivo `plugin.xml`. Los contenidos de este repositorio serán copiados a `--plugins_dir`. +* `path`: Una ruta a un directorio que contenga un plugin válido el cual incluya el archivo `plugin.xml`. El contenido de esta ruta será copiada a `--plugins_dir`. + +Otro parámetros: + +* `--plugins_dir` cuyo valor por defecto es `<project>/cordova/plugins`, pero puede ser cualquier directorio que contenga un subdirectorio por cada plugin. +* `--www` cuyo valor por defecto es la ruta de la carpeta `www`, pero puede ser cualquier directorio del proyecto Cordova que es utilizado como para los assets de la aplicación web. +* `--variable` permite especificar ciertas variables en el momento de la instalación, necesario para aquellos plugins que requieras una key del API u otros parámetros personalizados por el usuario. Por favor, vea la [Especificación plugin][4] para obtener más información. + + [4]: plugin_ref_spec.md.html#Plugin%20Specification + +## Remover un Plugin + +Para desinstalar un plugin, simplemente pasa el flag `--uninstall` e indica el ID del plugin. + + $ plugman --uninstall --platform <ios|amazon-fireos|android|blackberry10|wp8> --project <directory> --plugin <id> [--www <directory>] [--plugins_dir <directory>] + + +## Comandos de ayuda + +Plugman ofrece un comando de ayuda global el cual puede ayudarte si no sabes como continuar o si estás experimentando problemas. Esta ayuda mostrará la lista de todos los comandos disponibles de Plugman y su sintaxis: + + plugman -help + plugman # same as above + + +**NOTA**: `plugman -help` puede mostrar algún comando adicional del registry. Estos comandos son para desarrolladores de plugins y no deben ser implementados por registros de plugin de terceras partes. + +Además puede añadir el flag `--debug|-d` a cualquier comando Plugman que corra en modo verboso, el cual mostrará cualquier mensaje interno de depuración del mismo modo en el que son emitidos de manera que pueda ayudarte a encontrar el origen de problemas, como por ejemplo, archivos inexistentes. + + # Adding Android battery-status plugin to "myProject": + plugman -d --platform android --project myProject --plugin cordova-plugin-battery-status + + +Finalmente, puedes utilizar el flag `--version|-v` para ver que versión de Plugman te encuentras utilizando. + + plugman -v + + +## Acciones del Registry + +Estos son comando que pueden ser utilizados para interactuar con el [Plugin registry][5]. Por favor, nota que que estos comandos son especÃficos del registro de plugins *plugins.cordova.io* y no deben ser implementados por registros de terceras partes. + + [5]: http://plugins.cordova.io + +### Buscando un Plugin + +Puedes utilizar Plugman para buscar el id de un plugin dentro del [Plugin registry][5] que se corresponda con la lista de palabras clave separadas por espacios. + + plugman search <plugin keywords> + + +### Cambiando el Plugin Registry + +Puedes obtener o indicar la URL de los registros de plugins que actualmente plugman está usando. Generalmente tu debes utilizar este valor http://registry.cordova.io a menos que quieras utilizar un plugÃn en un registro de plugins de una tercera parte. + + plugman config set registry <url-to-registry> + plugman config get registry + + +### Obtener información de un Plugin + +Puedes obtener información acerca de cualquier plugin que se encuentre almacenado en el repositorio de plugins con el siguiente comando: + + plugman info <id> + + +Esto contactará al registro de plugins y obtendrá información como la versión del plugin. + +## Instalación de Plugins de núcleo + +Los ejemplos siguientes muestran cómo agregar plugins según sea necesario para que cualquier APIs Cordova utilizas en tu proyecto todavÃa funcionan después de actualizar a la versión 3.0. Para cada comando, debes seleccionar la plataforma de destino y directorio del proyecto de la plataforma de referencia. + +* cordova-plugin-battery-status + + `plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project <directory> --plugin cordova-plugin-battery-status` + +* cordova-plugin-camera + + `plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project <directory> --plugin cordova-plugin-camera` + +* cordova-plugin-console + + `plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project <directory> --plugin cordova-plugin-console` + +* cordova-plugin-contacts + + `plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project <directory> --plugin cordova-plugin-contacts` + +* cordova-plugin-device + + `plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project <directory> --plugin cordova-plugin-device` + +* cordova-plugin-device-motion (accelerometer) + + `plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project <directory> --plugin cordova-plugin-device-motion` + +* cordova-plugin-device-orientation (compass) + + `plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project <directory> --plugin cordova-plugin-device-orientation` + +* cordova-plugin-dialogs + + `plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project <directory> --plugin cordova-plugin-dialogs` + +* cordova-plugin-file + + `plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project <directory> --plugin cordova-plugin-file` + +* cordova-plugin-file-transfer + + `plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project <directory> --plugin cordova-plugin-file-transfer` + +* cordova-plugin-geolocation + + `plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project <directory> --plugin cordova-plugin-geolocation` + +* cordova-plugin-globalization + + `plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project <directory> --plugin cordova-plugin-globalization` + +* cordova-plugin-inappbrowser + + `plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project <directory> --plugin cordova-plugin-inappbrowser` + +* cordova-plugin-media + + `plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project <directory> --plugin cordova-plugin-media` + +* cordova-plugin-media-capture + + `plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project <directory> --plugin cordova-plugin-media-capture` + +* cordova-plugin-network-information + + `plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project <directory> --plugin cordova-plugin-network-information` + +* cordova-plugin-splashscreen + + `plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project <directory> --plugin cordova-plugin-splashscreen` + +* cordova-plugin-vibration + + `plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project <directory> --plugin cordova-plugin-vibration` \ No newline at end of file http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/f061b980/www/docs/es/dev/plugin_ref/spec.md ---------------------------------------------------------------------- diff --git a/www/docs/es/dev/plugin_ref/spec.md b/www/docs/es/dev/plugin_ref/spec.md new file mode 100644 index 0000000..944ce97 --- /dev/null +++ b/www/docs/es/dev/plugin_ref/spec.md @@ -0,0 +1,540 @@ +--- +license: > + Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +title: Especificación de plugin +--- + +# Especificación de plugin + +El `plugin.xml` archivo es un documento XML en el `plugins` espacio de nombres: `http://apache.org/cordova/ns/plugins/1.0` . Contiene un alto nivel `plugin` elemento que define el plugin y niños que definen la estructura del plugin. + +Un elemento de plugin de muestra: + + <?xml version="1.0" encoding="UTF-8"?> + <plugin xmlns="http://apache.org/cordova/ns/plugins/1.0"; + xmlns:android="http://schemas.android.com/apk/res/android"; + id="com.alunny.foo" + version="1.0.2"> + + +## *plugin* Elemento + +El `plugin` es elemento superior del manifiesto del plugin. Cuenta con los siguientes atributos: + +* `xmlns`(obligatorio): el espacio de nombres del plugin, `http://apache.org/cordova/ns/plugins/1.0` . Si el documento contiene XML de otros espacios de nombres, como las etiquetas que se añade a la `AndroidManifest.xml` archivo, esos espacios de nombres deben incluirse también en el elemento de nivel superior. + +* `id`(requerido): un revés-dominio estilo identificador para el plugin, tales como`com.alunny.foo` + +* `version`(requerido): un número de versión para el plugin, que coincide con la siguiente expresión regular estilo mayor-menor-patch: + + ^\d+[.]\d+[.]\d+$ + + +## Elementos *motores* y *motor* + +Los elementos secundarios de la `<engines>` elemento especificar las versiones de los marcos basados en Apache Cordova que este plugin soporta. Un ejemplo: + + <engines> + <engine name="cordova" version="1.7.0" /> + <engine name="cordova" version="1.8.1" /> + <engine name="worklight" version="1.0.0" platform="android" scriptSrc="worklight_version"/> + </engines> + + +Similar a la `<plugin>` del elemento `version` atributo, la cadena de versión especificada debe coincidir con una cadena de mayor-menor-patch conforme a la expresión regular: + + ^\d+[.]\d+[.]\d+$ + + +Elementos del motor también pueden especificar confuso acerca de los partidos para evitar la repetición y para reducir el mantenimiento cuando se actualiza la plataforma subyacente. Herramientas deben soportar un peso mÃnimo de `>` , `>=` , `<` y `<=` , por ejemplo: + + <engines> + <engine name="cordova" version=">=1.7.0" /> + <engine name="cordova" version="<1.8.1" /> + </engines> + + +El `<engine>` etiquetas también cuenta con soporte por defecto para todas las plataformas principales Cordova existe en. Especificar el `cordova` etiqueta motor significa que todas las versiones de Cordova en cualquier plataforma deben satisfacer el atributo de versión de motor. También puede enumerar sus versiones y plataformas especÃficas con el fin de reemplazar el catch-all `cordova` motor: + + <engines> + <engine name="cordova" version=">=1.7.0" /> + <engine name="cordova-android" version=">=1.8.0" /> + <engine name="cordova-ios" version=">=1.7.1" /> + </engines> + + +Aquà está una lista de la por defecto los motores que la `<engine>` soporta la etiqueta: + +* `cordova` +* `cordova-plugman` +* `cordova-amazon-fireos` +* `cordova-android` +* `cordova-ios` +* `cordova-blackberry10` +* `cordova-wp8` +* `cordova-windows8` +* `android-sdk` // returns the highest Android api level installed +* `apple-xcode` // returns the xcode version +* `apple-ios` // returns the highest iOS version installed +* `apple-osx` // returns the OSX version +* `blackberry-ndk` // returns the native blackberry SDK version + +Especificar Marcos personalizados basados en Apache Cordova deben aparecer bajo la etiqueta de motor asÃ: + + <engines> + <engine name="my_custom_framework" version="1.0.0" platform="android" scriptSrc="path_to_my_custom_framework_version"/> + <engine name="another_framework" version=">0.2.0" platform="ios|android" scriptSrc="path_to_another_framework_version"/> + <engine name="even_more_framework" version=">=2.2.0" platform="*" scriptSrc="path_to_even_more_framework_version"/> + </engines> + + +Un marco personalizado basado en Apache Cordova exige que un elemento motor incluye los siguientes atributos: `name` , `version` , `scriptSrc` , y`platform`. + +* `name`(requerido): un nombre legible para su marco personalizado. + +* `version`(obligatorio): la versión de que el marco debe tener para instalar. + +* `scriptSrc`(requerido): el archivo de comandos que dice plugman qué versión del marco personalizado. Idealmente, este archivo debe estar dentro del directorio de nivel superior de su directorio. + +* `platform`(requerido): las plataformas que soporta su marco. Usted puede utilizar el comodÃn `*` decir compatibles para todas las plataformas, especificar múltiples con un caracter como `android|ios|blackberry10` o simplemente una sola plataforma como`android`. + +plugman se anula con un código distinto de cero para cualquier plugin cuyo objetivo proyecto no cumple con las limitaciones del motor. + +Si no `<engine>` etiquetas se especifican, plugman intenta instalar en el directorio del proyecto especificado cordova ciegamente. + +## *nombre* Elemento + +Un nombre legible para el plugin, cuyo contenido de texto contiene el nombre del plugin. Por ejemplo: + + <name>Foo</name> + + +Este elemento no es (todavÃa) localización de la manija. + +## *Descripción* Elemento + +Una descripción legible para el plugin. El contenido del texto del elemento contiene la descripción del plugin. Un ejemplo: + + <description>Foo plugin description</description> + + +Este elemento no es (todavÃa) localización de la manija. + +## *autor* Elemento + +Nombre autor del plugin. El contenido del texto del elemento contiene el nombre del autor del plugin. Un ejemplo: + + <author>Foo plugin description</author> + + +## *palabras clave* Elemento + +Palabras clave plugin. El contenido del texto del elemento contiene palabras clave separadas por comas para describir el plugin. Un ejemplo: + + <keywords>foo,bar</keywords> + + +## *licencia* Elemento + +Licencia de plugin. El contenido del texto del elemento contiene la licencia del plugin. Un ejemplo: + + <license>Apache 2.0 License</license> + + +## *activo* Elemento + +Uno o más elementos listado los archivos o directorios que se copiarán en una aplicación Cordova `www` Directorio. Ejemplos: + + <!-- a single file, to be copied in the root directory --> + <asset src="www/foo.js" target="foo.js" /> + <!-- a directory, also to be copied in the root directory --> + <asset src="www/foo" target="foo" /> + + +Todos `<asset>` etiquetas requieren ambos `src` y `target` atributos. Sólo web plugins contiene principalmente `<asset>` elementos. Cualquier `<asset>` elementos que están anidados dentro de `<platform>` elementos especifican activos especÃficos a una plataforma web, como se describe a continuación. Los atributos incluyen: + +* `src`(requerido): donde se encuentra el archivo o directorio en el paquete del plugin, relativa a la `plugin.xml` documento. Si un archivo existe en la especificada `src` ubicación, plugman se detiene y revierte el proceso de instalación, emite una notificación sobre el conflicto y sale con un código distinto de cero. + +* `target` (required): + + Donde el fichero o el directorio debe estar ubicado en la aplicación de Cordova, relativa a la `www` directorio. Activos pueden ser dirigidas a subdirectorios, por ejemplo: + + <asset src="www/new-foo.js" target="js/experimental/foo.js" /> + + + crea la `js/experimental` directorio dentro de la `www` directorio, a menos que ya presente, entonces copias el `new-foo.js` archivo y cambia el nombre de lo `foo.js` . Si ya existe un archivo en la ubicación de destino, plugman se detiene y revierte el proceso de instalación, emite una notificación sobre el conflicto y sale con un código distinto de cero. + +## *JS-módulo* Elemento + +La mayorÃa de plugins incluyen uno o más archivos JavaScript. Cada `<js-module>` tag corresponde a un archivo JavaScript y evita que los usuarios del plugin tener que añadir un `<script>` etiqueta para cada archivo. Mientras que `<asset>` etiquetas simplemente copien un archivo desde el subdirectorio plugin en `www` , `<js-module>` etiquetas son mucho más sofisticados. Se parecen a esto: + + <js-module src="socket.js" name="Socket"> + <clobbers target="chrome.socket" /> + </js-module> + + +Al instalar un plugin con el ejemplo anterior, `socket.js` se copia a `www/plugins/my.plugin.id/socket.js` y se agrega como una entrada a `www/cordova_plugins.js` . En el tiempo de carga, el código `cordova.js` XHR se utiliza para leer cada archivo e inyectar un `<script>` tag en HTML. Agrega una asignación para aplastar o combinar según sea apropiado, como se describe a continuación. + +*No* envuelva el archivo con `cordova.define` , como se añade automáticamente. El módulo está envuelto en un cierre, con `module` , `exports` , y `require` en su alcance, como es normal para los módulos de AMD. + +Detalles para el `<js-module>` etiqueta: + +* El `src` hace referencia a un archivo en el directorio relativo a la `plugin.xml` archivo. + +* El `name` proporciona la última parte del nombre del módulo. Generalmente puede ser lo que quieras, y sólo importa si desea utilizar `cordova.require` para importar otras partes de tus plugins en tu código JavaScript. El nombre del módulo para un `<js-module>` es su plugin `id` seguido por el valor de `name` . Para el ejemplo anterior, con un `id` de `chrome.socket` , el nombre del módulo es`chrome.socket.Socket`. + +* Se permiten tres etiquetas en `<js-module>` : + + * `<clobbers target="some.value"/>`indica que el `module.exports` se inserta en la `window` de objetos como `window.some.value` . Usted puede tener tantos `<clobbers>` como usted tiene gusto. Cualquier objeto no está disponible en `window` es creado. + + * `<merges target="some.value"/>`indica que el módulo debe fusionarse con cualquier valor existente en `window.some.value` . Si ya existe alguna clave, versión del módulo reemplaza el original. Usted puede tener tantos `<merges>` como usted tiene gusto. Cualquier objeto no está disponible en `window` es creado. + + * `<runs/>`significa que el código debe especificarse con `cordova.require` , pero no instalado en el `window` objeto. Esto es útil al inicializar el módulo, adjuntar controladores de eventos o de lo contrario. Sólo puede tener hasta una `<runs/>` etiqueta. Tenga en cuenta que incluye un `<runs/>` con `<clobbers/>` o `<merges/>` es redundante, puesto que también `cordova.require` su módulo. + + * Un vacÃo `<js-module>` todavÃa las cargas y se puede acceder en otros módulos a través de`cordova.require`. + +Si `src` no se resuelve en un archivo existente, plugman se detiene y revierte la instalación, emite una notificación del problema y sale con un código distinto de cero. + +Anidación `<js-module>` elementos dentro de `<platform>` declara enlaces especÃficos a una plataforma JavaScript módulo. + +## *dependencia* Elemento + +El `<dependency>` etiqueta le permite especificar otros plugins de los que depende el plugin actual. Mientras que las versiones futuras accederán a ellos desde los repositorios de plugin, en el corto plazo plugins se hace directamente referencia como URL por `<dependency>` etiquetas. Ellos están formateados como sigue: + + <dependency id="com.plugin.id" url="https://github.com/myuser/someplugin"; commit="428931ada3891801" subdir="some/path/here" /> + + +* `id`: proporciona el ID del plugin. Debe ser único en el mundo y expresa en estilo de dominio reverso. Mientras que en la actualidad ninguna de estas restricciones se aplica, puede ser en el futuro. + +* `url`: Una dirección URL para el plugin. Esto debe hacer referencia un repositorio git, que plugman los intentos de clonar. + +* `commit`: Se trata de cualquier referencia de git entendido por `git checkout` : nombre de una rama o etiqueta (por ejemplo, `master` , `0.3.1` ), o una confirmación hash (por ejemplo,`975ddb228af811dd8bb37ed1dfd092a3d05295f9`). + +* `subdir`: Especifica que la dependencia de destino plugin existe como un subdirectorio del repositorio git. Esto es útil porque permite que el repositorio que contiene varios plugins relacionados, cada uno especificado individualmente. + +En el futuro, se introducirán las limitaciones de la versión y existirá un repositorio plugin para buscar por nombre en lugar de URLs explÃcitas de apoyo. + +### Dependencia relativa caminos + +Si establece la `url` de un `<dependency>` la etiqueta para `"."` y proporcionar una `subdir` , se instala el plugin dependiente del mismo local o remoto CVS como el plugin de padres que especifica la `<dependency>` etiqueta. + +Tenga en cuenta que el `subdir` siempre especifica una ruta relativa a la *raÃz* del repositorio git, no el plugin de padres. Esto es cierto incluso si ha instalado el plugin con una ruta local directamente a él. Plugman encuentra la raÃz del repositorio git y luego encuentra el otro plugin de allÃ. + +## *plataforma* Elemento + +El `<platform>` etiqueta identifica las plataformas que han asociado código nativo o requerir modificaciones en sus archivos de configuración. Herramientas utilizando esta especificación pueden identificar las plataformas soportadas e instalar el código en los proyectos de Córdoba. + +Plugins sin `<platform>` etiquetas se asumen para ser sólo de JavaScript y por lo tanto, instalable en cualquier y todas las plataformas. + +Una etiqueta de plataforma de muestra: + + <platform name="android"> + <!-- android-specific elements --> + </platform> + <platform name="ios"> + <!-- ios-specific elements --> + </platform> + + +La necesaria `name` atributo identifica una plataforma como apoyo, asociando los niños del elemento con esa plataforma. + +Nombres de la plataforma deben estar en minúsculas. Nombres de plataforma, como arbitrariamente elegidos, se enumeran: + +* Amazonas-fireos +* Android +* blackberry10 +* iOS +* wp8 +* windows8 + +## *archivo de código fuente* Elemento + +El `<source-file>` elemento identifica código ejecutable que debe instalarse en un proyecto. Ejemplos: + + <!-- android --> + <source-file src="src/android/Foo.java" + target-dir="src/com/alunny/foo" /> + <!-- ios --> + <source-file src="src/ios/CDVFoo.m" /> + <source-file src="src/ios/someLib.a" framework="true" /> + <source-file src="src/ios/someLib.a" compiler-flags="-fno-objc-arc" /> + + +Soporta los siguientes atributos: + +* `src`(requerido): Ubicación del archivo relativa a `plugin.xml` . Si el `src` no se encuentra archivo, plugman se detiene y revierte la instalación, emite una notificación sobre el problema y sale con un código distinto de cero. + +* `target-dir`: Un directorio en el que deben copiarse los archivos, relativo a la raÃz del proyecto Córdoba. En la práctica, esto es muy importante para las plataformas basadas en Java, donde un archivo en el `com.alunny.foo` paquete estará situado en la `com/alunny/foo` directorio. Para plataformas donde el directorio de origen no es importante, debe omitirse este atributo. + + Como con los activos, si la `target` de un `source-file` sobrescribir un archivo existente, plugman se detiene y revierte la instalación, emite una notificación sobre el problema y sale con un código distinto de cero. + +* `framework`(sólo en iOS): Si a `true` , también agrega el archivo especificado como un marco para el proyecto. + +* `compiler-flags`(sólo en iOS): si sistema, asigna los parámetros de compilador especificado para el archivo de origen en particular. + +## *archivo de configuración* Elemento + +Identifica un archivo de configuración basado en XML para ser modificado, donde en ese documento la modificación debe ocurrir, y qué deberÃa ser modificado. + +Dos tipos de archivos que han sido probados para la modificación de este elemento son `xml` y `plist` archivos. + +El `config-file` elemento sólo permite añadir nuevos niños a un árbol de documentos XML. Los niños son literales XML que se insertará en el documento de destino. + +Ejemplo de XML: + + <config-file target="AndroidManifest.xml" parent="/manifest/application"> + <activity android:name="com.foo.Foo" android:label="@string/app_name"> + <intent-filter> + </intent-filter> + </activity> + </config-file> + + +Ejemplo de `plist` : + + <config-file target="*-Info.plist" parent="CFBundleURLTypes"> + <array> + <dict> + <key>PackageName</key> + <string>$PACKAGE_NAME</string> + </dict> + </array> + </config-file> + + +Soporta los siguientes atributos: + +* `target`: + + El archivo a modificar y la ruta de acceso relativa a la raÃz del proyecto Córdoba. + + El destino puede incluir comodines ( `*` ) elementos. En este caso, plugman recursivamente busca a través de la estructura de directorios del proyecto y utiliza al primer partido. + + En iOS, la ubicación de los archivos de configuración en relación con la raÃz del directorio del proyecto no se conoce, asà que especifica un objetivo de `config.xml` decide`cordova-ios-project/MyAppName/config.xml`. + + Si el archivo especificado no existe, la herramienta pasa por alto el cambio en la configuración y continúa la instalación. + +* `parent`: Un selector XPath hacen referencia a los padres de los elementos a añadir al archivo config. Si utilizas selectores absolutos, puede utilizar un comodÃn ( `*` ) para especificar el elemento raÃz, por ejemplo,`/*/plugins`. + + Para `plist` archivos, el `parent` determina bajo qué clave primaria debe insertarse el XML especificado. + + Si el selector no resuelve a un niño de documento especificado, la herramienta se detiene y revierte el proceso de instalación, emite una advertencia y sale con un código distinto de cero. + +* `after`: Una lista priorizada de hermanos aceptados después de lo cual al añadir el fragmento de XML. Ãtil para especificar los cambios en los archivos que requieren estricta ordenación de elementos XML como <http://msdn.microsoft.com/en-us/library/windowsphone/develop/ff769509%28v=vs.105%29.aspx#BKMK_EXTENSIONSelement> + +La plataforma de Windows soporta dos atributos adicionales (ambos opcional) cuando afectan la meta-nombre `package.appxmanifest`: + +El atributo de `device-target` indica que el sólo debe incluir al construir para el tipo de dispositivo de destino especificado. Los valores admitidos son `win`, `phone`o `all`. + +El atributo de `versions` indica que sólo se modificara manifiestos de aplicación para las versiones especÃficas de Windows para las versiones que coinciden con la cadena de versión especificada. Valor puede ser cualquier cadena de nodo válida versión semántica gama. + +Ejemplos del uso de estos atributos especÃficos de Windows: + + <config-file target="package.appxmanifest" parent="/Package/Capabilities" versions="<8.1.0"> + <Capability Name="picturesLibrary" /> + <DeviceCapability Name="webcam" /> + </config-file> + <config-file target="package.appxmanifest" parent="/Package/Capabilities" versions=">=8.1.0" device-target="phone"> + <DeviceCapability Name="webcam" /> + </config-file> + + +El ejemplo anterior establecerá pre-8.1 plataformas (Windows 8, especÃficamente) que requieren la capacidad de dispositivo `webcam` y la capacidad general de `picturesLibrary` y la capacidad de dispositivo `webcam` se aplican sólo a Windows 8.1 proyectos que construcción para Windows Phone. Windows desktop 8.1 sistemas son sin modificar. + +## *plugins-plist* Elemento + +Es *anticuado* ya que sólo se aplica a cordova-ios 2.2.0 y por debajo. Utilice la etiqueta `< archivo config - >` para las nuevas versiones de Córdoba. + +Ejemplo: + + <config-file target="config.xml" parent="/widget/plugins"> + <feature name="ChildBrowser"> + <param name="ios-package" value="ChildBrowserCommand"/> + </feature> + </config-file> + + +Especifica una clave y el valor para anexar el archivo correcto `AppInfo.plist` en un proyecto de Cordova iOS. Por ejemplo: + + <plugins-plist key="Foo" string="CDVFoo" /> + + +## Elementos de *archivo de recursos* y *archivo de encabezado* + +Como archivos de código fuente, pero especÃficamente para plataformas como iOS que distinguen entre archivos de código fuente, encabezados y recursos. iOS ejemplos: + + <resource-file src="CDVFoo.bundle" /> + <resource-file src="CDVFooViewController.xib" /> + <header-file src="CDVFoo.h" /> + + +Ejemplo de Android: + + <resource-file src="FooPluginStrings.xml" target="res/values/FooPluginStrings.xml" /> + + +## *lib-archivo* Elemento + +Como fuente de recursos y archivos de encabezado, pero especÃficamente para plataformas como BlackBerry 10 que usan las bibliotecas generado por el usuario. Ejemplos: + + <lib-file src="src/BlackBerry10/native/device/libfoo.so" arch="device" /> + <lib-file src="src/BlackBerry10/native/simulator/libfoo.so" arch="simulator" /> + + +Atributos soportados: + +* `src`(obligatorio): la ubicación del archivo relativa a `plugin.xml` . Si `src` no se encuentra, plugman se detiene y revierte la instalación, problemas de una advertencia sobre el problema y sale con un código distinto de cero. + +* `arch`: La arquitectura para que la `.so` archivo se ha construido, ya sea `device` o`simulator`. + +Para la plataforma Windows, el elemento `< lib-file >` permite la inclusión de un `< SDKReference >` en los archivos de proyecto de Windows generados. + +Atributos soportados: + +* `src`(requerido): el nombre del SDK para incluir (que se utilizará como valor de la `Include` atributo de la generado `<SDKReference>` elemento). + +* `arch`: Indica que el `<SDKReference>` sólo debe incluir al edificio de la arquitectura especificada. Los valores admitidos son `x86` , `x64` o`ARM`. + +* `device-target`: Indica que el `<SDKReference>` sólo debe incluir al edificio para el tipo de dispositivo de destino especificado. Los valores admitidos son `win` (o `windows` ), `phone` o`all`. + +* `versions`: Indica que el `<SDKReference>` sólo debe incluir al construir las versiones que coinciden con la cadena de versión especificado. Valor puede ser cualquier cadena de rango de nodo válido versión semántica. + +Ejemplos: + + <lib-file src="Microsoft.WinJS.2.0, Version=1.0" arch="x86" /> + <lib-file src="Microsoft.WinJS.2.0, Version=1.0" versions=">=8.1" /> + <lib-file src="Microsoft.WinJS.2.0, Version=1.0" target="phone" /> + <lib-file src="Microsoft.WinJS.2.0, Version=1.0" target="win" versions="8.0" arch="x86" /> + + +## *marco* Elemento + +Identifica un marco (generalmente parte de la plataforma/OS) de la cual depende el plugin. + +El atributo opcional `custom` es un valor booleano que indica si el marco es que se incluye como parte de los archivos de plugin (por lo tanto no es un marco de sistema). + +### *marco* para iOS + + <framework src="libsqlite3.dylib" /> + <framework src="social.framework" weak="true" /> + <framework src="relative/path/to/my.framework" custom="true" /> + + +El atributo opcional `weak` es un valor booleano que indica si el marco debe vincularse débil. El valor predeterminado es `false`. + +### *marco* para Android + +En Android (a partir de [email protected]), *marco* etiquetas se utilizan para incluir las dependencias de Maven, o incluir proyectos de biblioteca incorporada. + +Ejemplos: + + <!-- Depend on latest version of GCM from play services --> + <framework src="com.google.android.gms:play-services-gcm:+" /> + <!-- Depend on v21 of appcompat-v7 support library --> + <framework src="com.android.support:appcompat-v7:21+" /> + <!-- Depend on library project included in plugin --> + <framework src="relative/path/FeedbackLib" custom="true" /> + + +*marco* puede utilizarse también para tener archivos personalizados .gradle sub-incluidos en el principal archivo del proyecto .gradle: + + <framework src="relative/path/rules.gradle" custom="true" type="gradleReference" /> + + +Para [email protected] (ANT-proyectos): + +El atributo opcional `type` es una cadena que indica el tipo de marco para agregar. Actualmente, sólo `projectReference` es compatible y sólo para Windows. Usando `custom='true'` y `tipo = 'projectReference'` se agregue una referencia al proyecto que se agregarán a la compilación + enlace pasos del proyecto cordova. Esencialmente es la única forma actualmente que un marco 'custom' puede hacer objetivo a múltiples arquitecturas como se construyen explÃcitamente como una dependencia por la aplicación de Córdoba hace referencia a. + +El opcional `parent` establece la ruta de acceso relativa al directorio que contiene el sub proyecto para agregar la referencia. El valor predeterminado es `.`, es decir, el proyecto de aplicación. Permite añadir referencias entre proyectos de la sub como en este ejemplo: + + <framework src="extras/android/support/v7/appcompat" custom="false" parent="FeedbackLib" /> + + +### *marco* para Windows + +La plataforma de Windows admite tres atributos adicionales (opcionales) para refinar cuando debe incluirse el marco: + + <framework src="path/to/project/LibProj.csproj" custom="true" type="projectReference"/> + + +El `arch` atributo indica que el marco sólo se incluyera al edificio para la arquitectura especificada. Los valores admitidos son `x86` , `x64` o`ARM`. + +El atributo de `device-target` indica que el sólo debe incluir al construir para el tipo de dispositivo de destino especificado. Los valores admitidos son `win` (o `windows` ), `phone` o`all`. + +El atributo de `versions` indica que el marco sólo debe ser incluido al construir versiones que coinciden con la cadena de versión especificada. Valor puede ser cualquier cadena de rango de nodo válido versión semántica. + +Ejemplos de uso de estos atributos especÃficos de Windows: + + <framework src="src/windows/example.dll" arch="x64" /> + <framework src="src/windows/example.dll" versions=">=8.0" /> + <framework src="src/windows/example.vcxproj" type="projectReference" target="win" /> + <framework src="src/windows/example.vcxproj" type="projectReference" target="all" versions="8.1" arch="x86" /> + + +## *info* Elemento + +Información adicional a los usuarios. Esto es útil cuando se requieren pasos adicionales que no se pueden automatizar fácilmente o están más allá del alcance de plugman. Ejemplos: + + <info> + You need to install __Google Play Services__ from the `Android Extras` section using the Android SDK manager (run `android`). + + You need to add the following line to the `local.properties`: + + android.library.reference.1=PATH_TO_ANDROID_SDK/sdk/extras/google/google_play_services/libproject/google-play-services_lib + </info> + + +## El elemento *hook* + +Representa la secuencia de comandos personalizada que será llamado por Córdoba cuando se produce cierta acción (por ejemplo, después se agrega el plugin o plataforma preparar lógica se invoca). Esto es útil cuando se necesita extender la funcionalidad de Cordova por defecto. Para más información vea la guÃa de los ganchos. + + <hook type="after_plugin_install" src="scripts/afterPluginInstall.js" /> + + +## Variables + +En ciertos casos, puede necesitar un plugin hacer cambios de configuración depende de la aplicación de destino. Por ejemplo, para registrarse en C2DM en Android, una aplicación cuya id de paquete es `com.alunny.message` requerirÃa un permiso como: + + <uses-permission android:name="com.alunny.message.permission.C2D_MESSAGE"/> + + +En estos casos donde no se conoce el contenido insertado en el archivo `plugin.xml` antes de tiempo, variables pueden indicarse por un signo de dólar seguido por una serie de letras, dÃgitos o subrayados. Para el ejemplo anterior, el archivo `plugin.xml` incluir esta etiqueta: + + <uses-permission android:name="$PACKAGE_NAME.permission.C2D_MESSAGE"/> + + +plugman substituye referencias a variables con el valor especificado o la cadena vacÃa si no se encuentra. El valor de la referencia de variable puede ser detectado (en este caso, desde el archivo `AndroidManifest.xml` ) o especificado por el usuario de la herramienta; el proceso exacto depende de la herramienta especial. + +plugman puede solicitar a los usuarios especificar variables requiere de un plugin. Por ejemplo, las llaves de la API para C2M y Google Maps pueden especificarse como un argumento de lÃnea de comandos: + + plugman --platform android --project /path/to/project --plugin name|git-url|path --variable API_KEY=!@CFATGWE%^WGSFDGSDFW$%^#$%YTHGsdfhsfhyer56734 + + +Para realizar la variable obligatoria, la etiqueta `< platform >` debe contener una etiqueta `< preference >` . Por ejemplo: + + <preference name="API_KEY" /> + + +plugman comprueba que estas preferencias requiere pasan en. Si no, debe advertir al usuario de cómo pasar la variable y la salida con un código distinto de cero. + +Ciertos nombres de variable deben ser reservados, que se enumeran a continuación. + +## $PACKAGE_NAME + +El identificador único de estilo de dominio reverso para el paquete, correspondiente a la `CFBundleIdentifier` de iOS o el atributo de `paquete` del elemento de nivel superior `se manifiestan` en el archivo `AndroidManifest.xml` . \ No newline at end of file http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/f061b980/www/docs/es/edge/config.json ---------------------------------------------------------------------- diff --git a/www/docs/es/edge/config.json b/www/docs/es/edge/config.json deleted file mode 100644 index 159c7ad..0000000 --- a/www/docs/es/edge/config.json +++ /dev/null @@ -1,18 +0,0 @@ -{ - "language": "Español", - "merge": { - "events.md": [ - "cordova/events/events.md", - "cordova/events/events.deviceready.md", - "cordova/events/events.pause.md", - "cordova/events/events.resume.md", - "cordova/events/events.backbutton.md", - "cordova/events/events.menubutton.md", - "cordova/events/events.searchbutton.md", - "cordova/events/events.startcallbutton.md", - "cordova/events/events.endcallbutton.md", - "cordova/events/events.volumedownbutton.md", - "cordova/events/events.volumeupbutton.md" - ] - } -} --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
