Return-Path: X-Original-To: apmail-cordova-commits-archive@www.apache.org Delivered-To: apmail-cordova-commits-archive@www.apache.org Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by minotaur.apache.org (Postfix) with SMTP id 9432410E96 for ; Wed, 2 Oct 2013 19:59:43 +0000 (UTC) Received: (qmail 92844 invoked by uid 500); 2 Oct 2013 19:59:34 -0000 Delivered-To: apmail-cordova-commits-archive@cordova.apache.org Received: (qmail 92410 invoked by uid 500); 2 Oct 2013 19:59:21 -0000 Mailing-List: contact commits-help@cordova.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@cordova.apache.org Delivered-To: mailing list commits@cordova.apache.org Received: (qmail 91833 invoked by uid 99); 2 Oct 2013 19:59:09 -0000 Received: from tyr.zones.apache.org (HELO tyr.zones.apache.org) (140.211.11.114) by apache.org (qpsmtpd/0.29) with ESMTP; Wed, 02 Oct 2013 19:59:09 +0000 Received: by tyr.zones.apache.org (Postfix, from userid 65534) id B29FA8AEBC1; Wed, 2 Oct 2013 19:59:09 +0000 (UTC) Content-Type: text/plain; charset="us-ascii" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit From: agrieve@apache.org To: commits@cordova.apache.org Date: Wed, 02 Oct 2013 19:59:37 -0000 Message-Id: <2181adc1deae421b9d20d4044475d3d6@git.apache.org> In-Reply-To: <1f5aebce809a4fd1ac54f0764baad0f8@git.apache.org> References: <1f5aebce809a4fd1ac54f0764baad0f8@git.apache.org> X-Mailer: ASF-Git Admin Mailer Subject: [30/51] [partial] CB-4975 Add 3.1.0 version of non-english docs. http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/2b8e503f/docs/es/3.1.0/guide/cli/index.md ---------------------------------------------------------------------- diff --git a/docs/es/3.1.0/guide/cli/index.md b/docs/es/3.1.0/guide/cli/index.md new file mode 100644 index 0000000..3972c08 --- /dev/null +++ b/docs/es/3.1.0/guide/cli/index.md @@ -0,0 +1,281 @@ +--- + +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. + + +--- + +# La interfaz de línea de comandos + +Esta guía le muestra cómo crear aplicaciones y desplegarlas para varias plataformas móviles nativas mediante la interfaz de línea de comandos de `cordova` (CLI). Esta herramienta permite crear nuevos proyectos, construirlas en diferentes plataformas y ejecutarlos dentro de un emulador. También puede utilizar la CLI para inicializar el código del proyecto, tras lo cual utilizas SDKs de varias plataformas para desarrollarlas aún más. + +## Prerequisitos + +Antes de ejecutar cualquiera de las herramientas de línea de comandos, necesita instalar el SDK para cada plataforma de destino. (Vea a 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) +* Androide (Mac, Linux) +* BlackBerry 10 (Mac, Linux, Windows) +* Windows Phone 7 (Windows) +* Windows Phone 8 (Windows) +* Windows 8 (Windows) +* Firefox OS (Mac, Linux, Windows) + +En el Mac, es disponible a través de la aplicación de *Terminal de* la línea de comandos. En el PC, se encuentra disponible como *símbolo* en *accesorios*. + +Lo más probable es que ejecute la CLI de diferentes máquinas, tiene más sentido mantener un repositorio de código fuente remota, cuyos activos que tire hacia abajo para directorios de trabajo local. + +Para instalar el `cordova` de línea de comandos de la herramienta, siga estos pasos: + +1. Descargar e instalar [Node.js][1]. Después de la instalación, usted debe ser capaz de invocar `nodo` o `npm` en su línea de comandos. + +2. Instalar la utilidad de `cordova`. En Unix, prefijando el comando `sudo` de adicional puede ser necesario instalar utilidades de desarrollo en lo contrario restringido directorios: + + $ sudo npm install -g cordova + + + 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. + + [1]: http://nodejs.org/ + +## 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. Ejecute el `cordova -d` para obtener más información sobre el progreso. + +El primer argumento especifica un directorio *Hola* que se generen para su proyecto. Su `www` subdirectorio casas 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. El `config.xml` archivo contiene metadatos importantes necesarios para generar y distribuir la aplicación. + +Los otros dos argumentos son opcionales: el `com.example.hello` argumento proporciona su proyecto con un identificador de dominio inverso de estilo y el `HelloWorld` proporciona texto en pantalla de la aplicación. Puede editar tanto de estos valores más adelante en el `config.xml` archivo. + +## Añadir plataformas + +Todos los comandos posteriores necesitan ejecutarse dentro de directorio del proyecto, o cualquier subdirectorios dentro de su ámbito de aplicación: + + $ cd hello + + +Antes de que usted puede 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 android + $ cordova platform add blackberry10 + $ cordova platform add firefoxos + + +Ejecutar cualquiera de éstos desde una máquina Windows, donde *wp* se refiere a diferentes versiones del sistema operativo Windows Phone: + + $ cordova platform add wp7 + $ cordova platform add wp8 + $ cordova platform add windows8 + $ cordova platform add android + $ cordova platform add blackberry10 + $ cordova platform add firefoxos + + +Ejecutar para comprobar su sistema actual de plataformas: + + $ cordova platforms ls + + +(Nota del `platform` y `platforms` son sinónimos comandos.) + +Ejecutar cualquiera de los siguientes comandos sinónimos para quitar una plataforma: + + $ cordova platform remove blackberry10 + $ cordova platform rm android + + +Ejecución de comandos para agregar o quitar afecta a plataformas el contenido del directorio de *plataformas* 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` . De forma predeterminada, archivo de configuración de cada plataforma se configura para poder acceder a todas las APIs de Cordova. + +Si lo desea, puede utilizar un SDK en este momento para abrir el proyecto que ha creado. Sin embargo, las ediciones en el proyecto dentro de un efecto SDK derivado de la conjunto de activos, no los archivos multiplataforma fuente original. Utilice este método si simplemente desea inicializar un proyecto. (Vea a las guías de plataforma para obtener información sobre cómo desarrollar aplicaciones dentro de cada SDK). Lea sobre si desea usar herramientas de línea de comandos para el ciclo completo de desarrollo. + +## Construir la aplicación + +De forma predeterminada, el `cordova create` script genera una aplicación basada en web esquelética cuya portada es el proyecto `www/index.html` archivo. Editar esta aplicación que quieras, pero cualquier inicialización debe especificarse como parte de la `deviceready` 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 código específico de plataforma dentro del proyecto `platforms` subdirectorio. Opcionalmente puede limitar el alcance de cada generación de plataformas específicas: + + $ cordova build ios + + +El `cordova build` el comando 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 se ejecuta `prepare` , puede utilizar como una alternativa Xcode SDK de Apple 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 aplicación y visualizarlo en 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. (Vea a las guías de plataforma para más detalles). Por ejemplo, usted primero de puede ejecutar el `android` comando para iniciar el SDK de Android, y luego ejecute una imagen del dispositivo en particular, que inicia según su comportamiento predeterminado: + +![][2] + + [2]: img/guide/cli/android_emulate_init.png + +Seguimiento con el `cordova emulate` comando actualiza la imagen de emulador para mostrar la última aplicación, que ahora está disponible para el lanzamiento de la pantalla de Inicio: + +![][3] + + [3]: 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 caso de Android, tienes 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 características + +Al construir 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, sino de la aplicación comunicar estrechamente con varias características de nivel de dispositivo, tienes que 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 para obtener más detalles). Más comúnmente, debe agregar un plugin para activar una de las características básicas de Cordova nivel de dispositivo detallado en la referencia de la API. + +El `cordova plugin add` comando requiere especificar el repositorio para el código del plugin. Estos son ejemplos de funciones que se podría añadir: + +* Información básica del dispositivo (dispositivo API): + + $ cordova plugin add org.apache.cordova.device + + +* Conexión de red y eventos de batería: + + $ cordova plugin add org.apache.cordova.network-information + $ cordova plugin add org.apache.cordova.battery-status + + +* Acelerómetro, brújula y geolocalización: + + $ cordova plugin add org.apache.cordova.device-motion + $ cordova plugin add org.apache.cordova.device-orientation + $ cordova plugin add org.apache.cordova.geolocation + + +* Cámara, reproducción multimedia y captura: + + $ cordova plugin add org.apache.cordova.camera + $ cordova plugin add org.apache.cordova.media-capture + $ cordova plugin add org.apache.cordova.media + + +* Acceder a archivos en el dispositivo o red (archivo API): + + $ cordova plugin add org.apache.cordova.file + $ cordova plugin add org.apache.cordova.file-transfer + + +* Notificación mediante vibración o cuadro de diálogo: + + $ cordova plugin add org.apache.cordova.dialogs + $ cordova plugin add org.apache.cordova.vibration + + +* Contactos: + + $ cordova plugin add org.apache.cordova.contacts + + +* Globalización: + + $ cordova plugin add org.apache.cordova.globalization + + +* SplashScreen: + + $ cordova plugin add org.apache.cordova.splashscreen + + +* Abrir nuevas ventanas del navegador (InAppBrowser): + + $ cordova plugin add org.apache.cordova.inappbrowser + + +* Consola de depuración: + + $ cordova plugin add org.apache.cordova.console + + +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' + [ 'org.apache.cordova.console' ] + + +Para quitar un plugin, referirse a él por el mismo identificador que aparece en el listado. Por ejemplo, aquí es cómo le quita apoyo para una consola de depuración de una versión: + + $ cordova plugin rm org.apache.cordova.console + $ cordova plugin remove org.apache.cordova.console # same + + +Puede lote-quitar o agregar plugins por especificar más de un argumento para cada comando. + +## Personalizar cada plataforma + +Mientras que Córdoba permite implementar fácilmente una aplicación para muchas plataformas diferentes, a veces tienes que añadir personalizaciones. En ese caso, no quieres modificar los archivos de código fuente en varios `www` directorios dentro del nivel superior `platforms` Directorio, porque regularmente reemplazaron con el nivel superior `www` fuente del directorio multiplataforma. + +En cambio, el nivel superior `merges` Directorio ofrece un lugar para especificar activos para desplegar en plataformas específicas. Cada subdirectorio específico de plataforma dentro de `merges` refleja la estructura de directorios de la `www` árbol de código fuente, lo que permite reemplazar o agregar archivos según sea necesario. Por ejemplo, aquí es cómo podrías utiliza `merges` para aumentar el tamaño de fuente por defecto para los dispositivos Android: + +* Editar el `www/index.html` archivo, añadir un enlace a un archivo CSS adicional, `overrides.css` en este caso: + + + + +* 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 para Android cuenta con el tamaño de fuente personalizada, mientras que otros permanecen inalterados. + +También se puede utilizar `merges` para agregar archivos no presenten en el original `www` Directorio. Por ejemplo, una aplicación puede incorporar un gráfico de *botón* en la interfaz de iOS, almacenado en `merges/ios/img/back_button.png` , mientras que la versión de Android puede capturar en su lugar `backbutton` eventos desde el correspondiente botón de hardware. + +## Actualización de Cordova + +Después de instalar el `cordova` utilidad, puede siempre actualizarlo a la versión más reciente ejecutando el siguiente comando: + + $ sudo npm update -g cordova + + +Para instalar una versión específica, utilice esta sintaxis: + + $ sudo npm instalar cordova@3.1.0 -g + + +Ejecute `cordova -v` para ver la versión actualmente en ejecución. Ejecute el `npm +info` comando para obtener una lista más larga que incluye la versión actual junto con otros números de la versión disponible: + + $ npm info cordova + + +Cordova 3.0 es la primera versión compatible con la interfaz de línea de comandos descrita en esta sección. Si actualiza desde una versión anterior a 3.0, tienes que crear un nuevo proyecto como se describió anteriormente, luego copie los activos de 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 estar al día, los más lentos procedimientos descritos allí ya no son relevantes. \ No newline at end of file http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/2b8e503f/docs/es/3.1.0/guide/hybrid/plugins/index.md ---------------------------------------------------------------------- diff --git a/docs/es/3.1.0/guide/hybrid/plugins/index.md b/docs/es/3.1.0/guide/hybrid/plugins/index.md new file mode 100644 index 0000000..c6e2e57 --- /dev/null +++ b/docs/es/3.1.0/guide/hybrid/plugins/index.md @@ -0,0 +1,100 @@ +--- + +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. +--- + +# Guía de desarrollo de plugin + +Un Cordova plugin puentes es quedando un poco de funcionalidad entre el WebView alimentando una aplicación Cordova y la plataforma nativa la aplicación Cordova. Plugins están compuestos de una sola interfaz JavaScript utilizada a través de todas las plataformas y nativas implementaciones siguiendo las interfaces Plugin específica de la plataforma que el JavaScript llama a. Todo el núcleo Cordova APIs se implementan mediante esta arquitectura. + +Pasos de esta guía el proceso de escribir un Plugin sencillo Eco pasa una cadena de JavaScript y lo envía al entorno nativo para las plataformas soportadas. El código nativo entonces devuelve la misma cuerda a las devoluciones de llamada en JavaScript del plugin. + +Esta guía proporciona suficiente Resumen en el cual se pueden construir para escribir plugins más complejos. + +## JavaScript + +El punto de entrada para cualquier plugin es JavaScript. El uso de los desarrolladores razón que Cordova es por lo que pueden utilizar y escribir JavaScript, no Objective-C, no Java, no C#. La interfaz JavaScript para tu plugin es la parte frontal y posiblemente más importante de su plugin Cordova. + +Usted puede estructurar JavaScript de su plugin sin embargo te gusta. Lo único *debe* utilizar para comunicarse entre los entornos nativos y Cordova JavaScript es el `cordova.exec` función. Aquí está un ejemplo: + + cordova.exec(function(winParam) {}, function(error) {}, "service", + "action", ["firstArgument", "secondArgument", 42, + false]); + + +Los parámetros se detallan a continuación: + +* `function(winParam) {}`: Devolución de llamada de función éxito. Asumiendo que tu `exec` llamada se realiza correctamente, esta función es invocada (opcionalmente con cualquier parámetro pasas a él). + +* `function(error) {}`: Devolución de llamada de función error. Si la operación no se completa correctamente, esta función es invocada (opcionalmente con un parámetro de error). + +* `"service"`: El nombre del servicio a lado del nativo. Esto se asigna a una clase nativa, sobre el cual existe más información en las guías nativas enumeradas a continuación. + +* `"action"`: El nombre de la acción a. Esto es recogido por la recepción de la clase nativa la `exec` llamada y, dependiendo de la plataforma, esencialmente los mapas al método de una clase. Los guías nativos a continuación proporcionan detalles. + +* `[/* arguments */]`: Argumentos para pasar al medio ambiente nativo. + +### Ejemplo de JavaScript Plugin echo + + window.echo = function(str, callback) { + cordova.exec(callback, function(err) { + callback('Nothing to echo.'); + }, "Echo", "echo", [str]); + }; + + +Vamos a sumergirnos en esto. El plugin se une a `window` , específicamente a la `echo` función. Los usuarios plugin entonces usaría como sigue: + + window.echo("echome", function(echoValue) { + alert(echoValue == "echome"); // should alert true. + }); + + +Primero, echemos un vistazo a los tres últimos argumentos de la `exec` función. Llamaremos el `Echo` "de servicio", solicitando a la `echo` «acción», y pasar una matriz de argumentos que contiene la cadena Eco, que es el primer parámetro en el `window.echo` función. + +El callback de éxito pasó a `exec` es simplemente una referencia a la devolución de llamada función que `window.echo` lleva. Hacemos un poco más para el callback de error: Si el lado nativo dispara el callback de error, simplemente invocar callback éxito y pasar en él una cadena "por defecto". + +## Especificación de plugin + +Córdoba tiene una especificación plugin disponible para permitir la instalación automática del plugin para Android, iOS, plataformas 10 BlackBerry y Windows Phone. Estructuración de su plugin en forma particular y añadiendo un `plugin.xml` archivo de manifiesto, usted puede habilitar a los usuarios a instalar el plugin mediante las herramientas de línea de comandos. + +* Especificación de plugin + +## Nativo + +Una vez se define JavaScript para tu plugin, debes complementarlo con por lo menos una aplicación nativa. A continuación los detalles para hacerlo para cada plataforma. Estas guías de seguirán construyendo en el simple ejemplo Eco Plugin discutido anteriormente. + +* Android Plugins +* Plugins de blackBerry +* BlackBerry 10 Plugins +* iOS Plugins +* Windows Phone Plugins + +La plataforma Tizen actualmente no soporta plugins. + +## Editorial plugins + +Una vez que desarrollaste tu plugin, deberías publicarla y compartirla con la comunidad. Usted puede publicar su plugin en el registro de cordova (basado en [npmjs][1]) o a cualquier otro npmjs base del registro. Los usuarios podrán instalar automáticamente usando plugman o cordova-cli. + + [1]: https://github.com/isaacs/npmjs.org + +Para publicar un plugin que debes utilizar la herramienta plugman y seguir los siguientes pasos: + + $ plugman adduser # that is if you don't have an account yet + $ plugman publish /path/to/your/plugin + + +Eso es todo! + +Otros comandos de base de registro están disponibles y `plugman --help` le dará una lista de qué comandos están disponibles y cómo utilizarlos. \ No newline at end of file http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/2b8e503f/docs/es/3.1.0/guide/hybrid/webviews/index.md ---------------------------------------------------------------------- diff --git a/docs/es/3.1.0/guide/hybrid/webviews/index.md b/docs/es/3.1.0/guide/hybrid/webviews/index.md new file mode 100644 index 0000000..431252e --- /dev/null +++ b/docs/es/3.1.0/guide/hybrid/webviews/index.md @@ -0,0 +1,22 @@ +--- + +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. +--- + +# Incrustar WebViews + +> Implementar la Cordova WebView en su propio proyecto. + +* Android WebViews +* iOS WebViews \ No newline at end of file http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/2b8e503f/docs/es/3.1.0/guide/overview/index.md ---------------------------------------------------------------------- diff --git a/docs/es/3.1.0/guide/overview/index.md b/docs/es/3.1.0/guide/overview/index.md new file mode 100644 index 0000000..efd3d65 --- /dev/null +++ b/docs/es/3.1.0/guide/overview/index.md @@ -0,0 +1,705 @@ +--- + +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. + + +--- + +# Perspectiva general + +Cordova es un marco de desarrollo móvil de código abierto. Permite utilizar las tecnologías estándar web como HTML5, CSS3 y JavaScript para desarrollo multiplataforma, evitando el lenguaje de desarrollo nativo cada plataformas móviles. Aplicaciones ejecutan dentro de envolturas para cada plataforma y dependen de enlaces estándares API para acceder a de cada dispositivo sensores, datos y estado de la red. + +Utilice Cordova si eres: + +* establecen un móvil desarrollador y desea extender una aplicación a través de más de una plataforma, sin tener que volver a implementarlo con el lenguaje y herramienta de cada plataforma. + +* un desarrollador web y desea implementar una aplicación web que se envasa para su distribución en varias app store portales. + +* un móvil desarrollador interesado en que se mezclan los componentes de la aplicación nativa con una *vista Web* (navegador) que puede tener acceso a las API de nivel de dispositivo, o si quiere desarrollar una interfaz plugin entre componentes WebView y nativos. + +## Componentes básicos + +Cordova aplicaciones se basan en un común `config.xml` archivo que proporciona información acerca de la aplicación y especifica los parámetros que afectan a cómo funciona, como si responde a la orientación cambia de puesto. Este archivo se adhiere a la especificación de [Empaquetado de la aplicación Web][1]o *widget*, de la W3C. + + [1]: http://www.w3.org/TR/widgets/ + +La misma aplicación se implementa como una página web, llamado *index.html* por defecto, que hace referencia a cualquier CSS, JavaScript, imágenes, archivos multimedia, u otros recursos son necesarios para que se ejecute. La aplicación se ejecuta como un *WebView* dentro de la envoltura de la aplicación nativa, que distribuye a tiendas de aplicaciones. De la aplicación web interactuar con varias características del dispositivo hacer las aplicaciones de forma nativas, lo debe hacer también referencia a un `cordova.js` archivo, el cual proporciona enlaces de API. + +El WebView Cordova habilitado puede proporcionar la aplicación con su interfaz de usuario completa. También puede ser un componente dentro de una aplicación híbrida más grande, que mezcla la vista Web con componentes de una aplicación nativa. Cordova proporciona una interfaz de *plugin* para estos componentes para comunicarse con los demás. + +## Vías de desarrollo + +Es la forma más fácil de configurar una aplicación ejecutar el `cordova` utilidad de línea de comandos, también conocida como la *interfaz de línea de comandos* (CLI). (Para instalar la CLI, vea la interfaz de línea de comandos). Según el conjunto de plataformas de destino, usted puede confiar en la CLI para progresivamente mayores acciones del ciclo de desarrollo: + +* En el escenario más básico, puede utilizar el CLI simplemente para crear un nuevo proyecto que se rellena con la configuración por defecto para modificar. + +* Para muchas plataformas móviles, también puede utilizar la CLI para configurar los ficheros de proyecto adicional necesarios para compilar dentro de cada SDK. Para que funcione, es necesario instalar el SDK de la plataforma de cada destino. (Vea a las guías de plataforma para obtener instrucciones). Como se indica en la tabla de soporte de plataformas, necesitará ejecutar el CLI en diferentes sistemas operativos, dependiendo de la plataforma de destino. + +* Para apoyar las plataformas, la CLI puede compilar aplicaciones ejecutables y ejecutarlos en un emulador de dispositivos basados en SDK. para la prueba integral, también puede generar archivos de aplicación e instalarlos directamente en un dispositivo. + +En cualquier punto en el ciclo de desarrollo, también puede confiar en herramientas específicas para la plataforma SDK, que pueden proporcionar un rico conjunto de opciones. (Vea las guías de plataforma para obtener más información sobre herramienta de SDK de la plataforma cada conjunto). Un entorno SDK es más apropiado si desea implementar una aplicación híbrida que combina componentes de la aplicación basada en web y nativas. puede utilizar la utilidad de línea de comandos para generar inicialmente la aplicación, o iterativamente posteriormente para alimentar el código actualizado a SDK tools. Usted puede también constrúyete archivo de configuración de la aplicación. + + + + + +## Soporte de plataformas + +A continuación muestra el conjunto de herramientas de desarrollo y dispositivo API disponibles para cada plataforma móvil. (Encabezados de columna Mostrar recibos de forma abreviada de la CLI). + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + Android + + BlackBerry (6) + + blackberry10 + + Ios + + WP7 (Windows
Phone 7) + 		+ WP8 (Windows
Teléfono 8) + 		+ win8
(Windows 8) + 		+ firefoxos + + Tizen +
+ cordova
CLI + 		+ Mac, Windows, Linux + + Mac, Windows + + Mac, Windows + + Mac + + Windows + + Windows + + +
+ Incrustado
WebView + 		+ (ver detalles) + + + + (ver detalles) + + + + +
+ Plug-in
Interfaz + 		+ (ver detalles) + + (ver detalles) + + (ver detalles) + + (ver detalles) + + (ver detalles) + + + +
+ + Plataforma API +
+ Acelerómetro + + + + + + + + +
+ Cámara + + + + + + + + +
+ Captura + + + + + + + + +
+ Brújula + + + + + (3GS +) + + + + +
+ Conexión + + + + + + + + +
+ Contactos + + + + + + + + +
+ Dispositivo + + + + + + + + +
+ Eventos + + + + + + + + +
+ Archivo + + + + + + No File Transfer + + No File Transfer + + +
+ Geolocalización + + + + + + + + +
+ Globalización + + + + + + + + +
+ InAppBrowser + + + + + + + + +
+ Los medios de comunicación + + + + + + + + +
+ Notificación + + + + + + + + +
+ SplashScreen + + + + + + + + +
+ Almacenamiento de información + + + + + + localStorage sólo + + localStorage sólo + + +
+ + \ No newline at end of file http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/2b8e503f/docs/es/3.1.0/guide/platforms/android/config.md ---------------------------------------------------------------------- diff --git a/docs/es/3.1.0/guide/platforms/android/config.md b/docs/es/3.1.0/guide/platforms/android/config.md new file mode 100644 index 0000000..b1d4bdd --- /dev/null +++ b/docs/es/3.1.0/guide/platforms/android/config.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. +--- + +# Configuración de Android + +El archivo `config.xml` controla la configuración básica de una app que se aplican a través de cada aplicación y una instancia de CordovaWebView. Esta sección detalla las preferencias que se aplican sólo a estructuras Android. Vea el archivo config.xml archivo para obtener información sobre las opciones de configuración global. + +* `KeepRunning` (por defecto valor booleano, `true`): determina si la aplicación queda funcionando en segundo plano, incluso después de un `pause` de evento se desencadena. + + + + +* `ErrorUrl`: especifica una página de error que aparece en respuesta a los errores estándar HTTP en el rango de 400-500. Coloque el archivo especificado en el nivel de directorio que contiene la página de inicio y otros activos de la web. + + + + +* `LoadingDialog`: muestra un diálogo nativo cuando se carga la aplicación. El formato del valor es *título, mensaje* + + + + +* `LoadingPageDialog`: muestra un diálogo nativo al cargar subpáginas dentro de una aplicación. El formato del valor es *título, mensaje* + + + + +* `LoadUrlTimeoutValue` (número, el valor predeterminado es `20000`): cuando se carga una página, la cantidad de tiempo de espera antes de tirar un error de tiempo de espera. Este ejemplo especifica 10 segundos en lugar de 20: + + + + +* `SplashScreen`: el nombre del archivo sin su extensión en el directorio `res/drawable`. Varios activos deben compartir este nombre común en diferentes subdirectorios. + + + + +* `SplashScreenDelay` (número, el valor predeterminado de `5000`): la cantidad de tiempo que muestra la imagen en pantalla splash. + + \ No newline at end of file http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/2b8e503f/docs/es/3.1.0/guide/platforms/android/index.md ---------------------------------------------------------------------- diff --git a/docs/es/3.1.0/guide/platforms/android/index.md b/docs/es/3.1.0/guide/platforms/android/index.md new file mode 100644 index 0000000..9482286 --- /dev/null +++ b/docs/es/3.1.0/guide/platforms/android/index.md @@ -0,0 +1,188 @@ +--- + +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. +--- + +# Guía de la plataforma Android + +Esta guía le muestra cómo configurar el entorno de desarrollo SDK para desplegar aplicaciones Cordova para dispositivos Android. Vea el siguiente para obtener más información específica de la plataforma: + +* Configuración de Android +* Android WebViews +* Android Plugins +* Actualizar Android +* Android Herramientas de línea de comandos + +Las herramientas de línea de comandos anteriores se refieren a las versiones anteriores Cordova 3.0. Ver la interfaz de línea de comandos de Cordova para obtener más información sobre la interfaz actual. + +## Requisitos y apoyo + +Consulte los [requisitos del sistema][1] para el SDK de Android. + + [1]: http://developer.android.com/sdk/index.html + +Cordova soporta Android 2.2, 2.3 y 4.x. Como regla general, las plataformas son desaprobadas como sumergen por debajo del 5% en del Google [tablero de distribución][2]. + + [2]: http://developer.android.com/about/dashboards/index.html + + + +Los desarrolladores deberían usar la `cordova` utilidad en conjunción con el SDK de Android. Ver la interfaz de línea de comandos para obtener información como instalarlo, agregar proyectos, entonces construir e implementar un proyecto. + +## Instalar el SDK + +Instalar el SDK de Android desde [developer.android.com/sdk][3]. De lo contrario usted puede presentarse con una selección de donde instalar el SDK, mueva el descargado `adt-bundle` árbol a dondequiera que usted almacenar herramientas de desarrollo. + + [3]: http://developer.android.com/sdk/ + +Cordova Herramientas de línea de comandos trabajar, es necesario incluir el SDK `tools` y `platform-tools` directorios en su entorno PATH. En Mac, puede utilizar un editor de texto para crear o modificar el `~/.bash_profile` archivo, añadir una línea como la siguiente, dependiendo de donde se instala el SDK: + + export PATH=${PATH}:/Development/adt-bundle/sdk/platform-tools:/Development/adt-bundle/sdk/tools + + +Esto expone SDK tools en windows terminales recién inauguradas. De lo contrario corre para que estén disponibles en el actual período de sesiones: + + $ source ~/.bash_profile + + +Para modificar el entorno PATH en Windows 7: + +* Haga clic en el menú de **Inicio** en la esquina inferior izquierda del escritorio, haga clic en la **computadora**, luego haga clic en **Propiedades**. + +* En la columna de la izquierda, haga clic en **Configuración avanzada del sistema** . + +* En el cuadro de diálogo resultante, pulse **Las Variables de entorno**. + +* Seleccionar la variable **PATH** y pulse **Editar**. + +* Agregue lo siguiente a la ruta basada en donde se ha instalado el SDK, por ejemplo: + + ;C:\Development\adt-bundle\sdk\platform-Tools;C:\Development\adt-bundle\sdk\tools + + +* El valor de guardar y cerrar ambos cuadros de diálogo. + +También necesitará habilitar Java y Ant. abrir un símbolo del sistema y el tipo `java` y también de tipo `ant` . Anexar a la trayectoria de cualquiera que no se puedan ejecutar: + + ; %JAVA_HOME%\bin;%ANT_HOME%\bin + + +## Abrir un proyecto en el SDK + +Uso el `cordova` utilidad para configurar un nuevo proyecto, como se describe en el Cordova la línea de comandos de interfaz. Por ejemplo, en un directorio del código fuente: + + $ cordova crear Hola com.example.hello "HelloWorld" $ cd Hola $ cordova plataforma añadir construir android $ cordova + + +Una vez creado, aquí es cómo utilizar el SDK para modificarlo: + +* Inicie la aplicación de **Eclipse** . + +* Seleccione el elemento de menú **Nuevo proyecto** . + +* Elija **Proyecto Android de código existente** en el cuadro de diálogo resultante y pulse **siguiente**: ![][4] + +* Vaya a `hello` , o cualquier directorio que creó para el proyecto, luego en el `platforms/android` subdirectorio. + +* Pulse **Finalizar**. + + [4]: img/guide/platforms/android/eclipse_new_project.png + +Una vez que se abre la ventana de Eclipse, puede aparecer una **X** de color rojo indicar los problemas irresueltos. Si es así, siga estos pasos adicionales: + +* Haga clic en el directorio del proyecto. + +* En el cuadro de diálogo **Propiedades** resultante, seleccione **Android** desde el panel de navegación. + +* Para el proyecto de construcción de destino, seleccione el nivel más alto de la API de Android instalado. + +* Haga clic en **Aceptar**. + +* Seleccione el menú **proyecto** **limpio** . Esto debe corregir todos los errores en el proyecto. + +## Desplegar en emulador + +Puede utilizar la `cordova` utilidad para ejecutar una aplicación en un emulador, o usted puede ejecutar dentro del SDK. De cualquier manera, el SDK primero debe configurarse para mostrar al menos un dispositivo. Para ello, utilice el Android SDK Manager, una aplicación Java que funciona por separado del Eclipse. Hay dos maneras para abrirlo: + +* Ejecute `android` en la línea de comandos. + +* Desde dentro de Eclipse, presione este icono de la barra de herramientas: + + ![][5] + + [5]: img/guide/platforms/android/eclipse_android_sdk_button.png + +Una vez abierto, el Android SDK Manager muestra varias bibliotecas de tiempo de ejecución: + +![][6] + + [6]: img/guide/platforms/android/asdk_window.png + +Elija **Herramientas → administrar AVDs** (Android dispositivos virtuales), a continuación elegir cualquier artículo de **Definiciones de dispositivos** en el cuadro de diálogo resultante: + +![][7] + + [7]: img/guide/platforms/android/asdk_device.png + +Pulse **Crear AVD**, opcionalmente modificar el nombre, luego pulse **OK** para aceptar los cambios: + +![][8] + + [8]: img/guide/platforms/android/asdk_newAVD.png + +La AVD entonces aparece en la lista de **Dispositivos Android Virtual** : + +![][9] + + [9]: img/guide/platforms/android/asdk_avds.png + +Para abrir el emulador como una aplicación independiente, seleccione la AVD y presione **Start**. Se lanza como lo haría en el dispositivo, con controles adicionales disponibles para los botones de hardware: + +![][10] + + [10]: img/guide/platforms/android/asdk_emulator.png + +En este punto se puede utilizar la `cordova` utilidad para desplegar la aplicación en el emulador desde la línea de comandos: + + $ cordova emular android + + +Si en cambio están trabajando dentro de Eclipse, haga clic derecho en el proyecto y elija **ejecuta como → aplicación para Android**. Se le podría especificar una AVD si no aparece ninguna ya abierto. + +Para una experiencia más rápida, utilice una imagen de emulador basados en Intel: + +* Instalar uno o más `Intel x86 Atom` imágenes del sistema así como el `Intel Hardware Accelerated Execution Manager` , disponible bajo **Extras**. + +* Ejecute al instalador de Intel, que está disponible en el SDK de Android en`extras/intel/Hardware_Accelerated_Execution_Manager`. + +* Crear un nuevo AVD con el objetivo fijado a una imagen de Intel. + +* Al iniciar el emulador, asegúrese que no hay error mensajes indicando la imposibilidad de cargar módulos HAX. + +## Desplegar en el dispositivo + +Para empujar una aplicación directamente al dispositivo, asegúrese de depuración USB está habilitado en el dispositivo como se describe en el [Sitio para desarrolladores de Android][11]y utilice un cable mini-USB para conectarlo a su sistema. + + [11]: http://developer.android.com/tools/device.html + +Usted puede empujar la aplicación al dispositivo de la línea de comandos: + + $ cordova corre android + + +Alternativamente dentro de Eclipse, haga clic derecho en el proyecto y elija **ejecuta como → aplicación para Android**. \ No newline at end of file http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/2b8e503f/docs/es/3.1.0/guide/platforms/android/plugin.md ---------------------------------------------------------------------- diff --git a/docs/es/3.1.0/guide/platforms/android/plugin.md b/docs/es/3.1.0/guide/platforms/android/plugin.md new file mode 100644 index 0000000..a2e2697 --- /dev/null +++ b/docs/es/3.1.0/guide/platforms/android/plugin.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. +--- + +# Android Plugins + +Escribir un plugin requiere una comprensión de la arquitectura de Córdoba-Android. Cordova-Android consta de un WebView androide con ganchos conectados a él. Estos plugins son representados como asignaciones de clase en el `config.xml` archivo. + +Un plugin consiste en por lo menos una clase Java que extiende la `CordovaPlugin` clase. Un plugin debe reemplazar uno de los `execute` métodos de `CordovaPlugin` . Como mejor práctica, debe manejar el plugin `pause` y `resume` eventos y cualquier mensaje pasando entre plugins. Plugins con solicitudes de larga duración, actividad de fondo como medios de reproducción, los oyentes o estado interno debe implementar el `onReset()` método también. Se ejecuta cuando el `WebView` se desplaza a una nueva página o actualizaciones, que vuelve a cargar el JavaScript. + +## Asignación de clase plugin + +La porción de un plugin de JavaScript siempre utiliza el método `cordova.exec` como sigue: + + exec(, , , , []); + + +Esto mariscales una solicitud de la WebView al lado nativo Android, más o menos hirviendo a llamar al método de `action` en la clase de `service`, con los argumentos pasados en la `args` Array. + +Si usted distribuye su plugin como archivo de Java o un frasco de su propio, el plugin debe agregarse a la `config.xml` archivo en de su aplicación Cordova-Android `res/xml/` Directorio. + + + + + + +El nombre de servicio debe coincidir con la que se utiliza en la llamada `exec` de JavaScript, y el valor es el nombre completo de clases Java, incluyendo el espacio de nombres. De lo contrario el plugin puede compilar pero siendo inalcanzable por Córdoba. + +## Escribir un Plugin de Java Android + +JavaScript dispara una solicitud plugin nativo al lado. El plugin de Java Android se asigna correctamente mediante el archivo `config.xml`. Así qué ¿te parece la clase final de Android Java Plugin? + +¿Qué obtiene despachó al plugin vía la función de JavaScript `exec` se pasa en el método de `ejecución` de la clase de Plugin. La mayoría de las implementaciones de `execute` este aspecto: + + @Override public boolean ejecutar (acción de las cuerdas, JSONArray args, CallbackContext callbackContext) lanza JSONException {si ("beep".equals(action)) {this.beep(args.getLong(0)); + callbackContext.success(); + devuelve true; + } return false; / / Devolver resultados falsos en un error de "MethodNotFound". + } + + +Comparamos el valor del parámetro `action` y enviar la solicitud de un método (privada) en la clase, opcionalmente pasando algunos de los parámetros del método. + +Cuando captura de excepciones y devolver errores, es importante en aras de la claridad que los errores devueltos a nombres de excepción de JavaScript partido Java tanto como sea posibles. + +### Threading + +JavaScript en el WebView hace *no* ejecuta en el subproceso de la interfaz de usuario. Se ejecuta en el subproceso WebCore. El `execute` método también se ejecuta en el subproceso WebCore. + +Si usted necesita interactuar con la interfaz de usuario, debe usar la siguiente: + + @Override + public boolean execute(String action, JSONArray args, final CallbackContext callbackContext) throws JSONException { + if ("beep".equals(action)) { + final long duration = args.getLong(0); + cordova.getActivity().runOnUiThread(new Runnable() { + public void run() { + ... + callbackContext.success(); // Thread-safe. + } + }); + return true; + } + return false; + } + + +Si no tienes que correr en el subproceso de la interfaz de usuario, pero no queremos bloquear el subproceso WebCore: + + @Override + public boolean execute(String action, JSONArray args, final CallbackContext callbackContext) throws JSONException { + if ("beep".equals(action)) { + final long duration = args.getLong(0); + cordova.getThreadPool().execute(new Runnable() { + public void run() { + ... + callbackContext.success(); // Thread-safe. + } + }); + return true; + } + return false; + } + + +### Ejemplo de Plugin Android echo + +Añadir lo siguiente a nuestro archivo `config.xml`: + + + + + + +Luego añadir el siguiente archivo a `src/org/apache/cordova/plugin/Echo.java` dentro de nuestra aplicación de Cordova-Android: + + package org.apache.cordova.plugin; + + import org.apache.cordova.CordovaPlugin; + import org.apache.cordova.CallbackContext; + + import org.json.JSONArray; + import org.json.JSONException; + import org.json.JSONObject; + + /** + * This class echoes a string called from JavaScript. + */ + public class Echo extends CordovaPlugin { + + @Override + public boolean execute(String action, JSONArray args, CallbackContext callbackContext) throws JSONException { + if (action.equals("echo")) { + String message = args.getString(0); + this.echo(message, callbackContext); + return true; + } + return false; + } + + private void echo(String message, CallbackContext callbackContext) { + if (message != null && message.length() > 0) { + callbackContext.success(message); + } else { + callbackContext.error("Expected one non-empty string argument."); + } + } + } + + +Echemos un vistazo al código. Las necesarias `imports` están en la parte superior. Nuestra clase se extiende desde `CordovaPlugin`. Sobreescribimos el método execute() para poder recibir mensajes de exec(). Nuestro método compara primero contra `action`: este plugin soporta sólo una acción, la acción de `echo`. Cualquier otra acción devuelve `false` , que se traduce en un error de tipo `INVALID_ACTION` , que se traduce en una invocación de callback de error en el lado de JavaScript. A continuación, tomamos la cadena Eco, usando el método `getString` sobre nuestro `args`, diciendo lo que queremos conseguir el décimo parámetro en la matriz de parámetros. Hacemos un poco de control de parámetro: Asegúrese de que no es `null` y asegúrese de que no es una cadena de longitud cero. Si lo es, lo llamamos `callbackContext.error()` (que, por ahora, deberías saber invoca la devolución de llamada de error). Si todos esos cheques pasan, entonces nos llame `callbackContext.succ ess()` y pase en la cadena de `message` que hemos recibido como parámetro. Esto finalmente se traduce en una invocación de devolución de llamada de éxito en el lado de JavaScript. También pasa el parámetro del `message` como un parámetro a la función de devolución de llamada JavaScript éxito. + +## Plugins de depuración + +Eclipse puede utilizarse para depurar un proyecto de Android, y los plugins puede ser depurados si la fuente de Java está incluida en el proyecto. Sólo la versión más reciente de las herramientas de Desarrollador Android es conocida para permitir el apego de código fuente a dependencias JAR, así que esto no es totalmente compatible en este momento. + +## Errores comunes + +* Plugins tienen acceso a un `CordovaInterface` objeto. Este objeto tiene acceso al androide `Activity` que está ejecutando la aplicación. Esta es la `Context` necesaria para lanzar un nuevo Android `Intent` . El `CordovaInterface` permite plugins comenzar una `Activity` para obtener un resultado y para establecer el plugin de devolución de llamada para cuando el `Intent` vuelve a la aplicación. Esto es importante, desde el `Intent` el sistema es cómo Android se comunica entre procesos. + +* Plugins no tienen acceso directo a la `Context` como lo han hecho en el pasado. El legado `ctx` miembro es obsoleto y se quitarán seis meses después de haber liberado 2.0. Todos `ctx` , existen métodos en el `Context` , así que ambos `getContext()` y `getActivity()` son capaces de devolver el objeto correcto es necesario. + +## Uso de la fuente + +Una de las mejores maneras de prepararse para escribir tu propio plugin es para [revisar plugins existentes][1]. + + [1]: https://github.com/apache/cordova-android/tree/master/framework/src/org/apache/cordova + +También debería leer los comentarios en [CordovaPlugin.java][2]. + + [2]: https://github.com/apache/cordova-android/blob/master/framework/src/org/apache/cordova/CordovaPlugin.java \ No newline at end of file http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/2b8e503f/docs/es/3.1.0/guide/platforms/android/tools.md ---------------------------------------------------------------------- diff --git a/docs/es/3.1.0/guide/platforms/android/tools.md b/docs/es/3.1.0/guide/platforms/android/tools.md new file mode 100644 index 0000000..6aa4513 --- /dev/null +++ b/docs/es/3.1.0/guide/platforms/android/tools.md @@ -0,0 +1,66 @@ +--- + +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. +--- + +# Android Herramientas de línea de comandos + +La utilidad de línea de comandos de `cordova` es una herramienta de alto nivel que le permite construir aplicaciones a través de varias plataformas a la vez. Una versión anterior del marco Cordova ofrece conjuntos de herramientas de línea de comandos específicos de cada plataforma. Para usarlos como una alternativa a la CLI, tienes que descargar esta versión de Córdoba desde [cordova.apache.org][1]. La descarga contiene los archivos separados para cada plataforma. Ampliar la plataforma de destino. Las herramientas aquí descritas están normalmente disponibles en el directorio `bin` de nivel superior, de lo contrario, consulte el archivo **README** para instrucciones más detalladas. + + [1]: http://cordova.apache.org + +## Crear un proyecto + +Ejecute el comando `create`, especificando la ruta existente para el proyecto, el identificador de paquete de reversa-dominio-estilo y nombre para mostrar de la aplicación. Aquí está la sintaxis para Mac y Windows: + + $ /path/to/cordova-android/bin/create /path/to/project com.example.project_name ProjectName + $ C:\path\to\cordova-android\bin\create.bat C:\path\to\project com.example.project_name ProjectName + + +## Construir + +Esto limpia entonces construye un proyecto. + +Depuración, en Mac o Windows: + + $ /path/to/project/cordova/build --debug + $ C:\path\to\project\cordova\build.bat --debug + + +Liberación, en Mac o Windows: + + $ /path/to/project/cordova/build --release + $ C:\path\to\project\cordova\build.bat --release + + +## Ejecute la aplicación + +El comando `run` acepta los siguientes parámetros *opcionales*: + +* Especificación del objetivo. Esto incluye `--emulator` , `--device` , o`--target=`. + +* Construir especificación. Esto incluye `--debug` , `--release` , o`--nobuild`. + + $ /path/to/project/cordova/run \[destino\] \[Build\] $ C:\path\to\project\cordova\run.bat \[destino\] \[Build\] + +Asegúrese de crear al menos un Virtual dispositivo Android, caso contrario se le pedirá a hacerlo con el `android` comando. Se si más de una AVD está disponible como un objetivo, le pedirá que seleccione una. Por defecto el `run` comando detecta un dispositivo conectado, o un emulador ejecutando si no se encuentra ningún dispositivo. + +## Tala + + $ /path/to/project/cordova/log $ C:\path\to\project\cordova\log.bat + + +### Limpieza + + $ /path/to/project/cordova/clean $ C:\path\to\project\cordova\clean.bat \ No newline at end of file