http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/f061b980/www/docs/es/edge/cordova/storage/sqlresultsetrowlist/sqlresultsetrowlist.md ---------------------------------------------------------------------- diff --git a/www/docs/es/edge/cordova/storage/sqlresultsetrowlist/sqlresultsetrowlist.md b/www/docs/es/edge/cordova/storage/sqlresultsetrowlist/sqlresultsetrowlist.md deleted file mode 100644 index b05baa8..0000000 --- a/www/docs/es/edge/cordova/storage/sqlresultsetrowlist/sqlresultsetrowlist.md +++ /dev/null @@ -1,75 +0,0 @@ ---- -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: SQLResultSetRowList ---- - -# SQLResultSetRowList - -Una de las propiedades de la `[SQLResultSet](../sqlresultset/sqlresultset.html)` que contiene las filas devueltas desde una consulta SQL. - -## Propiedades - -* **length**: el número de filas devueltas por la consulta SQL. - -## Métodos - -* **item**: devuelve la fila en el Ãndice especificado representado por un objeto JavaScript. - -## Detalles - -El `SQLResultSetRowList` contiene los datos devueltos de una instrucción SQL `select`. El objeto contiene una propiedad de `longitud` que indica cuántas filas devuelve la instrucción `select`. Para obtener una fila de datos, llame al método de `item` para especificar un Ãndice. Devuelve un JavaScript `Object` cuyas propiedades son las columnas de la base de datos que la instrucción `select` fue ejecutada contra. - -## Plataformas soportadas - -* Android -* BlackBerry WebWorks (OS 6.0 o superior) -* iOS -* Tizen - -## Ejecutar SQL ejemplo rápido - - function queryDB(tx) {tx.executeSql ('SELECT * de DEMO', [], querySuccess, errorCB);} - - function querySuccess (tx, resultados) {var len = results.rows.length; - Console.log ("table DEMO:" len + "filas encontradas."); - para (var i = 0; < len; i ++) {console.log ("fila =" + i + "ID =" + results.rows.item (i) .id + "datos =" + results.rows.item(i).data); - errorCB(err) función}} {alert ("Error al procesar SQL:" + err.code); - } var db = window.openDatabase ("Database", "1.0", "Demo Córdova", 200000); - DB.Transaction (queryDB, errorCB); - - -## Ejemplo completo - - <!DOCTYPE html >< html >< cabeza >< tÃtulo > almacenamiento ejemplo < / tÃtulo >< de la escritura de tipo = "text/javascript" charset = "utf-8" src="cordova.js" >< / script >< de la escritura de tipo = "text/javascript" charset = "utf-8" > / / espera para que las bibliotecas del dispositivo API cargar / / document.addEventListener ("deviceready", onDeviceReady, false); - - / / Rellenar la base de datos / / function populateDB(tx) {tx.executeSql ('DROP TABLE IF EXISTS DEMO'); - tx.executeSql ('crear tabla si no existe DEMO (id único, data)'); - tx.executeSql (' introduzca en DEMO (identificación, datos) valores (1, "primera fila")'); - tx.executeSql ('introduzca en DEMO (identificación, datos) VALUES (2, "Segunda fila")'); - } / / Consulta la base de datos / / function queryDB(tx) {tx.executeSql ('SELECT * de DEMO', [], querySuccess, errorCB); - } / / Consulta el callback de éxito / / function querySuccess (tx, resultados) {var len = results.rows.length; - Console.log ("table DEMO:" len + "filas encontradas."); - para (var i = 0; < len; i ++) {console.log ("fila =" + i + "ID =" + results.rows.item (i) .id + "datos =" + results.rows.item(i).data); - }} / / Callback de error de transacción / / function errorCB(err) {console.log ("Error al procesar SQL:" + err.code); - } / / Callback éxito de transacción / / function successCB() {var db = window.openDatabase ("Database", "1.0", "Demo Córdova", 200000); - DB.Transaction (queryDB, errorCB); - } / / dispositivo APIs están disponibles / / function onDeviceReady() {var db = window.openDatabase ("Database", "1.0", "Demo Córdova", 200000); - DB.Transaction (populateDB, errorCB, successCB); - } < /script >< / cabeza >< cuerpo >< h1 > ejemplo < / h1 >< p > base de datos < /p >< cuerpo / >< / html > \ No newline at end of file
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/f061b980/www/docs/es/edge/cordova/storage/sqltransaction/sqltransaction.md ---------------------------------------------------------------------- diff --git a/www/docs/es/edge/cordova/storage/sqltransaction/sqltransaction.md b/www/docs/es/edge/cordova/storage/sqltransaction/sqltransaction.md deleted file mode 100644 index d0e0d06..0000000 --- a/www/docs/es/edge/cordova/storage/sqltransaction/sqltransaction.md +++ /dev/null @@ -1,111 +0,0 @@ ---- -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: SQLTransaction ---- - -# SQLTransaction - -Permite la ejecución de sentencias SQL contra la base de datos. - -## Métodos - -* **executeSql**: ejecuta una instrucción SQL. - -## Detalles - -El método de devolución de llamada especificado llamar método de un objeto de `Database` transacción, pasa un objeto `SQLTransaction`. - -## Plataformas soportadas - -* Android -* BlackBerry WebWorks (OS 6.0 o superior) -* iOS -* Tizen - -## Ejecutar SQL ejemplo rápido - - function populateDB(tx) { - tx.executeSql('DROP TABLE IF EXISTS DEMO'); - tx.executeSql('CREATE TABLE IF NOT EXISTS DEMO (id unique, data)'); - tx.executeSql('INSERT INTO DEMO (id, data) VALUES (1, "First row")'); - tx.executeSql('INSERT INTO DEMO (id, data) VALUES (2, "Second row")'); - } - - function errorCB(err) { - alert("Error processing SQL: "+err); - } - - function successCB() { - alert("success!"); - } - - var db = window.openDatabase("Database", "1.0", "Cordova Demo", 200000); - db.transaction(populateDB, errorCB, successCB); - - -## Ejemplo completo - - <!DOCTYPE html> - <html> - <head> - <title>Storage Example</title> - - <script type="text/javascript" charset="utf-8" src="cordova.js"></script> - <script type="text/javascript" charset="utf-8"> - - // Wait for device API libraries to load - // - document.addEventListener("deviceready", onDeviceReady, false); - - // device APIs are available - // - function onDeviceReady() { - var db = window.openDatabase("Database", "1.0", "Cordova Demo", 200000); - db.transaction(populateDB, errorCB, successCB); - } - - // Populate the database - // - function populateDB(tx) { - tx.executeSql('DROP TABLE IF EXISTS DEMO'); - tx.executeSql('CREATE TABLE IF NOT EXISTS DEMO (id unique, data)'); - tx.executeSql('INSERT INTO DEMO (id, data) VALUES (1, "First row")'); - tx.executeSql('INSERT INTO DEMO (id, data) VALUES (2, "Second row")'); - } - - // Transaction error callback - // - function errorCB(err) { - alert("Error processing SQL: "+err); - } - - // Transaction success callback - // - function successCB() { - alert("success!"); - } - - </script> - </head> - <body> - <h1>Example</h1> - <p>SQLTransaction</p> - </body> - </html> \ No newline at end of file http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/f061b980/www/docs/es/edge/cordova/storage/storage.md ---------------------------------------------------------------------- diff --git a/www/docs/es/edge/cordova/storage/storage.md b/www/docs/es/edge/cordova/storage/storage.md deleted file mode 100644 index 73fd61c..0000000 --- a/www/docs/es/edge/cordova/storage/storage.md +++ /dev/null @@ -1,68 +0,0 @@ ---- -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: Almacenamiento de información ---- - -# Almacenamiento de información - -> Un [Resumen](../../guide/overview/index.html) de las opciones de almacenamiento para Córdoba. - -Almacenamiento varias APIs están disponibles para aplicaciones de Córdoba. Ver [html5rocks][1]. para una visión más completa y ejemplos. - - [1]: http://www.html5rocks.com/en/features/storage - -## LocalStorage - -También conocido como *web storage*, *almacenamiento de información simple*, o por su interfaz alternativa de *almacenamiento de las sesiones* , esta API proporciona almacenamiento par clave-valor sÃncrono y está disponible en implementaciones WebView subyacentes. Consulte [la especificación W3C][2] para más detalles. - - [2]: http://www.w3.org/TR/webstorage/ - -## WebSQL - -Esta API está disponible en la vista Web subyacente. La [Especificación de base de datos de SQL Web][3] ofrece más tablas de base de datos completa accede a través de consultas SQL. - - [3]: http://dev.w3.org/html5/webdatabase/ - -WebSQL de la ayuda de las siguientes plataformas: - -* Android -* BlackBerry 10 -* iOS -* Tizen - -## IndexedDB - -Esta API está disponible en la vista Web subyacente. [Indexadas DB][4] ofrece más funciones que LocalStorage pero menos de WebSQL. - - [4]: http://www.w3.org/TR/IndexedDB/ - -Las siguientes plataformas soportan IndexedDB: - -* BlackBerry 10 -* Firefox OS -* Windows Phone 8 -* Windows 8 - -## Opciones basadas en plugin - -Además el almacenamiento que APIs mencionadas anteriormente, el [Archivo API][5] permite a los datos del caché en el sistema de archivos local. Otros [plugins Cordova][6] proporcionan opciones de almacenamiento similares. - - [5]: https://github.com/apache/cordova-plugin-file/blob/master/doc/index.md - [6]: http://plugins.cordova.io/ \ No newline at end of file http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/f061b980/www/docs/es/edge/cordova/storage/storage.opendatabase.md ---------------------------------------------------------------------- diff --git a/www/docs/es/edge/cordova/storage/storage.opendatabase.md b/www/docs/es/edge/cordova/storage/storage.opendatabase.md deleted file mode 100644 index bd61ec4..0000000 --- a/www/docs/es/edge/cordova/storage/storage.opendatabase.md +++ /dev/null @@ -1,72 +0,0 @@ ---- -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: openDatabase ---- - -# openDatabase - -Devuelve un nuevo objeto de `base de datos`. - - var dbShell = window.openDatabase(database_name, database_version, database_displayname, database_size); - - -## Descripción - -El método crea un nuevo SQL Database Lite y devuelve un objeto de `Database` que permite la manipulación de los datos. - -## Plataformas soportadas - -* Android -* BlackBerry WebWorks (OS 6.0 y superior) -* iOS -* Tizen - -## Ejemplo rápido - - var db = window.openDatabase("test", "1.0", "Test DB", 1000000); - - -## Ejemplo completo - - <!DOCTYPE html> - <html> - <head> - <title>Storage Example</title> - - <script type="text/javascript" charset="utf-8" src="cordova.js"></script> - <script type="text/javascript" charset="utf-8"> - - // Wait for device API libraries to load - // - document.addEventListener("deviceready", onDeviceReady, false); - - // device APIs are available - // - function onDeviceReady() { - var db = window.openDatabase("test", "1.0", "Test DB", 1000000); - } - - </script> - </head> - <body> - <h1>Example</h1> - <p>Open Database</p> - </body> - </html> \ No newline at end of file http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/f061b980/www/docs/es/edge/guide/appdev/hooks/index.md ---------------------------------------------------------------------- diff --git a/www/docs/es/edge/guide/appdev/hooks/index.md b/www/docs/es/edge/guide/appdev/hooks/index.md deleted file mode 100644 index 4cb33d8..0000000 --- a/www/docs/es/edge/guide/appdev/hooks/index.md +++ /dev/null @@ -1,260 +0,0 @@ ---- -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: Ganchos de guÃa ---- - -# Ganchos de guÃa - -Cordova Hooks representan secuencias especiales que podrÃan agregarse por su aplicación y los desarrolladores del plugin o incluso por su propia construcción de sistema para personalizar comandos de Córdoba. Scripts gancho podrÃan definirse mediante la adición a la carpeta predefinida especial ( `/hooks` ) o a través de archivos de configuración ( `config.xml` y `plugin.xml` ) y en serie en el siguiente orden: - - * Aplicación de ganchos de `/hooks` ; - * Aplicación de ganchos de `config.xml` ; - * Ganchos de plugin de`plugins/.../plugin.xml`. - -**Nota**: `/hooks` directorio se considera obsoleta en favor de los elementos de gancho en config.xml y plugin.xml. - -## Tipos de gancho apoyado - -Se admiten los siguientes tipos de gancho: - - after_build - after_compile - after_clean - after_docs - after_emulate - after_platform_add - after_platform_rm - after_platform_ls - after_plugin_add - after_plugin_ls - after_plugin_rm - after_plugin_search - after_plugin_install // Plugin hooks in plugin.xml are executed for a plugin being installed only - after_prepare - after_run - after_serve - before_build - before_clean - before_compile - before_docs - before_emulate - before_platform_add - before_platform_rm/ - before_platform_ls - before_plugin_add - before_plugin_ls - before_plugin_rm - before_plugin_search/ - before_plugin_install // Plugin hooks in plugin.xml are executed for a plugin being installed only - before_plugin_uninstall // Plugin hooks in plugin.xml are executed for a plugin being uninstalled only - before_prepare - before_run - before_serve - pre_package // Windows and Windows Phone only - - -## Maneras de definir ganchos - -### Via `/hooks` directorio - -**Nota**: este método se considera obsoleta en favor de los elementos de gancho en config.xml y plugin.xml. - -Para ejecutar la acción personalizada cuando se tipo gancho correspondiente, usar tipo gancho como un nombre para una subcarpeta dentro del directorio 'ganchos' y usted la escritura de archivo, por ejemplo: - - # script file will be automatically executed after each build - hooks/after_build/after_build_custom_action.js - - -Al usar estos ganchos, siempre se ejecutará como archivos ejecutables, no como módulos JavaScript. **Recuerde**: hacer las secuencias de comandos ejecutable en este caso. - -### Archivo config.XML - -Ganchos pueden ser definidos en `archivo config.xml` mediante elementos `< hook >` , por ejemplo de proyecto: - - <hook type="before_build" src="scripts/appBeforeBuild.bat" /> - <hook type="before_build" src="scripts/appBeforeBuild.js" /> - <hook type="before_plugin_install" src="scripts/appBeforePluginInstall.js" /> - - <platform name="wp8"> - <hook type="before_build" src="scripts/wp8/appWP8BeforeBuild.bat" /> - <hook type="before_build" src="scripts/wp8/appWP8BeforeBuild.js" /> - <hook type="before_plugin_install" src="scripts/wp8/appWP8BeforePluginInstall.js" /> - ... - </platform> - - <platform name="windows8"> - <hook type="before_build" src="scripts/windows8/appWin8BeforeBuild.bat" /> - <hook type="before_build" src="scripts/windows8/appWin8BeforeBuild.js" /> - <hook type="before_plugin_install" src="scripts/windows8/appWin8BeforePluginInstall.js" /> - ... - </platform> - - -### Ganchos de plugin (plugin.xml) - -Como desarrollador del plugin que puede definir hook scripts usando elementos `< hook >` en un `plugin.xml` que: - - <hook type="before_plugin_install" src="scripts/beforeInstall.js" /> - <hook type="after_build" src="scripts/afterBuild.js" /> - - <platform name="wp8"> - <hook type="before_plugin_install" src="scripts/wp8BeforeInstall.js" /> - <hook type="before_build" src="scripts/wp8BeforeBuild.js" /> - ... - </platform> - - -`before_plugin_install`, `after_plugin_install`, `before_plugin_uninstall` plugin ganchos despedirá exclusivamente para el plugin está instalado/desinstalado. - -## Interfaz de comandos - -### Javascript - -Si vas a escribir ganchos usando Node.js debe utilizar la siguiente definición de módulo: - -```javascript -module.exports = function(context) { - ... -} -``` - -Usted puede hacer su async scipts con Q: - -```javascript -module.exports = function(context) { - var Q = context.requireCordovaModule('q'); - var deferral = new Q.defer(); - - setTimeout(function(){ - console.log('hook.js>> end'); - deferral.resolve(); - }, 1000); - - return deferral.promise; -} -``` - -objeto de `context` contiene un gancho tipo, ruta completa del script ejecutado, opciones de gancho, argumentos de lÃnea de comandos pasados a Córdova y el objeto de nivel superior "Córdoba": - -```json -{ - "hook": "before_plugin_install", - "scriptLocation": "c:\\script\\full\\path\\appBeforePluginInstall.js", - "cmdLine": "The\\exact\\command\\cordova\\run\\with arguments", - "opts": { - "projectRoot":"C:\\path\\to\\the\\project", - "cordova": { - "platforms": ["wp8"], - "plugins": ["com.plugin.withhooks"], - "version": "0.21.7-dev" - }, - "plugin": { - "id": "com.plugin.withhooks", - "pluginInfo": { - ... - }, - "platform": "wp8", - "dir": "C:\\path\\to\\the\\project\\plugins\\com.plugin.withhooks" - } - }, - "cordova": {...} -} - -``` - -`context.opts.plugin` objeto pasará sólo a scripts ganchos plugin. - -También puede requerir módulos adicionales de Córdoba en su script usando `context.requireCordovaModule` de la siguiente manera: - -```javascript -var Q = context.requireCordovaModule('q'); -``` - -**Nota**: nueva interfaz de escritura del módulo cargador se utiliza para los archivos `.js` definidos mediante `config.xml` o `plugin.xml` solamente. Por razones de compatibilidad gancho archivos especificados mediante carpetas de `/hooks` se ejecutan vÃa nodo child_process spawn, vea 'Non-javascript' la sección de abajo. - -### No-javascript - -**Nota**: le recomendamos escribir sus ganchos usando Node.js para que sean multiplataforma, ver sección 'Javascript'. - -Scripts de javascript no se ejecutan vÃa spawn child_process nodo del directorio raÃz del proyecto y tengan el root directory pasa como primer argumento. Todas las demás opciones se pasan al script usando variables de entorno: - - * CORDOVA_VERSION - la versión de Cordova-CLI. - * CORDOVA_PLATFORMS - lista de plataformas que el comando se aplica a separaron por comas (por ejemplo: android, ios). - * CORDOVA_PLUGINS - lista de plugin ID que el comando se aplica a separaron por comas (por ejemplo: org.apache.cordova.file, org.apache.cordova.file-transferencia) - * CORDOVA_HOOK - camino al gancho que está siendo ejecutado. - * CORDOVA_CMDLINE - los argumentos de lÃnea de comandos exactos pasados a Córdoba (p. ej.: cordova ejecutar ios--emular) - -Si una secuencia de comandos devuelve un código de salida distinto de cero, el comando de padre Córdova se interrumpirá. - -También, tenga en cuenta que incluso si trabajas en Windows, y en el caso de los scripts gancho no archivos bat (que se recomienda, si desea que las secuencias de comandos para trabajar en sistemas operativos no Windows) Cordova CLI esperarán una lÃnea shebang como la primera lÃnea para saber el intérprete debe utilizar para lanzar el script. La lÃnea de asunto debe coincidir con el siguiente ejemplo: - - #!/usr/bin/env [name_of_interpreter_executable] - - -## Ejemplo de uso - -Este ejemplo muestra el uso de ganchos Cordova al rastro a la salida de la consola el tamaño del archivo .apk generado para la plataforma Android. - -Crear aplicación de Cordova en blanco y agregue la siguiente definición en `config.xml` a Córdoba para ejecutar el script de `afterBuild.js` después de cada construcción de plataforma. - - <hook type="after_build" src="scripts/afterBuild.js" /> - - -Crear archivo `scripts/afterBuild.js` y agregar la siguiente aplicación. Utilizamos versión asincrónica del método `fs.stat` para demostrar cómo async funcionalidad podrÃa hacerse a través de ganchos. - - module.exports = function(ctx) { - // make sure android platform is part of build - if (ctx.opts.platforms.indexOf('android') < 0) { - return; - } - var fs = ctx.requireCordovaModule('fs'), - path = ctx.requireCordovaModule('path'), - deferral = ctx.requireCordovaModule('q').defer(); - - var platformRoot = path.join(ctx.opts.projectRoot, 'platforms/android'); - var apkFileLocation = path.join(platformRoot, 'build/outputs/apk/android-debug.apk'); - - fs.stat(apkFileLocation, function(err,stats) { - if (err) { - deferral.reject('Operation failed'); - } else { - console.log('Size of ' + apkFileLocation + ' is ' + stats.size +' bytes'); - deferral.resolve(); - } - }); - - return deferral.promise; - }; - - -Parámetro `ctx` en ejemplo anterior se pasa por Córdoba y representa el contexto de ejecución como la ruta completa del script, plataforma de destino, argumentos de lÃnea de comandos, etc. y también expone funcionalidad adicional ayudante. Vea la sección de `Interfaz de Script de` arriba para más detalles. - -Ahora puede añadir la plataforma android y ejecutar build. - - cordova platform add android - .. - cordova build - .. - Size of path\to\app\platforms\android\build\outputs\apk\android-debug.apk is 1821193 bytes - - -Aquà se encuentran más ejemplos de buen uso: - -<http://devgirl.org/2013/11/12/three-hooks-your-cordovaphonegap-project-needs/> \ No newline at end of file http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/f061b980/www/docs/es/edge/guide/appdev/privacy/index.md ---------------------------------------------------------------------- diff --git a/www/docs/es/edge/guide/appdev/privacy/index.md b/www/docs/es/edge/guide/appdev/privacy/index.md deleted file mode 100644 index 38fbb5e..0000000 --- a/www/docs/es/edge/guide/appdev/privacy/index.md +++ /dev/null @@ -1,60 +0,0 @@ ---- -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Ãa de privacidad ---- - -# GuÃa de privacidad - -Privacidad móvil es una cuestión fundamental que debe enfrentar cada desarrollador de la aplicación. Los usuarios esperan que su información privada sean recogido y tratado apropiadamente por su aplicación. También hay un creciente número de jurisdicciones que tienen ahora los requisitos legales sobre prácticas de privacidad móvil. - -Esta guÃa de privacidad de aplicación móvil debe considerarse una *cartilla* cuestiones algunos el más significativo. Se esbozan algunas mejores prácticas ampliamente aceptadas y proporciona referencias a otras guÃas más detalladas y referencias. - -* **PolÃtica de privacidad**: la aplicación debe incluir una polÃtica de privacidad que se ocupa de temas tales como qué tipo de información recopila la aplicación de o acerca de sus usuarios, cómo se utiliza esa información, con quienes se comparte y cómo los usuarios pueden tomar decisiones relacionadas con la privacidad dentro de la aplicación. Para facilitar la comprensión, debe utilizar lenguaje claro y evitar la jerga técnica. Usted debe hacer su polÃtica de privacidad disponible para los usuarios a revisar antes de descargar, como en la descripción de la aplicación en la app marketplace. Además, deberÃas hacer su polÃtica de privacidad disponible dentro de la aplicación en sà mismo. El tamaño limitado de dispositivo móvil muestra crea desafÃos para la visualización de las polÃticas de privacidad a los usuarios. Considerar el desarrollo de una *forma corta* de la polÃtica que incluye la información más importante y luego proporciona un enlace a la polÃtica de "formulario largo" para aquellos interesados en más detalles. Varios grupos están intentando desarrollar estándares basados en iconos para comunicar las prácticas de privacidad, que usted puede desear considerar una vez maduran de estas normas. - -* **Colección de información sensible**: colección de la aplicación de la información personal sensible suscita preocupaciones de privacidad importante. Ejemplos de información personal sensible información financiera, salud información e información de o acerca de los niños. También incluye información recopilada de algunos sensores y bases de datos suelen encontradas en dispositivos móviles y tabletas, como información de geolocalización, contactos/agenda, cámara/micrófono y fotografÃas y vÃdeos almacenados. Consulte las siguientes páginas de documentación para más información: [cámara][1], [captura][2], [contactos][3] y [geolocalización][4]. Generalmente, debe obtener el consentimiento expreso del usuario antes de recoger información sensible y, si es posible, provee un mecanismo de control que permite al usuario cambiar fácilmente los permisos. Sistemas operativos de la aplicación puede ayudar en algunos casos mediante la presentación de cuadros de diálogo de just-in-time que pedir el permiso del usuario antes de colección. En estos casos, asegúrese de tomar ventaja de cualquier oportunidad de personalizar el texto de la caja de diálogo para aclarar cómo la aplicación usa y, si procede, comparte dicha información. - -* **Evitar la sorpresa de usuario**: Si la aplicación recopila o utiliza la información de una manera que puede ser sorprendente para los usuarios teniendo en cuenta el propósito principal de la aplicación (por ejemplo, un reproductor de música que tiene acceso a fotografÃas almacenadas), usted debe tomar medidas similares como con la colección de información personal confidencial. Es decir, deberÃas considerar fuertemente el uso de cuadros de diálogo de just-in-time para informar al usuario sobre la colección o el uso de esa información y, si procede, proporcionan un control de privacidad correspondiente. - -* **Recopilación de datos de terceros o compartir**: Si la aplicación recoge información que se proporciona a otra empresa... como una plataforma de red social o una red de anuncios (por ejemplo, si su aplicación muestra publicidad)--se deben informar a los usuarios de esa colección y compartir. Como mÃnimo, su polÃtica de privacidad debe describir la recopilación de información y compartir y, si procede, ofrecer a sus usuarios la capacidad de control o opt-out de dicha recogida o compartir. - -* **Seguridad y limitación de la colección**: los usuarios confÃan su aplicación con su información y esperan que tome precauciones de seguridad apropiadas para protegerla. Una de las mejores maneras de evitar compromisos de seguridad de la información personal no es recoger la información en primer lugar a menos que su aplicación tiene una razón de negocios especÃficos y legÃtima para la colección. Para la información que necesitan para ser recogidos, asegúrese de que usted proporciona controles de seguridad apropiadas para proteger esa información, si se almacena en el dispositivo o en los servidores de back-end. También debe desarrollar una polÃtica de retención de datos adecuados que se implementa dentro de la aplicación y en los servidores de back-end. - - [1]: cordova_camera_camera.md.html - [2]: cordova_media_capture_capture.md.html - [3]: cordova_contacts_contacts.md.html - [4]: cordova_geolocation_geolocation.md.html - -Las siguientes son algunas guÃas de privacidad móvil ayuda adicional para los desarrolladores: - -* Procurador General de California, [privacidad on the Go: recomendaciones para el ecosistema móvil][5] - -* Centro para la democracia & tecnologÃa, el futuro del Foro de privacidad, [las prácticas recomendadas para los desarrolladores de aplicaciones móviles][6] - -* CTIA-The Wireless Association, [servicios basados en las mejores prácticas y directrices para la ubicación][7] - -* Comisión Federal de comercio, [privacidad móvil divulgaciones: construyendo confianza a través de la transparencia][8] - -* Futuro del Foro de la privacidad, [privacidad de aplicación][9] web - - [5]: http://oag.ca.gov/sites/all/files/pdfs/privacy/privacy_on_the_go.pdf - [6]: http://www.futureofprivacy.org/wp-content/uploads/Best-Practices-for-Mobile-App-Developers_Final.pdf - [7]: http://www.ctia.org/business_resources/wic/index.cfm/AID/11300 - [8]: http://www.ftc.gov/os/2013/02/130201mobileprivacyreport.pdf - [9]: http://www.applicationprivacy.org \ No newline at end of file http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/f061b980/www/docs/es/edge/guide/appdev/security/index.md ---------------------------------------------------------------------- diff --git a/www/docs/es/edge/guide/appdev/security/index.md b/www/docs/es/edge/guide/appdev/security/index.md deleted file mode 100644 index 4a51461..0000000 --- a/www/docs/es/edge/guide/appdev/security/index.md +++ /dev/null @@ -1,108 +0,0 @@ ---- -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Ãa de seguridad ---- - -# GuÃa de seguridad - -La siguiente guÃa incluye algunas mejores prácticas de seguridad que debe considerar al desarrollar una aplicación de Córdoba. Por favor, tenga en cuenta que la seguridad es un tema muy complicado y por lo tanto, esta guÃa no es exhaustiva. Si usted cree que puede contribuir a esta guÃa, sienta por favor libre de presentar un número de localizador de fallas de Cordova bajo ["Documentación"][1]. Esta guÃa está diseñada para ser aplicable al desarrollo general Cordova (todas las plataformas), pero tendrá en cuenta consideraciones especÃficas de la plataforma. - - [1]: https://issues.apache.org/jira/browse/CB/component/12316407 - -## Esta guÃa aborda los siguientes temas: - -* Lista blanca -* Iframes y el mecanismo de identificación de llamada -* Certificado de clavos -* Los certificados autofirmados -* Almacenamiento cifrado -* Consejos generales -* ArtÃculos recomendados y otros recursos - -## Lista blanca - -* Lea y entienda al manual lista blanca - -* Dominio whitelisting no funciona en Android API 10 y a continuación y WP8 para iframes y XMLHttpRequest. Esto significa que un atacante puede cargar cualquier tipo de dominio en un iframe y cualquier script en esa página dentro del iframe puede acceder directamente a objetos Cordova JavaScript y los objetos de Java nativos correspondientes. Debe tomar esto en consideración cuando la creación de aplicaciones para estas plataformas. En la práctica esto significa asegurándose de que se meta una API Android superior a 10, y que si es posible no utilice un iframe para cargar contenido externo - utilizan el plugin inAppBrowser u otros plugins de terceros. - -## Iframes y el mecanismo de identificación de llamada - -Si el contenido se sirve en un iframe desde un dominio en lista blanca, ese dominio tendrá acceso al puente Cordova nativo. Esto significa que si usted blanca una red de publicidad de terceros y servir los anuncios a través de un iframe, es posible que un anuncio malicioso será capaz de romper el iframe y llevar a cabo acciones maliciosas. Debido a esto, generalmente no debe usar iframes a menos que usted controla el servidor que aloja el contenido del iframe. También tenga en cuenta que existen plugins de terceros disponibles para apoyar las redes de publicidad. Tenga en cuenta que esta declaración no es verdadera para iOS, que intercepta todo, incluyendo las conexiones iframe. - -## Certificado de clavos - -Córdova no admite certificado verdadera fijación. La barrera principal para esto es una falta de API nativas en Android para interceptar conexiones SSL para realizar la comprobación del certificado del servidor. (Aunque es posible certificado de fijación en Android en Java utilizando JSSE, el webview en Android está escrito en C++, y las conexiones del servidor son manejadas para usted por el webview, asà que no cabe usar Java y JSSE allÃ.) Desde Apache Cordova pretende ofrecer APIs consistentes en múltiples plataformas, no tener una capacidad en una importante plataforma rompe esa consistencia. - -Hay formas para aproximar certificado fijación, tales como comprobación de que clave pública del servidor (huella digital) es el valor esperado cuando se inicia la aplicación o en otras varias veces durante la vida útil de su aplicación. Hay plugins de terceros disponibles para Córdoba que pueda hacer eso. Sin embargo, esto no es lo mismo como verdadero certificado de fijación que verifica automáticamente el valor esperado de cada conexión con el servidor. - -## Los certificados autofirmados - -No es recomendable utilizar certificados autofirmados en su servidor. Si usted desea SSL, entonces se recomienda que el servidor dispone de un certificado que ha sido debidamente firmado por un conocido CA (autoridad certificadora). La incapacidad de cierto anclaje certificado hace importante. - -La razón es que aceptando certificados autofirmados omite la validación de la cadena de certificado, que permite cualquier certificado de servidor ser considerado válido por el dispositivo. Esto abre la comunicación a los ataques man-in-the-middle. Resulta muy fácil para un hacker no solo interceptar y leer toda la comunicación entre el dispositivo y el servidor, sino también modificar la comunicación. El aparato nunca sabrá que esto sucede porque no Verifique que el certificado del servidor está firmado por una CA de confianza. El dispositivo no dispone de ninguna prueba de que el servidor es lo que se espera. Debido a la facilidad de hacer un ataque man-in-the-middle, aceptar los certificados autofirmados sólo es ligeramente mejor que correr sólo http en lugar de https en una red sin confianza. SÃ, podrÃa cifrarse el tráfico, pero podrÃa ser cifrado con la clave de un man-in-the-middle, para que el man-in-the-middle pueda acceder a todo, para que el cifrado es inú til salvo para observadores pasivos. Usuarios de confÃan SSL para estar seguro, y esto estarÃa deliberadamente haciendo lo inseguro, asà que el uso SSL se convierte engañoso. Si esto se utilizará en una red de confianza (es decir, usted es enteramente dentro de una empresa controlada), y luego certificados autofirmados todavÃa no se recomiendan. Las dos recomendaciones en una red de confianza son utilizar http porque la propia red es de confianza, o para obtener un certificado firmado por una CA de confianza (no auto firmado). La red es de confianza o no. - -Los principios aquà descritos no son especÃficos de Apache Cordova, se aplican a todas las comunicaciones cliente-servidor. - -Cuando se ejecuta Cordova en Android, usando `android:debuggable="true"` en la aplicación de manifiesto permitirá errores de SSL como certificado de errores de validación de la cadena de certificados autofirmados. Asà que usted puede utilizar certificados autofirmados en esta configuración, pero esto no es una configuración que se debe utilizar cuando la aplicación está en producción. Es para ser utilizado sólo durante el desarrollo de aplicaciones. - -## Almacenamiento cifrado - -(TBD) - -## Consejos generales - -### No utilice Android Gingerbread. - -* Establezca su nivel de min-blanco-sdk superior a 10. API 10 es pan de jengibre, y pan de jengibre ya no es apoyado por Google o dispositivo de fabricantes y por lo tanto no es recomendar por el equipo de Córdoba. -* Pan de jengibre se ha demostrado para ser inseguro y uno de los más dirigidos OSs móvil [http://www.mobilemag.com/2012/11/06/andriod-2-3-gingerbread-security/][2]. -* La lista blanca en Android no funciona con pan de jengibre o inferior. Esto significa que un atacante puede cargar código malicioso en un iframe que entonces tendrÃa acceso a todas las APIs de Cordova y podrÃa utilizar ese acceso para robar datos personales, enviar mensajes SMS a un número de tarificación y realizar otros actos dolosos. - - [2]: http://bgr.com/2012/11/06/android-security-gingerbread-malware/ - -### Utilice InAppBrowser para enlaces externos - -* Utilice el InAppBrowser al abrir enlaces a cualquier sitio web externo. Esto es mucho más seguro que un nombre de dominio e incluyendo el contenido directamente en su aplicación porque los InAppBrowser a utilizar las funciones de seguridad del navegador nativo y no dará el sitio web de acceso a su entorno Cordova whitelisting. Incluso si usted confÃa en el sitio web de terceros e incluirlo directamente en su aplicación, podrÃa relacionar a ese sitio web de terceros con contenido web malintencionado. - -### Validar todos los usuarios de entrada - -* Siempre validar cualquier entrada que acepta su solicitud. Esto incluye nombres de usuario, contraseñas, fechas, cargado de medios, etc.. Porque un atacante podrÃa manipular sus activos HTML y JS (ya sea por su aplicación de descompilación o usando herramientas de depuración como chrome://inspect), esta validación debe también realizarse en su servidor, especialmente antes de entregar los datos a cualquier servicio de back-end. -* Donde deben validar datos de otras fuentes: documentos del usuario, contactos, notificaciones push - -### No almacenar en caché los datos sensibles - -* Si se almacena en caché los nombres de usuario, contraseñas, información de geolocalización y otros datos sensibles, entonces podrÃa potencialmente ser recuperó más tarde por un usuario no autorizado o la aplicación. - -### No utilizar eval() si no sabes lo que estás haciendo - -* El JavaScript función eval() tiene una larga historia de abusos. Usando incorrectamente puede abrir su código para ataques de inyección, depuración de las dificultades y la ejecución de código más lenta. - -### No asuma que su código fuente es seguro - -* Desde una aplicación de Cordova se construye de HTML y JavaScript activos que conseguir envasados en un recipiente nativo, no debe considerar su código de seguridad. Es posible revertir el ingeniero una aplicación Cordova. - -## ArtÃculos recomendados y otros recursos - -* [Chuleta de HTML5 seguridad, detallando cómo asegurar su aplicación HTML5][3] -* [ArtÃculo de PhoneGap en dispositivo de seguridad, como el uso de datos cifrados][4] -* [White Paper sobre fallas de seguridad conocidas en Webview basado en aplicaciones hÃbridas][5] - - [3]: https://www.owasp.org/index.php/HTML5_Security_Cheat_Sheet - [4]: https://github.com/phonegap/phonegap/wiki/Platform-Security - [5]: http://www.cis.syr.edu/~wedu/Research/paper/webview_acsac2011.pdf \ No newline at end of file http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/f061b980/www/docs/es/edge/guide/appdev/whitelist/index.md ---------------------------------------------------------------------- diff --git a/www/docs/es/edge/guide/appdev/whitelist/index.md b/www/docs/es/edge/guide/appdev/whitelist/index.md deleted file mode 100644 index 55705d8..0000000 --- a/www/docs/es/edge/guide/appdev/whitelist/index.md +++ /dev/null @@ -1,145 +0,0 @@ ---- -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Ãa de lista blanca ---- - -# GuÃa de lista blanca - -Listas blancas de dominio es un modelo de seguridad que controla el acceso a dominios externos sobre los cuales su aplicación no tiene ningún control. Cordova ofrece una polÃtica de seguridad configurable para definir los sitios externos pueden accederse. De forma predeterminada, nuevas aplicaciones están configurados para permitir el acceso a cualquier sitio. Antes de su aplicación a la producción, debe formular una lista blanca y permitir el acceso a la red especÃfica dominios y subdominios. - -Para Android y iOS (a partir de sus 4,0 versiones), la polÃtica de seguridad de Cordova es extensible mediante una interfaz plugin. Su aplicación debe utilizar el [cordova-plugin-whitelist][1], que proporciona mayor seguridad y capacidad de configuración que las versiones anteriores de Cordova. Mientras que es posible implementar su propio plugin de lista blanca, no se recomienda a menos que su aplicación tiene necesidades muy especÃficas de seguridad polÃtica. Ver el [cordova-plugin-whitelist][1] para obtener más información sobre el uso y configuración. - - [1]: https://github.com/apache/cordova-plugin-whitelist - -Para otras plataformas, Cordova se adhiere a la especificación [W3C Widget de acceso][2] , que se basa en el elemento `< access >` dentro de archivo `config.xml` de la aplicación para habilitar el acceso a la red en dominios especÃficos. Para los proyectos que se basan en el flujo de trabajo de la CLI que se describe en la interfaz de lÃnea de comandos, este archivo se encuentra en el directorio superior del proyecto. De lo contrario para caminos de desarrollo especÃfico de plataforma, lugares figuran en las secciones a continuación. (Ver a las diversas guÃas de plataforma para obtener más información sobre cada plataforma). - - [2]: http://www.w3.org/TR/widgets-access/ - -Los siguientes ejemplos demuestran sintaxis `< access >` lista blanca: - -* Acceso a [google.com][3]: - - <access origin="http://google.com"; /> - - -* Acceso a la segura [google.com][4] (`https://`): - - <access origin="https://google.com"; /> - - -* Acceso al subdominio [maps.google.com][5]: - - <access origin="http://maps.google.com"; /> - - -* Acceso a todos los subdominios de [google.com][3], por ejemplo, [mail.google.com][6] y [docs.google.com][7]: - - <access origin="http://*.google.com"; /> - - -* Acceso a *todos* los dominios, por ejemplo, [google.com][3] y [developer.mozilla.org][8]: - - <access origin="*" /> - - - Este es el valor predeterminado para nuevos proyectos CLI. - - [3]: http://google.com - [4]: https://google.com - [5]: http://maps.google.com - [6]: http://mail.google.com - [7]: http://docs.google.com - [8]: http://developer.mozilla.org - -Tenga en cuenta que algunos sitios web puede redirigir automáticamente desde su página de inicio a una url distinta, por ejemplo utilizando el protocolo https o a un dominio especÃfico del paÃs. Por ejemplo http://www.google.com redireccionará para utilizar SSL/TLS en https://www.google.com y entonces más lejos puede redirigir a una geografÃa como https://www.google.co.uk. Estas situaciones pueden requerir las entradas de lista blanca modificada o adicionales más allá de su requisito inicial. Por favor considere esto como que está construyendo su lista blanca. - -Tenga en cuenta que la lista blanca se aplica sólo a los principal webview Cordova y no se aplica a un InAppBrowser webview o abrir enlaces en el navegador web del sistema. - -## Amazon fuego OS Whitelisting - -Reglas especÃficas de la plataforma whitelisting se encuentran en`res/xml/config.xml`. - -## Whitelisting Android - -Como el anterior, ver [cordova-plugin-whitelist][1] para más detalles. Cordova-androide antes 4.0.0, consulte las versiones anteriores de esta documentación. - -## iOS ListaBlanca - -Como el anterior, ver [cordova-plugin-whitelist][1] para más detalles. Cordova-ios antes 4.0.0, consulte las versiones anteriores de esta documentación. - -## BlackBerry 10 listas blancas - -Las reglas de las listas blancas se encuentran en `www/config.xml`. - -Uso de blackBerry decenas de comodines difiere de otras plataformas de dos maneras: - -* Cualquier contenido utilizando `XMLHttpRequest` debe declararse explÃcitamente. Configuración de `origin="*"` no funciona en este caso. Alternativamente, puede deshabilitarse toda seguridad web usando la preferencia `WebSecurity` que se describe en configuración de BlackBerry: - - <preference name="websecurity" value="disable" /> - - -* Como alternativa al ajuste `*.domain`, establece un atributo adicional `subdomains` en `true`. Se debe establecer en `false` de forma predeterminada. Por ejemplo, el siguiente permite acceder a `google.com`, `maps.google.com`y `docs.google.com`: - - <access origin="http://google.com"; subdomains="true" /> - - - El siguiente angosto acceso a `google.com`: - - <access origin="http://google.com"; subdomains="false" /> - - - Especifique el acceso a todos los ámbitos, incluido el protocolo local `file://` : - - <access origin="*" subdomains="true" /> - - -(Para obtener más información sobre soporte, véase documentación de BlackBerry en el [elemento de acceso][9].) - - [9]: https://developer.blackberry.com/html5/documentation/ww_developing/Access_element_834677_11.html - -## Firefox OS - -En Firefox OS no hay ningún concepto de listas blancas un dominio especÃfico. En su lugar hay un permiso especial llamado [SystemXHR][10]. Es necesario agregar este permiso al `archivo config.xml`: - - [10]: https://developer.mozilla.org/en-US/docs/Web/API/XMLHttpRequest#Permissions - - <platform name="firefoxos"> - <permission name="systemXHR" privileged="true" description="load data from server" /> - </platform> - - -El objeto `XMLHttpRequest` debe ser instanciada con dos parámetros `mozAnon` y `mozSystem`: - - var request = new XMLHttpRequest({ - mozAnon: true, - mozSystem: true}); - - -Esta solución es transparente, asà que no hay diferencias para otras plataformas. - -## Lista blanca de Windows Phone - -Las reglas de listas blancas para Windows Phone 8 se encuentran en el archivo `config.xml` de la aplicación. - -## Las listas blancas Tizen - -Sus reglas se encuentran en el archivo `config.xml` de la aplicación. La plataforma se basa en el mismo atributo `subdomains` como la plataforma BlackBerry. (Para obtener más información sobre compatibilidad, consulte documentación de Tizen sobre el [elemento de acceso][11].) - - [11]: https://developer.tizen.org/help/index.jsp?topic=%2Forg.tizen.web.appprogramming%2Fhtml%2Fide_sdk_tools%2Fconfig_editor_w3celements.htm \ No newline at end of file http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/f061b980/www/docs/es/edge/guide/cli/index.md ---------------------------------------------------------------------- diff --git a/www/docs/es/edge/guide/cli/index.md b/www/docs/es/edge/guide/cli/index.md deleted file mode 100644 index f573471..0000000 --- a/www/docs/es/edge/guide/cli/index.md +++ /dev/null @@ -1,419 +0,0 @@ ---- -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: La interfaz de linea de comandos ---- - -# La interfaz de linea de comandos - -Esta guÃa le muestra cómo crear aplicaciones y exportarlas para varias plataformas móviles nativas mediante la interfaz de lÃnea de comandos de `cordova` (CLI). Esta herramienta le permite crear nuevos proyectos, construirlas en diferentes plataformas y ejecutar en dispositivos reales o dentro de los emuladores. El CLI es la herramienta principal para el flujo de trabajo multiplataforma descrito en la sección principal. Sin embargo, también puede utilizar el CLI para inicializar el código del proyecto, para lo cual utiliza diversas plataformas SDK y herramientas de consola para el desarrollo continuo. - -## Pre-requisitos - -Antes de ejecutar cualquiera de las herramientas de lÃnea de comandos, necesita instalar el SDK para cada plataforma. (Vea las guÃas de la plataforma para más detalles) - -Para añadir soporte o reconstruir un proyecto para cualquier plataforma, necesitará ejecutar la interfaz de lÃnea de comandos desde la misma máquina que soporta el SDK de la plataforma. La CLI admite las siguientes combinaciones: - -* iOS (Mac) -* Amazon Fire OS (Mac, Linux, Windows) -* Android (Mac, Linux, Windows) -* BlackBerry 10 (Mac, Linux, Windows) -* Windows Phone 8 (Windows) -* Windows (Windows) -* Firefox OS (Mac, Linux, Windows) - -En el Mac, es disponible a través de la aplicación de la *Terminal de* la lÃnea de comandos. En el PC, está disponible como *Command Prompt* bajo *Accessories*. - -**Nota**: para las plataformas Windows, todavÃa puedes desarrollar en equipos Mac ejecutando Windows en una máquina virtual o en modo de arranque dual. Para las opciones disponibles, consulte la guÃa de la plataforma de Windows Phone 8 o la guÃa de la plataforma Windows. - -Lo más probable es que ejecute la CLI de diferentes máquinas, más tiene sentido mantener un repositorio de código fuente remota, cuyos activos tire hacia abajo para directorios de trabajo local. - -## Instalar la CLI de Cordova - -La herramienta de lÃnea de comandos de Cordova se distribuye como un paquete de npm en un formato listo para usar. No es necesario compilarlo desde su código fuente. - -Para instalar la herramienta de lÃnea de comandos de `cordova`, siga estos pasos: - -1. Descargue e instale [Node.js][1]. Después de la instalación, usted debe ser capaz de ejecutar `node` y `npm` en la lÃnea de comandos. Si lo desea, opcionalmente puede utilizar una herramienta como `nvm` o `nave` para manejar la instalación de Node.js. - -2. Descarga e instala un [cliente de git][2], si ya no tienes uno. Después de la instalación, usted debe ser capaz de ejecutar a `git` en la lÃnea de comandos. Aunque no utilices `git` manualmente, la CLI usa de fondo para descargar algunos archivos cuando se crea un nuevo proyecto. - -3. Instale el módulo `cordova` utilizando el manejador de paquetes de Node.js `npm`. El módulo `cordova` sera descargado automáticamente por `npm`. - - [1]: http://nodejs.org/ - [2]: http://git-scm.com/ - -* en OS X y Linux: - - $ sudo npm install -g cordova - - - En OS X y Linux, prefijando la `npm` mando con `sudo` puede ser necesario instalar este desarrollo utilidad en otro modo restringido directorios tales como `/usr/local/share` . Si usted está utilizando la herramienta opcional nvm/nave o tener acceso de escritura al directorio de instalación, podrá omitir el `sudo` prefijo. Hay [más consejos][3] sobre el uso de `npm` sin `sudo` , si desea hacerlo. - -* en Windows: - - C:\>npm install -g cordova - - - El `-g` bandera arriba dice `npm` instalar `cordova` en todo el mundo. De lo contrario será instalado en el `node_modules` subdirectorio del directorio de trabajo actual. - - Puede que necesites añadir el `npm` Directorio a su `PATH` para invocar a nivel mundial instalada `npm` módulos. En Windows, `npm` generalmente se puede encontrar en `C:\Users\username\AppData\Roaming\npm` . En OS X y Linux se puede encontrar generalmente en`/usr/local/share/npm`. - - El registro de instalación puede producir errores para cualquier plataforma desinstalado SDK. - - Después de la instalación, usted debe ser capaz de ejecutar `cordova` en la lÃnea de comandos sin argumentos y debe imprimir el texto de ayuda. - - [3]: http://justjs.com/posts/npm-link-developing-your-own-npm-modules-without-tears - -## Crear la aplicación - -Vaya al directorio donde mantener su código fuente y ejecutar un comando como el siguiente: - - $ cordova create hello com.example.hello HelloWorld - - -Puede tomar algún tiempo para que el comando completar, asà que tenga paciencia. Ejecutar el comando con el `-d` opción muestra información acerca de su progreso. - -El primer argumento *Hola* especifica un directorio que se generen para su proyecto. Este directorio ya no deberÃa existir, Córdoba lo creará para usted. Página de inicio de su aplicación, junto con diversos recursos bajo `css`, `js` y `img`, que seguir común web convenciones de nomenclatura de archivos de desarrollo las casas su subdirectorio `www`. Estos activos se almacenarán en el sistema de archivos local del dispositivo, no sirve de forma remota. El archivo `config.xml` contiene metadatos importantes necesarios para generar y distribuir la aplicación. - -El segundo argumento `com.example.hello` proporciona un identificador de dominio reverso-estilo su proyecto. Este argumento es opcional, pero sólo si también omite el tercer argumento, puesto que los argumentos son posicionales. Puede editar este valor más adelante en el `config.xml` de archivos, pero tenga en cuenta que puede haber código generado fuera de `config.xml` utilizando este valor, tales como nombres de paquetes Java. El valor predeterminado es `io.cordova.hellocordova` , pero se recomienda que seleccione un valor apropiado. - -El tercer argumento `HelloWorld` da tÃtulo de pantalla de la aplicación. Este argumento es opcional. Puede editar este valor más adelante en el `config.xml` de archivos, pero tenga en cuenta que puede haber código generado fuera de `config.xml` utilizando este valor, tales como nombres de clase de Java. El valor predeterminado es `HelloCordova` , pero se recomienda que seleccione un valor apropiado. - -## Añadir plataformas - -Todos los comandos posteriores necesitan ejecutarse en el directorio del proyecto, o cualquier subdirectorios dentro de su ámbito de aplicación: - - $ cd hello - - -Antes de poder construir el proyecto, tienes que especificar un conjunto de plataformas de destino. Su capacidad para ejecutar estos comandos depende de si tu maquina soporta cada SDK, y si ya tienes instalación cada SDK. Ejecutar cualquiera de éstos desde un Mac: - - $ cordova platform add ios - $ cordova platform add amazon-fireos - $ cordova platform add android - $ cordova platform add blackberry10 - $ cordova platform add firefoxos - - -Ejecutar cualquiera de éstos desde una máquina Windows, donde *wp* se refiere a las diferentes versiones del sistema operativo Windows Phone: - - plataforma $ cordova agregar $ wp8 cordova plataforma añadir windows plataforma $ cordova añadir plataforma amazon-fireos $ cordova añadir android $ cordova plataforma añadir $ blackberry10 cordova plataforma agregar firefoxos - - -Ejecutar esto para comprobar su sistema actual de plataformas: - - $ cordova platforms ls - - -(Tenga en cuenta que los comandos `platform` y `platforms` son sinónimos). - -Ejecutar cualquiera de los siguientes comandos sinónimos para quitar una plataforma: - - $ cordova platform remove blackberry10 - $ cordova platform rm amazon-fireos - $ cordova platform rm android - - -Ejecución de comandos para agregar o quitar afecta a plataformas el contenido del directorio de *platforms* del proyecto, donde cada plataforma especificado aparece como un subdirectorio. El directorio de origen *www* se reproduce dentro del subdirectorio de cada plataforma, que aparece por ejemplo en `platforms/ios/www` o `platforms/android/assets/www`. Porque la CLI constantemente copia archivos desde la carpeta *www* fuente, sólo debe editar estos archivos y no los ubicado debajo de los subdirectorios de *plataformas* . Si utilizas software de control de versión, debe agregar esta carpeta *www* fuente, junto con la carpeta *se funde* , a su sistema de control de versión. (Puede encontrarse más información sobre la carpeta *se funde* en la sección de personalizar cada plataforma abajo). - -**ADVERTENCIA**: cuando se usa la CLI para construir su solicitud, usted debe *no* editar cualquiera de los archivos en el `/platforms/` Directorio si no sabes lo que estás haciendo, o si documentación especifica lo contrario. Los archivos de este directorio se sobrescriben rutinariamente al preparar las aplicaciones para la construcción, o cuando son instalar plugins. - -Si lo desea en este punto, puede utilizar un SDK como Eclipse o Xcode para abrir el proyecto que ha creado. Usted necesitará abrir el conjunto derivado de los activos de la `/platforms/` Directorio para desarrollar con un SDK. Esto es porque los archivos de metadatos especÃficos del SDK se almacenan dentro de la correspondiente `/platform/` subdirectorio. (Vea a las guÃas de plataforma para obtener información sobre cómo desarrollar aplicaciones dentro de cada IDE). Utilice este enfoque si simplemente quieres inicializar un proyecto mediante la CLI y luego cambiar a un SDK para trabajo nativo. - -Lea sobre si desea utilizar el enfoque de flujo de trabajo multiplataforma (CLI) para el ciclo completo de desarrollo. - -## Construir la aplicación - -De forma predeterminada, la secuencia de comandos `cordova create` genera una esquelética aplicación basada en web cuya página de inicio es el archivo del proyecto `www/index.html`. Editar esta aplicación que quieras, pero cualquier inicialización debe especificarse como parte de la `[deviceready](../../cordova/events/events.deviceready.html)` controlador de eventos, que se hace referencia por defecto de`www/js/index.js`. - -Ejecute el siguiente comando para crear iterativamente el proyecto: - - $ cordova build - - -Esto genera un código especÃfico de plataforma dentro del subdirectorio del proyecto `platforms`. Opcionalmente puede limitar el alcance de cada build a plataformas especÃficas: - - $ cordova build ios - - -El comando `cordova build` es una abreviatura para el siguiente, que en este ejemplo también está orientado a una única plataforma: - - $ cordova prepare ios - $ cordova compile ios - - -En este caso, una vez que `prepare`, puede utilizar Xcode SDK de Apple como alternativa para modificar y compilar el código especÃfico de plataforma que Córdoba se genera dentro de `platforms/ios`. Puede utilizar el mismo enfoque con SDK de otras plataformas. - -## Probar la aplicación en un emulador o dispositivo - -SDK para plataformas móviles vienen a menudo incluidos con emuladores que ejecutan una imagen del dispositivo, asà que usted puede lanzar la aplicación desde la pantalla principal y ver cómo interactúa con muchas caracterÃsticas de la plataforma. Ejecutar un comando como el siguiente para reconstruir la app y visualizarlo en un emulador de una plataforma especÃfica: - - $ cordova emulate android - - -Algunas plataformas móviles emulan un dispositivo especial de forma predeterminada, como el iPhone iOS proyectos. Para otras plataformas, necesitará primero asociado a un dispositivo con un emulador. - -**Nota**: apoyo emulador no está actualmente disponible para Amazon fuego OS. - -(Vea a las guÃas de la plataforma para más detalles). Por ejemplo, usted puede ejecuta el comando `android` para lanzar el SDK de Android, luego ejecute una imagen del dispositivo en particular, que inicia según su comportamiento predeterminado: - -![][4] - - [4]: {{ site.baseurl }}/static/img/guide/cli/android_emulate_init.png - -Siguiendo con el comando `cordova emulate` refresca la imagen de emulador para mostrar la última aplicación, que ahora está disponible para el lanzamiento de la pantalla de Inicio: - -![][5] - - [5]: {{ site.baseurl }}/static/img/guide/cli/android_emulate_install.png - -Alternativamente, puedes enchufe del auricular en el ordenador y probar la aplicación directamente: - - $ cordova run android - - -Antes de ejecutar este comando, tienes que configurar el dispositivo para la prueba, siguiendo los procedimientos que varÃan para cada plataforma. En los dispositivos Android y Amazon fuego OS, tendrÃas que activar una opción de **depuración USB** en el dispositivo y quizás añadir un controlador USB dependiendo de su entorno de desarrollo. Ver a las guias de plataforma para obtener más información sobre los requisitos de cada plataforma. - -## Añadir funciones Plugin - -Cuando construyes y ver un nuevo proyecto, la aplicación predeterminada que aparece no hace mucho. Puede modificar la aplicación de muchas maneras a aprovechar las tecnologÃas web estándar, pero para que la aplicación para comunicar estrechamente con varias caracterÃsticas de nivel de dispositivo, necesitará añadir plugins que proporcionan acceso a núcleo Cordova APIs. - -Un *plugin* es un poco de código adicional que proporciona una interfaz para componentes nativos. Usted puede diseñar su propia interfaz plugin, por ejemplo al diseñar una aplicación hÃbrida que combina un Cordova WebView con componentes nativos. (Véase WebViews incrustar y [Plugin Development Guide][6] para obtener más detalles). Más comúnmente, debe agregar un plugin para activar uno de los rasgos básicos de nivel de dispositivo de Cordova detallados en la referencia de la API. - - [6]: guide_hybrid_plugins_index.md.html#Plugin%20Development%20Guide - -A partir de la versión 3.0, cuando se crea un proyecto de Córdoba no tiene presente algún plugin. Este es el nuevo comportamiento predeterminado. Algún plugin que desee, incluso los plugins del núcleo, debe agregarse explÃcitamente. - -Puede encontrarse una lista de estos plugins, plugins de terceros adicionales proporcionados por la comunidad, incluyendo en el registro en [plugins.cordova.io][7]. Puede utilizar la CLI para buscar plugins de este registro. Por ejemplo, buscando `bar` y `code` produce un solo resultado que coincide con ambos términos como subcadenas entre mayúsculas y minúsculas: - - [7]: http://plugins.cordova.io/ - - $ cordova plugin search bar code - - com.phonegap.plugins.barcodescanner - Scans Barcodes - - -Buscando solamente el `bar` término rendimientos y resultados adicionales: - - cordova-plugin-statusbar - Cordova StatusBar Plugin - - -El `cordova plugin add` comando requiere especificar el repositorio para el código del plugin. Estos son ejemplos de cómo puede usar la CLI para agregar funciones a la aplicación: - -* Información básica del dispositivo (dispositivo API): - - $ cordova plugin add cordova-plugin-device - - -* Conexión de red y eventos de baterÃa: - - $ cordova plugin add cordova-plugin-network-information - $ cordova plugin add cordova-plugin-battery-status - - -* Acelerómetro, brújula y geolocalización: - - $ cordova plugin add cordova-plugin-device-motion - $ cordova plugin add cordova-plugin-device-orientation - $ cordova plugin add cordova-plugin-geolocation - - -* Cámara, reproducción multimedia y captura: - - $ cordova plugin add cordova-plugin-camera - $ cordova plugin add cordova-plugin-media-capture - $ cordova plugin add cordova-plugin-media - - -* Acceder a archivos en el dispositivo o red (archivo API): - - $ cordova plugin add cordova-plugin-file - $ cordova plugin add cordova-plugin-file-transfer - - -* Notificación mediante vibración o cuadro de diálogo: - - $ cordova plugin add cordova-plugin-dialogs - $ cordova plugin add cordova-plugin-vibration - - -* Contactos: - - $ cordova plugin add cordova-plugin-contacts - - -* Globalización: - - $ cordova plugin add cordova-plugin-globalization - - -* SplashScreen: - - $ cordova plugin add cordova-plugin-splashscreen - - -* Abrir nuevas ventanas del navegador (InAppBrowser): - - $ cordova plugin add cordova-plugin-inappbrowser - - -* Consola de depuración: - - $ cordova plugin add cordova-plugin-console - - -**Nota**: el CLI agrega plugin código según proceda para cada plataforma. Si usted quiere desarrollar con las herramientas de nivel inferior cáscara o plataforma SDK como se indica en el [Resumen](../overview/index.html), tienes que ejecutar la utilidad Plugman para añadir plugins por separado para cada plataforma. (Para obtener más información, véase Plugman usando a gestionar Plugins). - -Uso `plugin ls` (o `plugin list` , o `plugin` por sà mismo) ver actualmente instalado plugins. Cada muestra por su identificador: - - $ cordova plugin ls # or 'plugin list' - [ 'cordova-plugin-console' ] - - -Para quitar un plugin, referirse a él por el mismo identificador que aparece en el listado. Por ejemplo, aquà es cómo quitarÃa apoyo para una consola de depuración de una versión: - - $ cordova plugin rm cordova-plugin-console - $ cordova plugin remove cordova-plugin-console # same - - -Puede lote-quitar o agregar plugins por especificar más de un argumento para cada comando: - - $ cordova plugin add cordova-plugin-console cordova-plugin-device - - -## Opciones avanzadas Plugin - -Al agregar un plugin, varias opciones permiten especificar de dónde buscar el plugin. Los ejemplos anteriores utilizan una conocida `registry.cordova.io` del registro y el plugin es especificada por el `id` : - - $ cordova plugin add cordova-plugin-console - - -El `id` también puede incluir el número de versión del plugin, anexado después de un `@` personaje. El `latest` versión es un alias para la versión más reciente. Por ejemplo: - - $ cordova plugin add cordova-plugin-console@latest - $ cordova plugin add [email protected] - - -Si el plugin no está registrado en `registry.cordova.io` , pero se encuentra en otro repositorio git, puede especificar una URL alternativa: - - $ cordova plugin add https://github.com/apache/cordova-plugin-console.git - - -El ejemplo de git anterior recupera el plugin desde el final de la rama principal, pero una alternativa git-ref como una etiqueta o rama puede ser añadido después de un `#` personaje: - -Instalar desde una etiqueta: - - $ cordova plugin add https://github.com/apache/cordova-plugin-console.git#r0.2.0 - - -o sucursal: - - $ cordova plugin add https://github.com/apache/cordova-plugin-console.git#CB-8438cordova-plugin-console - - -o git-ref también podrÃa ser una confirmación particular: - - $ cordova plugin add https://github.com/apache/cordova-plugin-console.git#f055daec45575bf08538f885e09c85a0eba363ff - - -Si el plugin (y su `plugin.xml` archivo) está en un subdirectorio dentro del repositorio git, puede especificarlo con un `:` personaje. Tenga en cuenta que el `#` personaje es necesario: - - $ cordova plugin add https://github.com/someone/aplugin.git#:/my/sub/dir - - -También puedes combinar el git-ref y el subdirectorio: - - $ cordova plugin add https://github.com/someone/aplugin.git#r0.0.1:/my/sub/dir - - -Como alternativa, especifique una ruta de acceso local para el directorio que contiene el `plugin.xml` archivo: - - $ cordova plugin add ../my_plugin_dir - - -## Usando *fusiona* a personalizar cada plataforma - -Mientras que Córdoba le permite implementar fácilmente una aplicación para muchas plataformas diferentes, a veces es necesario añadir personalizaciones. En ese caso, no desee modificar los archivos de código fuente en varios `www` directorios dentro del nivel superior `platforms` directorio, ya que regularmente son reemplazados con el nivel superior `www` fuente de la cruz-plataforma del directorio. - -En cambio, el nivel superior `merges` directorio ofrece un lugar para especificar activos a desplegar en plataformas especÃficas. Cada subdirectorio especÃfico de la plataforma dentro de `merges` refleja la estructura del directorio de la `www` árbol de código fuente, lo que le permite reemplazar o agregar archivos según sea necesario. Por ejemplo, aquà es cómo usted utiliza `merges` para aumentar el tamaño de fuente predeterminado para dispositivos Android y Amazon fuego OS: - -* Editar el `www/index.html` archivo, añadir un enlace a un archivo CSS adicional, `overrides.css` en este caso: - - <link rel="stylesheet" type="text/css" href="css/overrides.css" /> - - -* Opcionalmente crear un vacÃo `www/css/overrides.css` archivo, que se aplicarÃa para todas las versiones no-Android, evitando un error de archivo que falta. - -* Crear un `css` subdirectorio dentro de `merges/android` , luego añadir un correspondiente `overrides.css` archivo. Especificar CSS que reemplaza el tamaño de letra de 12 puntos por defecto especificado dentro de `www/css/index.css` , por ejemplo: - - body { font-size:14px; } - - -Al reconstruir el proyecto, la versión de Android incluye el tamaño de fuente personalizado, mientras que otros permanecen sin cambios. - -También se puede utilizar `merges` para agregar archivos no presentan en el original `www` directorio. Por ejemplo, una aplicación puede incorporar un gráfico de *botón* en la interfaz de iOS, en `merges/ios/img/back_button.png` , mientras que la versión de Android en lugar de otro puede capturar `[backbutton](../../cordova/events/events.backbutton.html)` eventos desde el botón de hardware correspondiente. - -## Comandos de ayuda - -Córdoba cuenta con un par de comandos globales, que pueden ayudar si se atranca o experimenta un problema. El `help` comando muestra todos los comandos disponibles de Córdoba y su sintaxis: - - $ cordova help - $ cordova # same - - -Además, puede obtener ayuda más detallada sobre un comando especÃfico. Por ejemplo: - - $ cordova run --help - - -El `info` comando produce un listado de información potencialmente útiles, como instaladas plataformas, plugins, versiones SDK para cada plataforma y versiones de CLI y `node.js` : - - $ cordova info - - -Tanto presenta la información en pantalla y captura la salida de un local `info.txt` archivo. - -**Nota**: Actualmente, sólo detalles en plataformas Android y iOS están disponibles. - -## Actualización de Córdoba y su proyecto - -Después de instalar el `cordova` utilidad, usted puede siempre actualizarlo a la última versión ejecutando el siguiente comando: - - $ sudo npm update -g cordova - - -Para instalar una versión especÃfica, utilice esta sintaxis: - - $ sudo npm install -g [email protected] - - -Ejecute `cordova -v` para ver qué versión se está ejecutando actualmente. Ejecutar el `npm -info` comando para una lista más larga que incluye la versión actual junto a otros números de versión: - - $ npm info cordova - - -Cordova 3.0 es la primera versión para compatibles con la interfaz de lÃnea de comandos descrita en esta sección. Si está actualizando desde una versión anterior a 3.0, necesita crear un nuevo proyecto como se describe arriba, entonces copia activos la mayor aplicación en el nivel superior `www` directorio. En su caso, más detalles sobre la actualización a 3.0 están disponibles en las guÃas de la plataforma. Una vez que se actualiza a la `cordova` interfaz de lÃnea de comandos y uso `npm update` para permanecer vigente, los procedimientos más desperdiciadores de tiempo descritos allà ya no son relevantes. - -Cordova 3.0 + todavÃa puede requerir varios cambios a las estructuras de directorios a nivel de proyecto y otras dependencias. Después de ejecutar el `npm` comando arriba actualizar Cordova sà mismo, usted puede necesitar garantizar recursos de su proyecto se ajustan a los requisitos de la versión más reciente. Ejecutar un comando como el siguiente para cada plataforma vas a compilar: - - $ cordova platform update android - $ cordova platform update ios - ...etc. http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/f061b980/www/docs/es/edge/guide/hybrid/plugins/index.md ---------------------------------------------------------------------- diff --git a/www/docs/es/edge/guide/hybrid/plugins/index.md b/www/docs/es/edge/guide/hybrid/plugins/index.md deleted file mode 100644 index e6f22ef..0000000 --- a/www/docs/es/edge/guide/hybrid/plugins/index.md +++ /dev/null @@ -1,177 +0,0 @@ ---- -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Ãa de desarrollo de plugin ---- - -# GuÃa de desarrollo de plugin - -Un *plugin* es un paquete de código que permite la webview Cordova dentro de la cual hace que la aplicación para comunicarse con la plataforma nativa en la que se ejecuta. Plugins proporcionan acceso a la funcionalidad de plataforma y dispositivo que está normalmente disponible para aplicaciones basadas en web. Las principales caracterÃsticas de Cordova API se implementan como plugins, y muchos otros están disponibles que permiten funciones tales como escáneres de código de barras, comunicación NFC, o adaptar el calendario interfaces. Hay un [registro][1] de extensiones disponibles. - - [1]: http://plugins.cordova.io - -Plugins comprenden una única interfaz JavaScript junto con bibliotecas de código nativo correspondiente para cada plataforma soportada. En esencia esto esconde las diversas implementaciones de código nativo detrás de una interfaz común de JavaScript. - -A unos pasos esta sección a través de un plugin simple *Eco* que pasa una cadena de JavaScript a la plataforma nativa y posterior, que puede utilizar como modelo para construir caracterÃsticas mucho más complejas. Esta sección analiza la estructura básica del plugin y la interfaz JavaScript de exteriores. Para cada interfaz nativa correspondiente, consulte la lista al final de esta sección. - -Además de estas instrucciones, cuando se prepara para escribir un plugin es mejor mirar sobre [plugins existentes][2] para orientación. - - [2]: http://cordova.apache.org/#contribute - -## Construyendo un Plugin - -Los programadores de aplicaciones utilizan la CLI `plugin add` comando (discutido en la interfaz de lÃnea de comandos) para aplicar un plugin para un proyecto. El argumento de este comando es la dirección URL de un repositorio *git* que contiene el código del plugin. Este ejemplo implementa dispositivo API de Cordova: - - $ cordova plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin-device.git - - -El repositorio plugin debe cuentan con un alto nivel `plugin.xml` archivo de manifiesto. Hay muchas maneras de configurar este archivo, los detalles para los que están disponibles en la especificación del Plugin. Esta versión abreviada de la `Device` plugin proporciona un ejemplo sencillo de usar como un modelo: - - <?xml version="1.0" encoding="UTF-8"?> - <plugin xmlns="http://apache.org/cordova/ns/plugins/1.0"; - id="cordova-plugin-device" version="0.2.3"> - <name>Device</name> - <description>Cordova Device Plugin</description> - <license>Apache 2.0</license> - <keywords>cordova,device</keywords> - <js-module src="www/device.js" name="device"> - <clobbers target="device" /> - </js-module> - <platform name="ios"> - <config-file target="config.xml" parent="/*"> - <feature name="Device"> - <param name="ios-package" value="CDVDevice"/> - </feature> - </config-file> - <header-file src="src/ios/CDVDevice.h" /> - <source-file src="src/ios/CDVDevice.m" /> - </platform> - </plugin> - - -El nivel superior `plugin` de etiqueta `id` atributo utiliza el mismo formato de dominio reverso para identificar el paquete plugin como las aplicaciones que están agregadas. El `js-module` etiqueta especifica la ruta de acceso a la interfaz común de JavaScript. El `platform` etiqueta especifica un conjunto correspondiente de código nativo para la `ios` plataforma en este caso. El `config-file` etiqueta encapsula un `feature` etiqueta que se inyecta en la especÃfica de la plataforma `config.xml` archivo a la plataforma de la biblioteca de código adicional. El `header-file` y `source-file` etiquetas especifican la ruta de acceso a archivos de la biblioteca componentes. - -## Validación de un Plugin - -Puede utilizar la `plugman` utilidad para comprobar si el plugin se instala correctamente para cada plataforma. Instalar `plugman` con el siguiente comando de [nodo][3] : - - [3]: http://nodejs.org/ - - $ npm install -g plugman - - -Necesita un directorio fuente válida de la aplicación, tales como el nivel superior `www` directorio incluido en un proyecto generado por CLI predeterminado como se describe en la interfaz de lÃnea de comandos. Asegúrese de que la aplicación de `index.html` página de inicio de referencia el nombre de JavaScript interfaz del plugin, como si estuviera en el mismo directorio fuente: - - <script src="myplugin.js"></script> - - -Luego ejecutar un comando como el siguiente para comprobar las dependencias iOS carguen adecuadamente: - - $ plugman install --platform ios --project /path/to/my/project/www --plugin /path/to/my/plugin - - -Para obtener más información sobre `plugman` Opciones, vea usando Plugman para gestionar Plugins. Para obtener información sobre cómo realmente *depurar* plugins, consulte interfaz nativa de cada plataforma enumerado en la parte inferior de esta página. - -## La interfaz de JavaScript - -El JavaScript proporciona la interfaz de frente, por lo que es quizás la parte más importante del plugin. Usted puede estructurar JavaScript de tu plugin sin embargo te gusta, pero tiene que llamar a `cordova.exec` para comunicarse con la plataforma nativa, usando la siguiente sintaxis: - - cordova.exec(function(winParam) {}, - function(error) {}, - "service", - "action", - ["firstArgument", "secondArgument", 42, false]); - - -Aquà está cómo funciona cada parámetro: - -* `function(winParam) {}`: Una función de devolución de llamada de éxito. Asumiendo que tu `exec` llamada se realiza correctamente, esta función se ejecuta junto con cualquiera de los parámetros pasas. - -* `function(error) {}`: Una función de callback de error. Si la operación no se completa correctamente, esta función se ejecuta con un parámetro opcional de error. - -* `"service"`: El nombre del servicio que llame al lado nativo. Esto corresponde a una clase nativa, para lo cual existe más información en las guÃas nativas enumeradas a continuación. - -* `"action"`: El nombre de acción para llamar al lado nativo. Esto generalmente corresponde al método de la clase nativa. Consulte a las guÃas nativos enumerados a continuación. - -* `[/* arguments */]`: Un conjunto de argumentos que se pasarán en el entorno nativo. - -## Muestra JavaScript - -Este ejemplo muestra una forma de implementar interfaz del plugin JavaScript: - - window.echo = function(str, callback) { - cordova.exec(callback, function(err) { - callback('Nothing to echo.'); - }, "Echo", "echo", [str]); - }; - - -En este ejemplo, el plugin se adhiere a la `window` objeto como la `echo` la función, que llamarÃan a los usuarios plugin como sigue: - - window.echo("echome", function(echoValue) { - alert(echoValue == "echome"); // should alert true. - }); - - -Mira a los tres últimos argumentos de la `cordova.exec` función. Las primeras convocatorias del `Echo` *servicio*, un nombre de clase. El segundo pide la `echo` *acción*, un método dentro de esa clase. La tercera es una matriz de argumentos que contengan la cadena Eco, que es el `window.echo` función es el primer parámetro. - -El callback de éxito pasó a `exec` es simplemente una referencia a la función de callback `window.echo` toma. Si la plataforma nativa despide el callback de error, simplemente pide la devolución de llamada de éxito y pasa una cadena predeterminada. - -## Interfaces nativas - -Una vez se define JavaScript para tu plugin, debes complementarlo con por lo menos una aplicación nativa. Los datos de cada plataforma se enumeran a continuación, y cada uno se basa en el simple ejemplo Eco Plugin anterior: - -* [Amazon fuego OS Plugins](../../platforms/amazonfireos/plugin.html) -* [Android Plugins](../../platforms/android/plugin.html) -* [iOS Plugins](../../platforms/ios/plugin.html) -* [BlackBerry 10 Plugins](../../platforms/blackberry10/plugin.html) -* [Windows Phone 8 Plugins](../../platforms/wp8/plugin.html) -* [Windows Plugins](../../platforms/win8/plugin.html) - -La plataforma Tizen no admite plugins. - -## Editorial Plugins - -Una vez que desarrollas tu plugin, quizá quieras publicar y compartir con la comunidad. Puedes publicar tu plugin a cualquier `npmjs` -base de registro, pero el recomendado es el [registro de la nueva gestión pública][4]. Lea nuestro [editorial plugins guÃa del MNP][5]. - - [4]: https://www.npmjs.com - [5]: http://plugins.cordova.io/npm/developers.html - -**Nota**: [registro de plugin de Córdoba][6] se está moviendo a un estado de sólo lectura. `publish`/ `unpublish` se han eliminado los comandos de `plugman` , asà que necesitarás usar correspondiente `npm` comandos. - - [6]: https://plugins.cordova.io - -Otros desarrolladores pueden instalar el plugin automáticamente mediante `plugman` o CLI Cordova. (Para más detalles sobre cada paso del desarrollo, ver Plugman utilizando para administrar Plugins y la interfaz de lÃnea de comandos). - -Para publicar un plugin para registro de MNP necesita seguir los siguientes pasos: - -* crear `package.json` archivo de tu plugin: - - $ plugman createpackagejson /path/to/your/plugin - - -* publicarla: - - $ npm adduser # that is if you don't have an account yet - $ npm publish /path/to/your/plugin - - -Eso es todo! - -Ejecutando `plugman --help` enumera otros basados en el registro de los comandos disponibles. \ No newline at end of file --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
