http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/21c8e8f0/www/docs/es/6.x/guide/next/index.md ---------------------------------------------------------------------- diff --git a/www/docs/es/6.x/guide/next/index.md b/www/docs/es/6.x/guide/next/index.md new file mode 100644 index 0000000..b64ee16 --- /dev/null +++ b/www/docs/es/6.x/guide/next/index.md @@ -0,0 +1,258 @@ +--- +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: Próximos pasos +--- + +# Próximos pasos + +Para los desarrolladores que tienen una comprensión de cómo utilizar el CLI Cordova y hacer uso de plugins, hay algunas cosas que usted puede desear considerar investigar junto a construir mejor, más performantes Cordova aplicaciones. El siguiente documento ofrece consejos sobre diversos temas relativos a las mejores prácticas, pruebas, actualizaciones y otros temas, pero no está destinado a ser prescriptivo. Considera esto como su punta de lanza para su crecimiento como desarrollador de Córdoba. Además, si ves algo que se puede mejorar, por favor [contribuir][1]! + + [1]: http://cordova.apache.org/#contribute + +Esta guÃa contiene los siguientes temas: + +* Mejores prácticas +* Manejo de actualizaciones +* Prueba aplicaciones de Cordova +* Depurar aplicaciones de Cordova +* Interfaz de usuario +* Consideraciones especiales +* Mantenerse al dÃa +* Cómo obtener ayuda + +# Mejor desarrollo de aplicaciones prácticas Córdoba + +## 1) SPA es tu amigo + +Primero y más importante - sus aplicaciones Cordova deberÃan adoptar el diseño SPA (sola página aplicación). Vagamente definido, un SPA es una aplicación de cliente que se ejecuta desde una petición de una página web. El usuario carga un conjunto inicial de recursos (HTML, CSS y JavaScript) y más actualizaciones (mostrando una nueva vista, carga de datos) se realiza mediante AJAX. Balnearios comúnmente se utilizan para aplicaciones más complejas del lado del cliente. GMail es un gran ejemplo de esto. Después de cargar GMail, correo vistas, edición y organización se realizan mediante la actualización del DOM en lugar de en realidad dejar la página actual para cargar uno completamente nuevo. + +Usando un SPA puede ayudarle a organizar su solicitud de una manera más eficiente, pero también tiene beneficios especÃficos para aplicaciones de Córdoba. Una aplicación de Córdoba debe esperar para que el evento [deviceready](../../cordova/events/events.deviceready.html) disparar antes de que puede utilizarse cualquier plugins. Si usted no utiliza un SPA, y el usuario hace clic en ir de una página a otra, tendrás que esperar a que [deviceready](../../cordova/events/events.deviceready.html) disparar otra vez antes de hacer uso de un plugin. Esto es fácil de olvidar como su aplicación consigue más grande. + +Incluso si usted decide no utilizar Cordova, creando una aplicación móvil sin necesidad de utilizar una arquitectura única página tendrá consecuencias graves rendimiento. Esto es porque navegando entre páginas requerirá guiones, activos, etc., para ser recargadas. Incluso si estos activos se almacenan en caché, todavÃa habrá problemas de performance. + +Son ejemplos de bibliotecas SPA que se pueden utilizar en sus aplicaciones de Córdoba: + +* [AngularJS][2] +* [EmberJS][3] +* [Columna vertebral][4] +* [Kendo UI][5] +* [Monaca][6] +* [ReactJS][7] +* [Sencha Touch][8] +* [jQuery Mobile][9] + + [2]: http://angularjs.org + [3]: http://emberjs.com + [4]: http://backbonejs.org + [5]: http://www.telerik.com/kendo-ui + [6]: http://monaca.mobi/en/ + [7]: http://facebook.github.io/react/ + [8]: http://www.sencha.com/products/touch/ + [9]: http://jquerymobile.com + +Y muchos, muchos más. + +## 2) consideraciones de rendimiento + +Uno de los mayores errores que puede hacer un nuevo desarrollador Cordova es suponer que el rendimiento que sacan de una máquina de escritorio es el mismo que van a salir en un dispositivo móvil. Mientras que nuestros dispositivos móviles han conseguido más de gran alcance cada año, todavÃa carecen de la potencia y el rendimiento de un ordenador de sobremesa. Dispositivos móviles suelen tienen mucho menos memoria RAM y una GPU que dista mucho de su escritorio (o incluso portátil) hermanos. Una lista completa de sugerencias aquà serÃa demasiado, pero aquà están algunas cosas a tener en cuenta (con una lista de más recursos al final para futuras investigaciones). + +**Haga clic en comparación con tacto** - el error más grande y más simple que usted puede hacer es utilizar eventos de clic. Mientras estos "trabajaren" muy bien en el móvil, mayorÃa de los dispositivos impone un retraso de 300ms sobre ellos con el fin de distinguir entre un toque y un toque "hold" evento. Usando `touchstart` , o `touchend` , resultará en una mejora dramática - 300ms no parece mucho, pero puede resultar en un desigual comportamiento y las actualizaciones de la interfaz de usuario. También debe considerar el hecho de que "tocar" eventos no son compatibles en los navegadores no-webkit, ver [CanIUse][10]. Con el fin de hacer frente a estas limitaciones, puedes retirada varias bibliotecas como HandJS y Fastouch. + + [10]: http://caniuse.com/#search=touch + +**Las transiciones CSS versus manipulación DOM** - usando las transiciones CSS hardware acelerado será significativamente mejor que usando JavaScript para crear animaciones. Ver la lista de recursos al final de esta sección para ver ejemplos. + +**Redes chupa** - Ok, redes no siempre apestan, pero la latencia de las redes móviles, redes móviles incluso buenas, es peor que ustedes piensan. Una aplicación de escritorio que sorbe abajo 500 filas de datos JSON, cada 30 segundos, será más lento en un dispositivo móvil, asà como un cerdo de baterÃa. Tenga en cuenta que las apps Cordova tienen múltiples maneras de conservar los datos en la aplicación (LocalStorage y el sistema de archivos por ejemplo). Almacenar en caché datos localmente y ser consciente de la cantidad de datos que envÃa hacia adelante y hacia atrás. Esta es una consideración especialmente importante cuando la aplicación está conectada en una red celular. + +**Recursos y artÃculos de rendimiento adicional** + +* ["Usted medio culos"][11] +* ["Los mejores diez consejos de rendimiento para aplicaciones hÃbridas y PhoneGap"][12] +* ["Rápidas aplicaciones y sitios con JavaScript"][13] + + [11]: http://sintaxi.com/you-half-assed-it + [12]: http://coenraets.org/blog/2013/10/top-10-performance-techniques-for-phonegap-and-hybrid-apps-slides-available/ + [13]: https://channel9.msdn.com/Events/Build/2013/4-313 + +## 3) reconocer y manejar el estado Offline + +Ver los consejos anteriores sobre redes. No sólo puede ser una red lenta, es totalmente posible para su aplicación a estar completamente fuera de servicio. Su aplicación debe manejarlo de una manera inteligente. Si su aplicación no, la gente pensará que su aplicación está rota. Teniendo en cuenta lo fácil que es manejar (Cordova soporta ambos un evento offline y online), no hay ninguna razón para que su aplicación no responden bien cuando se ejecuta fuera de lÃnea. Asegúrese de probar (véase la sección de pruebas) la aplicación y asegúrese de probar cómo maneja su aplicación al iniciar en un estado y luego cambiar a la otra. + +Tenga en cuenta que los eventos online y offline, asà como la API de conexión de red no es perfecta. Puede que necesites recurrir a mediante una petición XHR para ver si el dispositivo está verdaderamente fuera de lÃnea o en lÃnea. Al final del dÃa, ser seguro que añadir algún tipo de ayuda para problemas de la red - de hecho, la tienda de Apple (y probablemente otras tiendas) rechazará apps que no manejarán adecuadamente los Estados offline y online. Para más información sobre este tema, vea ["Está esta cosa?"][14] + + [14]: http://blogs.telerik.com/appbuilder/posts/13-04-23/is-this-thing-on-%28part-1%29 + +# Manejo de actualizaciones + +## Cordova proyectos de mejora + +Si su proyecto existente fue creado usando Cordova 3.x, puede actualizar el proyecto mediante la emisión de los siguientes: + + Cordova plataforma actualización plataforma-nombre ios, android, etc.. + + +Si su proyecto existente se creó en una versión anterior Cordova 3.x, probablemente serÃa mejor crear un nuevo proyecto de Cordova 3.x y luego copiar código y activos existentes de su proyecto para el nuevo proyecto. Pasos habituales: + +* Crear un nuevo proyecto de Cordova 3.x (cordova crear...) +* Copia la carpeta www de su viejo proyecto para el nuevo proyecto +* Copiar cualquier configuración del viejo proyecto para el nuevo proyecto +* Añadir algún plugin usado en el viejo proyecto para el nuevo proyecto +* Construya su proyecto +* Prueba, prueba, prueba! + +Independientemente de la versión anterior del proyecto, es imprescindible que lea sobre lo que cambió en la versión actualizada, ya que la actualización puede romper su código. Será el mejor lugar para encontrar esta información en las notas publicadas en el blog de Cordova tanto en los repositorios. Usted querrá probar su aplicación cuidadosamente para verificar que está funcionando correctamente después de realizar la actualización. + +Nota: algunos plugins no sean compatibles con la nueva versión de Córdoba. Si un plugin no es compatible, usted puede ser capaz de encontrar un plugin de reemplazo que hace lo que usted necesita, o puede que necesites retrasar la actualización de su proyecto. Alternativamente, alterar el plugin para que funcione bajo la nueva versión y contribuir a la comunidad. + +## Actualizaciones del plugin + +A partir de 3.4 Cordova, no hay ningún mecanismo para actualizar plugins cambiante utilizando un único comando. En cambio, quitar el plugin y agregar nuevamente a su proyecto, y se instalará la nueva versión: + + Cordova plugin rm com.some.plugin cordova plugin agregar com.some.plugin + + +Asegúrese de consultar la documentación del plugin actualizado, como puede que deba ajustar el código para trabajar con la nueva versión. También, asegurate de que la nueva versión del plugin funciona con la versión de su proyecto de Córdoba. + +Siempre pruebe sus aplicaciones para asegurarse de que instalar el nuevo plugin no ha roto algo que no previó. + +Si su proyecto tiene un montón de plugins que necesitas actualizar, puede salvar tiempo para crear un script de shell o lote que quita y agrega los plugins con un solo mando. + +# Prueba aplicaciones de Cordova + +Prueba de sus aplicaciones es súper importante. El equipo de Córdoba utiliza jazmÃn pero hará ninguna solución prueba web unidad amigable. + +## Pruebas en un simulador de vs en un dispositivo real + +No es infrecuente usar los navegadores de escritorio y dispositivos simuladores/emuladores al desarrollar una aplicación de Córdoba. Sin embargo, es muy importante que pruebe su aplicación en dispositivos fÃsicos tantos como puedas: + +* Simuladores son sólo eso: simuladores. Por ejemplo, su aplicación puede trabajar en el simulador de iOS sin problema, pero no puede fallar en un dispositivo real (especialmente en determinadas circunstancias, como un estado bajo de memoria). O bien, su aplicación puede fallar en realidad en el simulador mientras que funciona bien en un dispositivo real. +* Emuladores son sólo eso: emuladores. No representan asà su aplicación se ejecuta en un dispositivo fÃsico. Por ejemplo, algunos emuladores pueden procesar su aplicación con una pantalla de confusa, mientras que un dispositivo real no tiene ningún problema. (Si encuentra este problema, deshabilite el anfitrión GPU en el emulador). +* Simuladores son generalmente más rápidos que su dispositivo fÃsico. Emuladores, por el contrario, son generalmente más lentos. No juzgo el rendimiento de su aplicación por cómo se realiza en un simulador o un emulador. Juzgar el rendimiento de su aplicación por cómo se ejecuta en un espectro de dispositivos reales. +* Es imposible conseguir una buena sensación de cómo su aplicación responde al tacto mediante el uso de un simulador o un emulador. En cambio, ejecutando la aplicación en un dispositivo real puede señalar problemas con los tamaños de los elementos de la interfaz de usuario, capacidad de respuesta, etc.. +* Aunque serÃa agradable poder probar solamente en un dispositivo por plataforma, es mejor poner a prueba en muchos dispositivos deportivos muchas versiones diferentes del sistema operativo. Por ejemplo, lo que funciona en tu smartphone Android particular puede fallar en otro dispositivo Android. Lo que funciona en un dispositivo iOS 7 puede fallar en un dispositivo iOS 6. + +Es, por supuesto, imposible de probar en todos los dispositivos posibles en el mercado. Por este motivo, es aconsejable reclutar muchos probadores que tienen diferentes dispositivos. Aunque no cogerán todos los problemas, más probable es que descubrirán rarezas y temas que nunca encontrarás solo buena. + +Sugerencia: Es posible en dispositivos Android Nexus a flash fácilmente distintas versiones de Android en el dispositivo. Este simple proceso le permitirá probar fácilmente su aplicación en diferentes niveles de Android con un solo dispositivo, sin anular su garantÃa o necesidad para "jailbreak" o "raÃz" de su dispositivo. Las imágenes de fábrica de Google Android y las instrucciones se encuentran en: https://developers.google.com/android/nexus/images#instructions + +# Depurar aplicaciones de Cordova + +Depuración Cordova requiere una configuración. A diferencia de una aplicación de escritorio, no puedes simplemente open dev herramientas del dispositivo móvil y empezar a depurar, por suerte hay algunas grandes alternativas. + +## iOS depuración + +### Xcode + +Con Xcode puede depurar el lado nativo iOS de la aplicación de Córdoba. Asegúrese de que la zona de depuración está mostrando (vista-> área de depuración). Una vez que su aplicación se ejecuta en el dispositivo (o simulador), usted puede ver registro de salida en la zona de depuración. Esto es donde se imprimirán los errores o advertencias. También puede establecer puntos de interrupción en los archivos fuente. Esto le permitirá dar un paso a través de la lÃnea de un código en un momento y ver el estado de las variables en aquel momento. El estado de las variables se muestra en el área de depuración cuando se alcanza un punto de interrupción. Una vez que su aplicación está en marcha en el dispositivo, puede traer a inspector de Safari web (como se describe a continuación) para depurar el lado webview y js de su aplicación. Para más información y ayuda, consulte la guÃa de Xcode: [GuÃa de depuración de Xcode][15] + + [15]: https://developer.apple.com/library/mac/documentation/ToolsLanguages/Conceptual/Xcode_Overview/DebugYourApp/DebugYourApp.html#//apple_ref/doc/uid/TP40010215-CH18-SW1 + +### Safari remoto depuración con Web Inspector + +Con el inspector web de Safari puede depurar el código webview y js en su aplicación de Córdoba. Esto funciona sólo en OSX y sólo con iOS 6 (o superior). Utiliza Safari para conectarse a su dispositivo (o el simulador) y conectará herramientas del revelador del navegador con la aplicación de Córdoba. Obtienes lo que esperas de dev tools - DOM inspección/manipulación, un depurador de JavaScript, inspección de la red, la consola y mucho más. Como Xcode, con inspector de Safari web puede establecer puntos de interrupción en el código JavaScript y ver el estado de las variables en aquel momento. Usted puede ver los errores, advertencias o mensajes que aparecen en la consola. También puede ejecutar comandos JavaScript directamente desde la consola como su aplicación se está ejecutando. Para más detalles sobre cómo ponerlo en marcha y lo que puedes hacer, ver este excelente blog post: <http://moduscreate.com/enable-remote-web-inspector-in-ios-6/> y esta guÃa: [GuÃa de Safari Web Inspector][16] + + [16]: https://developer.apple.com/library/safari/documentation/AppleApplications/Conceptual/Safari_Developer_Guide/Introduction/Introduction.html + +## Depuración remota de cromo + +Prácticamente lo mismo que la versión de Safari, esto sólo funciona con Android pero puede ser utilizada desde cualquier sistema operativo de escritorio. Se requiere un mÃnimo de Android 4.4 (KitKat), mÃnimo nivel de API de 19 y cromo 30 + (en el escritorio). Una vez conectado, obtendrá la misma experiencia de Chrome Dev Tools para sus aplicaciones móviles como haces con tus aplicaciones de escritorio. Mejor aún, el Chrome Dev Tools tener una opción de espejo que muestra su aplicación en el dispositivo móvil. Esto es más que una visión - puede desplazarse y haga clic en herramientas dev y se actualiza en el dispositivo móvil. Más información sobre la depuración remota de cromo puede encontrarse aquÃ: <https://developers.google.com/chrome/mobile/docs/debugging> + +Es posible usar Chrome Dev Tools para inspeccionar las apps iOS, a través de un proxy de WebKit: <https://github.com/google/ios-webkit-debug-proxy/> + +## Ripple + +Ripple es un emulador basado en escritorio para proyectos de Córdoba. Esencialmente le permite ejecutar una aplicación Cordova en su aplicación de escritorio y falsos varias caracterÃsticas de Córdoba. Por ejemplo, le permite simular el acelerómetro para probar el batido de eventos. Simula la cámara API le permite seleccionar una imagen desde tu disco duro. Ondulación le permite que enfocarse más en tu código personalizado en lugar de preocuparse por Cordova plugins. Usted puede encontrar más información acerca de ondulación aquÃ: <http://ripple.incubator.apache.org/> + +## Weinre + +Weinre crea un servidor local que puede albergar a un cliente depuración remota para sus aplicaciones de Córdoba. Después de haber instalado y puso en marcha, copie una lÃnea de código en la aplicación de Cordova y reinÃcielo. Luego puedes abrir un panel de la herramienta dev en tu escritorio para trabajar con la aplicación. Weinre no es bastante tan elegante como cromo y depuración remota de Safari, pero tiene la ventaja de trabajar con una gama más amplia de plataformas y sistemas operativos. Puede encontrar más información aquÃ: <http://people.apache.org/~pmuellr/weinre/docs/latest/> + +## Otras opciones + +* BlackBerry 10 soporta depuración asà como: [documentación][17] +* Puede depurar usando Firefox App Manager asÃ, vea [esta entrada de blog][18] y este [artÃculo MDN][19]. +* Para más ejemplos y explicación de los anteriores consejos de depuración, vea: <http://developer.telerik.com/featured/a-concise-guide-to-remote-debugging-on-ios-android-and-windows-phone/> + + [17]: https://developer.blackberry.com/html5/documentation/v2_0/debugging_using_web_inspector.html + [18]: https://hacks.mozilla.org/2014/02/building-cordova-apps-for-firefox-os/ + [19]: https://developer.mozilla.org/en-US/Apps/Tools_and_frameworks/Cordova_support_for_Firefox_OS#Testing_and_debugging + +# Interfaz de usuario + +Creación de una aplicación de Córdoba que queda bien móvil puede ser un desafÃo, especialmente para los desarrolladores. Mucha gente optó por usar un marco de interfaz de usuario para hacerlo más fácil. Aquà está una lista corta de las opciones que usted puede desear considerar. + +* [jQuery Mobile][9] - jQuery Mobile automáticamente realza su diseño para la optimización del móvil. También maneja creando un SPA para usted automáticamente. +* [iónico][20] -este potente entorno de interfaz de usuario en realidad tiene su propio CLI para manejar la creación del proyecto. +* [Trinquete][21] - traÃdo a usted por la gente que creó Bootstrap. +* [Kendo UI][5] - interfaz de usuario de código abierto y marco de aplicación de Telerik. +* [TOPCOAT][22] +* [ReactJS][7] + + [20]: http://ionicframework.com/ + [21]: http://goratchet.com/ + [22]: http://topcoat.io + +Al construir la interfaz de usuario, es importante pensar en todas las plataformas que está atacando y las diferencias entre las expectativas del usuario. Por ejemplo, una aplicación para Android que tiene una interfaz de usuario estilo iOS probablemente no va bien con los usuarios. Esto a veces es incluso aplicada por las diferentes tiendas de aplicaciones. Debido a esto, es importante que respeten las convenciones de cada plataforma y por lo tanto están familiarizados con las diversas directrices de interfaz humana: + +* [iOS][23] +* [Android][24] +* [Windows Phone][25] + + [23]: https://developer.apple.com/library/ios/documentation/userexperience/conceptual/MobileHIG/index.html + [24]: https://developer.android.com/designWP8 + [25]: http://dev.windowsphone.com/en-us/design/library + +## Recursos y artÃculos adicionales UI + +Aunque los motores navegador convertido en queja estándares cada vez más, vivimos en un mundo con prefijo (-webkit y - la Sra.) el siguiente artÃculo es valioso en el desarrollo de interfaz de usuario en cruz aplicaciones del navegador: <http://blogs.windows.com/windows_phone/b/wpdev/archive/2012/11/15/adapting-your-webkit-optimized-site-for-internet-explorer-10.aspx> + +# Consideraciones especiales + +Aunque Cordova facilita el desarrollo multiplataforma, no es posible proporcionar aislamiento 100% desde la plataforma nativo subyacente. Para ser conscientes de las restricciones. + +## Plataforma rarezas + +Al leer la documentación, busque las secciones que describen diferentes comportamientos o requisitos en múltiples plataformas. Si está presente, estos serÃan en una sección titulada "Rarezas Android", "iOS rarezas", etc.. Lea detenidamente estas rarezas y ser conscientes de ellas mientras trabajas con Córdoba. + +## Cargando contenido remoto + +Invocar funciones Cordova JavaScript desde una página HTML cargados remotamente (una página HTML no almacenada localmente en el dispositivo) es una configuración no admitida. Esto es porque Córdoba no fue diseñado para esto, y la comunidad Apache Cordova no hace ninguna prueba de esta configuración. Mientras que puede funcionar en algunas circunstancias, no es recomendable ni apoyado. Hay problemas con la polÃtica del mismo origen, manteniendo el JavaScript y las porciones nativas de Córdoba sincronización en la misma versión (puesto que están acoplados mediante APIs privadas que pueden cambiar), la confiabilidad del contenido remoto llamar a funciones nativas locales y potencial rechazo de app store. + +La visualización de contenido HTML cargados remotamente en un webview debe hacerse usando InAppBrowser de Cordova. El InAppBrowser está diseñado para que JavaScript corriendo allá no tienen acceso a las APIs de JavaScript Cordova por las razones mencionadas anteriormente. Por favor consulte la guÃa de seguridad. + +# Mantenerse al dÃa + +Aquà están algunas maneras de mantenerse al dÃa con Córdoba. + +* Suscribirse al [blog de Córdoba][26]. +* Suscribirse a la [lista de desarrolladores][27]. Nota: no se trata de un grupo de apoyo! Más bien se trata de un lugar donde se discute el desarrollo de Córdoba. + + [26]: http://cordova.apache.org/#news + [27]: http://cordova.apache.org/#mailing-list + +# Cómo obtener ayuda + +Los siguientes enlaces son los mejores lugares para conseguir ayuda para Córdoba: + +* StackOverflow: <http://stackoverflow.com/questions/tagged/cordova> mediante el uso de la etiqueta de Cordova, puede ver y examinar todas las cuestiones de Córdoba. Tenga en cuenta que StackOverflow convierte automáticamente la etiqueta de "Phonegap" a "Córdoba", para que de esta manera usted podrá acceder a preguntas históricas, asà +* Grupo de Google de PhoneGap: [https://groups.google.com/forum/#! forum/phonegap][28] este grupo de Google fue el antiguo Foro de soporte cuando todavÃa se llamaba PhoneGap Cordova. Mientras que todavÃa hay muchos usuarios de Córdoba que frecuente este grupo, la comunidad de Córdoba ha expresado su interés en centrarse menos en este grupo y en su lugar utilizando StackOverflow para apoyo +* Quedada: <http://phonegap.meetup.com> - considere encontrar un grupo local de la quedada de PhoneGap/Cordova + + [28]: https://groups.google.com/forum/#!forum/phonegap \ No newline at end of file
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/21c8e8f0/www/docs/es/6.x/guide/overview/index.md ---------------------------------------------------------------------- diff --git a/www/docs/es/6.x/guide/overview/index.md b/www/docs/es/6.x/guide/overview/index.md new file mode 100644 index 0000000..272bd3b --- /dev/null +++ b/www/docs/es/6.x/guide/overview/index.md @@ -0,0 +1,77 @@ +--- +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: Resumen +--- + +# Resumen + +Apache 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. + +Apache Cordova se graduó en octubre de 2012 como un proyecto de nivel superior dentro de la Apache Software Foundation (ASF). A través del ASF, futuro desarrollo Cordova asegurará administración abierta del proyecto. Siempre permanecerá libre y de código abierto bajo la licencia Apache, versión 2.0. Visite [cordova.apache.org][1] para obtener más información. + + [1]: http://cordova.apache.org + +Usar Apache 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 reimplementarlo con herramienta y lenguaje 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 un *WebView* (ventana del navegador especial) 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 + +Apache 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][2], *widget*, o de la W3C. + + [2]: http://www.w3.org/TR/widgets/ + +La misma aplicación se implementa como una página web, un archivo local llamado *index.html*, que hace referencia a cualquier CSS, JavaScript, imágenes, archivos multimedia u otros recursos son necesarios para que se ejecute de forma predeterminada. La aplicación se ejecuta como un *WebView* dentro de la envoltura de la aplicación nativa, que distribuye a tiendas de aplicaciones. + +El WebView Cordova-habilitado puede proporcionar la aplicación con su interfaz de usuario completa. En algunas plataformas, también puede ser un componente dentro de una aplicación hÃbrida más grande, que mezcla la vista Web con componentes de la aplicación nativa. (Véase WebViews incrustación para más detalles). + +Una interfaz *plugin* está disponible para Cordova y componentes nativos para comunicarse con los demás. Esto te permite invocar un código de JavaScript. Idealmente, las API de JavaScript para ese código nativo son consistentes a través de múltiples plataformas de dispositivos. A partir de la versión 3.0, las extensiones proporcionan enlaces a APIs estándar. Plugins de terceros proporcionan enlaces adicionales a funciones no necesariamente disponibles en todas las plataformas. Puede encontrar estos plugins de terceros en el [registro de plugin][3] y utilizarlos en su aplicación. También puedes desarrollar tus propios plugins, como se describe en la guÃa de desarrollo de Plugin. Plugins puede ser necesario, por ejemplo, para comunicarse entre Córdoba y componentes personalizados de nativos. + + [3]: http://plugins.cordova.io + +**Nota**: desde 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. + +Córdova no proporciona ninguna widgets UI o MV * Marcos. Cordova proporciona solamente el tiempo de ejecución en el cual los pueden ejecutar. Si usted desea utilizar widgets UI o un marco MV *, usted necesitará seleccionar aquellos e incluirlos en su solicitud usted mismo como material de terceros. + +## VÃas de desarrollo + +A partir de la versión 3.0, puede utilizar dos flujos de trabajo básicos para crear una aplicación móvil. Mientras que a menudo puede utilizar cualquier flujo de trabajo para realizar la misma tarea, cada uno de ellos ofrece ventajas: + +* **Flujo de trabajo multiplataforma (CLI)**: Use este flujo de trabajo si quieres tu aplicación para ejecutar en los sistemas operativos móviles como sea posible, con poco necesidad especÃfica de la plataforma desarrollo. Este flujo de trabajo se centra en la `cordova` utilidad, también conocido como el *CLI*, que fue introducido con 3.0 Cordova Cordova. El CLI es una herramienta de alto nivel que le permite construir proyectos para muchas plataformas a la vez, muy lejos de la funcionalidad de scripts de shell de bajo nivel de abstracción. La CLI copia un conjunto común de web activos en subdirectorios para cada plataforma móvil, hace que cualquier cambio de configuración necesarias para cada uno, construir secuencias de comandos para generar los binarios de la aplicación ejecuta. La CLI también proporciona una interfaz común para aplicar plugins para su aplicación. Para más detalles sobre el CLI, vea la interfaz de lÃnea de comandos. A menos que usted tiene una nec esidad para el flujo de trabajo centrado en plataforma, se recomienda el flujo de trabajo multiplataforma. + +* **Flujo de trabajo centrado en plataforma**: Utilice este flujo de trabajo si desea concentrarse en construir una aplicación para una sola plataforma y necesitan poder modificarlo en un nivel inferior. Tienes que utilizar este enfoque, por ejemplo, si quieres tu aplicación para mezclar los componentes nativos personalizados con componentes Cordova basados en web, como se explica en WebViews incrustación. Como regla general, utilice este flujo de trabajo si necesitas modificar el proyecto dentro del SDK. Este flujo de trabajo se basa en un conjunto de scripts de shell de nivel inferior que se adaptan para cada plataforma soportada y una utilidad de Plugman separada que le permite aplicar plugins. Mientras este flujo de trabajo puede utilizar para crear aplicaciones multiplataforma, es generalmente más difÃcil porque la falta de una herramienta de alto nivel significa construir diferentes ciclos y modificaciones de plugin para cada plataforma. Aún asÃ, este flujo de trabajo permite un mayor acceso a opciones de desarrollo proporcionadas por cada SDK y es esencial para aplicaciones complejas hÃbrido. Vea a las diversas guÃas de plataforma para obtener más información sobre utilidades de shell disponible de cada plataforma. + +Cuando primero comenzando, puede ser más fácil utilizar el flujo de trabajo multiplataforma para crear una aplicación, como se describe en la interfaz de lÃnea de comandos. Entonces tienes la opción de cambiar a un flujo de trabajo centrado en plataforma si necesitas el SDK proporciona un mayor control. Utilidades de shell de nivel inferior están disponibles en [cordova.apache.org][1] en una distribución independiente de la CLI. Para los proyectos generados inicialmente por la CLI, estas herramientas de shell también están disponibles en el proyecto de varios `platforms/*/cordova` directorios. + +**Nota**: una vez que se cambia de los flujos de trabajo basados en CLI a uno centrado en la especÃfica de la plataforma SDK y herramientas de shell, no puedes volver. La CLI mantiene un conjunto común de código fuente multiplataforma, que en cada uno a construir aplicaciones para escribir código fuente especÃfica de la plataforma. Para conservar las modificaciones en los activos especÃficos a una plataforma, puede necesita cambiar las herramientas de plataforma centrada en la cáscara, que ignoran el código multiplataforma, y en cambio se basa en el código fuente especÃfica de la plataforma. + +## Instalación de Cordova + +La instalación de Córdoba será diferente dependiendo del flujo de trabajo anterior que usted elige: + +* Flujo de trabajo multiplataforma: ver la interfaz de lÃnea de comandos. + +* Flujo de trabajo centrado en plataforma: ver las guias de la plataforma. + +Después de instalar Cordova, se recomienda que consulte a las guÃas de plataforma para las plataformas móviles que va a desarrollar para. También se recomienda que también revise la guÃa de privacidad, seguridad y próximos pasos. Para configurar Cordova, consulte el archivo config.xml. Para acceder a la función nativa en un dispositivo de JavaScript, se refieren a las APIs de Plugin. Y se refieren a las otras guÃas incluidas según sea necesario. \ No newline at end of file http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/21c8e8f0/www/docs/es/6.x/guide/platforms/amazonfireos/config.md ---------------------------------------------------------------------- diff --git a/www/docs/es/6.x/guide/platforms/amazonfireos/config.md b/www/docs/es/6.x/guide/platforms/amazonfireos/config.md new file mode 100644 index 0000000..04ebad4 --- /dev/null +++ b/www/docs/es/6.x/guide/platforms/amazonfireos/config.md @@ -0,0 +1,71 @@ +--- +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: Amazon fuego OS configuración +--- + +# Amazon fuego OS configuración + +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. Este preferencias detalles sección que sólo se aplican a Amazon fuego OS construye. Consulte [el archivo config.xml][1] para obtener información sobre las opciones de configuración global. + + [1]: config_ref_index.md.html#The%20config.xml%20File + +* `KeepRunning` (por defecto valor booleano, `true`): determina si la aplicación queda funcionando en segundo plano, incluso después de un `[pause](../../../cordova/events/events.pause.html)` de evento se desencadena. Si se establece como `false` no mata la aplicación después de un `[pause](../../../cordova/events/events.pause.html)` evento, sino simplemente detiene ejecución de código en la vista Web cordova mientras la aplicación está en el fondo. + + <preference name="KeepRunning" value="false"/> + + +* `ErrorUrl`(URL, por defecto `null` ): Si establece, se visualizará la página que se hace referencia a un error en la aplicación en lugar de un diálogo con el tÃtulo "Error de aplicación". + + <preference name="ErrorUrl" value="error.html"/> + + +* `LoadingDialog`(string, el valor predeterminado de `null` ): Si conjunto, muestra un diálogo con el mensaje y tÃtulo especificado y un hilandero, cuando cargue la primera página de una aplicación. El tÃtulo y el mensaje están separados por una coma en esta cadena de valor, y eso coma se retira antes de que se muestre el cuadro de diálogo. + + <preference name="LoadingDialog" value="Please wait, the app is loading"/> + + +* `LoadingPageDialog`(string, el valor predeterminado de `null` ): lo mismo que `LoadingDialog` , pero para cargar cada página después de la primera página de la aplicación. + + <preference name="LoadingPageDialog" value="Please wait, the data is loading"/> + + +* `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: + + <preference name="LoadUrlTimeoutValue" value="10000"/> + + +* `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. + + <preference name="SplashScreen" value="splash"/> + + +* `SplashScreenDelay` (número, el valor predeterminado de `5000`): la cantidad de tiempo que muestra la imagen en pantalla splash. + + <preference name="SplashScreenDelay" value="10000"/> + + +* `ShowTitle`(por defecto es booleano, `false` ): Mostrar el tÃtulo en la parte superior de la pantalla. + + <preference name="ShowTitle" value="true"/> + + +* `LogLevel`(string, el valor predeterminado de `ERROR` ): establece el nivel de registro mÃnimo a través de registro que se filtrarán los mensajes de la aplicación. Los valores válidos son `ERROR` , `WARN` , `INFO` , `DEBUG` , y`VERBOSE`. + + <preference name="LogLevel" value="VERBOSE"/> \ No newline at end of file http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/21c8e8f0/www/docs/es/6.x/guide/platforms/amazonfireos/index.md ---------------------------------------------------------------------- diff --git a/www/docs/es/6.x/guide/platforms/amazonfireos/index.md b/www/docs/es/6.x/guide/platforms/amazonfireos/index.md new file mode 100644 index 0000000..737883b --- /dev/null +++ b/www/docs/es/6.x/guide/platforms/amazonfireos/index.md @@ -0,0 +1,192 @@ +--- +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: Amazon fuego OS Platform Guide +--- + +# Amazon fuego OS Platform Guide + +Esta guÃa le muestra cómo configurar el entorno de desarrollo SDK para desplegar aplicaciones Cordova para dispositivos como el Kindle fuego HDX Amazon fuego OS. + +Vea el siguiente para obtener más información especÃfica de la plataforma: + +* [Amazon fuego OS configuración](config.html) +* [Amazon fuego OS WebViews](webview.html) +* [Amazon fuego OS Plugins](plugin.html) + +## Introducción + +Al dirigirse a la plataforma Amazon fuego OS, Cordova los desarrolladores pueden crear aplicaciones web hÃbridas que aprovechan el motor web avanzada integrado en los dispositivos Kindle Fire. Amazon WebView API (AWV) es un tiempo de ejecución derivados del cromo web exclusivo de fuego OS. Un reemplazo de sobreponer para la vista Web que viene con dispositivos Android, AWV hace posible crear realizar mejor y más poderoso hÃbrido web apps proporcionando apoyo para un rápido motor JavaScript (V8), depuración remota y optimizaciones de hardware para los dispositivos Kindle Fire incluyendo un lienzo 2D acelerado, y acceso a caracterÃsticas de HTML5 no soportado por Android construido en WebView tales como: Calc CSS, validación de formularios, getUserMedia, IndexedDB, los trabajadores Web, WebSockets y WebGL. + +Para obtener más información acerca de la AmazonÃa WebView API, consulte del Portal Amazon desarrollador [aplicaciones hÃbridas HTML5 página][1]. Para preguntas sobre comenzó y otros problemas de soporte, consulte el Amazonas Developer Portal [foros - aplicaciones hÃbridas HTML5][2]. + + [1]: https://developer.amazon.com/public/solutions/platforms/android-fireos/docs/building-and-testing-your-hybrid-app + [2]: http://forums.developer.amazon.com/forums/category.jspa?categoryID=41 + +## Requisitos y apoyo + +Desarrollando aplicaciones Cordova para Amazon fuego OS requiere la instalación de una variedad de archivos de apoyo, incluyendo todo lo necesario para el desarrollo de Android, asà como el Amazonas WebView SDK. Compruebe la lista de abajo para las instalaciones necesarias: + +* [La interfaz de linea de comandos](../../cli/index.html) +* [SDK de Android][3] +* [Apache Ant][4] +* [Amazon WebView SDK][1] + + [3]: http://developer.android.com/sdk/ + [4]: http://ant.apache.org + +## Instalación + +### El SDK de Android y Apache Ant + +Instalar el SDK de Android desde [developer.android.com/sdk][3]. Puede presentarse con una elección de donde instalar el SDK, de lo contrario mover el árbol descargado `adt-bundle` a dondequiera que usted almacenar herramientas de desarrollo. + +Usted necesitará ejecutar el administrador de Android SDK ( `android` de lÃnea de comandos) al menos una vez antes de comenzar su proyecto Cordova. Asegúrese de instalar la versión más reciente del Android SDK Tools y plataforma SDK **especÃficamente nivel API 19**. Consulte [configurar el entorno de desarrollo][5] de la AmazonÃa Developer Portal para obtener más información sobre cómo configurar su entorno de desarrollo para dispositivos Kindle fuego OS. + + [5]: https://developer.amazon.com/public/resources/development-tools/ide-tools/tech-docs/01-setting-up-your-development-environment + +Instalar el Apache Ant construir herramienta de [descarga una distribución binaria de hormiga][6], descomprimir en un directorio que puede consultar posteriormente. Consulte el [manual de hormiga][7] para obtener más información. + + [6]: http://ant.apache.org/bindownload.cgi + [7]: http://ant.apache.org/manual/index.html + +Cordova Herramientas de lÃnea de comandos trabajar, es necesario incluir el SDK de Android `tools` , `platform-tools` y `apache-ant/bin` directorios en su entorno PATH. + +#### Ruta de Mac/Linux + +En Mac, Linux u otras plataformas Unix-like, 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 están instalados los SDK y la hormiga: + + export PATH = ${PATH}: / / adt-bundle/sdk/plataforma-herramientas de desarrollo: / / adt-bundle/sdk/herramientas de desarrollo: / desarrollo/apache-ant/bin + + +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 + + +#### Windows Path + +Para modificar el entorno PATH en Windows: + +* Haga clic en el menú de **Start** en la esquina inferior izquierda del escritorio, haga clic derecho en el **Computer**, haga clic en **Properties**. + +* En la columna de la izquierda, haga clic en **Configuración avanzada del sistema**. + +* En el cuadro de diálogo resultante, presione **Environment Variables**. + +* Seleccione la variable **PATH** y pulse **Editar**. + +* Agregue lo siguiente a la ruta basada en donde se ha instalado el SDK de la hormiga, por ejemplo: + + ;C:\Development\adt-bundle\sdk\platform-tools;C:\Development\adt-bundle\sdk\tools;C:\Development\apache-ant\bin + + +* El valor de guardar y cerrar ambos cuadros de diálogo. + +* Usted también necesitará habilitar Java. Abra un sÃmbolo del sistema y el tipo `java` , si no funciona, anexar su camino asà como la ubicación de los binarios de Java. Asegúrese de que JAVA_HOME % apunta al directorio JDK instalado. Tendrás que agregar separadamente variable de entorno JAVA_HOME. + + ; %JAVA_HOME%\bin + + +### Amazon WebView SDK + +Para crear aplicaciones de Córdoba con el objetivo de la plataforma de Amazon fuego OS, usted necesitará descargar, descomprimir e instalar los archivos de soporte de Amazon WebView SDK. Este paso sólo tendrá que ser hecho por tu primer proyecto Amazonas fuego OS. + +* Descargue el SDK de WebView Amazonas del [Amazonas Developer Portal][1]. + +* Copia `awv_interface.jar` del SDK descargado al directorio de trabajo de Cordova. Crear carpeta commonlibs(shown below) si no existe: + + **Mac/Linux:** `~/.cordova/lib/commonlibs/` + + **Windows:** `%USERPROFILE%\.cordova\lib\commonlibs` + +## Crear nuevo proyecto para el Amazonas fuego OS + +Uso el `cordova` utilidad para configurar un nuevo proyecto, como se describe en el Córdoba la comando-lÃnea interfaz. Por ejemplo, en un directorio de código fuente: + + $ cordova create hello com.example.hello "HelloWorld" + $ cd hello + $ cordova platform add amazon-fireos + $ cordova build + + +***Nota:*** La primera vez que la plataforma amazon-fireos está instalada en su sistema, se descargará los archivos correspondientes en el directorio de trabajo de Córdoba, pero entonces fracasará como le faltan los archivos de soporte AWV SDK (véase arriba). Siga las instrucciones anteriores para instalar el `awv_interface.jar` , luego quitar y volver a agregar la plataforma amazon-fireos a su proyecto. Este paso sólo tendrá que hacerse para primer proyecto Amazonas fuego OS. + +## 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][8]y utilice un cable mini-USB para conectarlo a su sistema. + + [8]: http://developer.android.com/tools/device.html + +Usted puede empujar la aplicación para el dispositivo de la lÃnea de comandos: + + $ cordova ejecutar Amazonas-fireos + + +Alternativamente dentro de Eclipse, haga clic derecho en el proyecto y elija **Run As â Android Application**. + +**Nota**: Actualmente, la prueba mediante un emulador no es compatible para Amazon WebView basados en aplicaciones, además la API WebView Amazon sólo está disponible en dispositivos fuego OS. Para obtener más información, consulte la documentación de [Amazon WebView API SDK][1] . + +### Ejecutar las banderas + +Ejecutar el comando acepta parámetros opcionales como se especifica en el documento de Cordova Command Line Interface, fuego OS también acepta un adicional `--debug` bandera que permitirá herramientas para desarrolladores de cromo para la depuración de web remoto. + +Para utilizar las herramientas para desarrolladores, escriba: + + $ cordova run --debug amazon-fireos + + +Esto permitirá a las herramientas en el cliente ejecutando. Entonces puede conectar al cliente por el reenvÃo de puertos mediante el Android Debug Bridge (adb) refiriéndose al nombre del paquete de la aplicación. + +Por ejemplo: + + ADB tcp:9222 delantero localabstract:com.example.helloworld.devtools + + +Puede utilizar el DevTools mediante un navegador basado en Chromium desplazándose a:`http://localhost:9222`. + +### Soporte opcional de Eclipse + +Una vez creado, puede utilizar el Eclipse que viene con el SDK de Android para modificar el proyecto. Tenga cuidado que las modificaciones efectuadas a través de Eclipse se sobrescribirán si continúa utilizando herramientas de lÃnea de comandos de Córdoba. + +* 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**: ![][9] + +* Vaya a `hello` , o cualquier directorio que creó para el proyecto, luego en el `platforms/amazon-fireos` subdirectorio. + +* Eclipse le mostrará el Hola y Hola-CorddovaLib - 2 proyectos a agregarse. Añadir ambos. + +* Pulse **Finish**. + + [9]: {{ site.baseurl }}/static/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 **Properties** resultante, seleccione **Android** desde el panel de navegación. + +* Para el objetivo de construir proyecto, seleccione el nivel más alto de Android API (actualmente API nivel 19) instalado. + +* Haga clic en **OK**. + +* Seleccione **Clean** en el menú **Project**. Esto deberÃa corregir todos los errores en el proyecto. http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/21c8e8f0/www/docs/es/6.x/guide/platforms/amazonfireos/plugin.md ---------------------------------------------------------------------- diff --git a/www/docs/es/6.x/guide/platforms/amazonfireos/plugin.md b/www/docs/es/6.x/guide/platforms/amazonfireos/plugin.md new file mode 100644 index 0000000..616abed --- /dev/null +++ b/www/docs/es/6.x/guide/platforms/amazonfireos/plugin.md @@ -0,0 +1,106 @@ +--- +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: Amazon fuego OS Plugins +--- + +# Amazon fuego OS Plugins + +Siga las instrucciones proporcionadas en la guÃa de Plugins de Android para tener una visión general de desarrollo de plugins personalizados. + +## Ejemplo de Plugin de fuego OS echo Amazon + +Para hacer coincidir la función de *Eco* de la interfaz JavaScript descrita en Plugins de aplicación, utilice el `plugin.xml` para inyectar un `feature` Especificación de la plataforma local `config.xml` archivo: + + <platform name="amazon-fireos"> + <config-file target="config.xml" parent="/*"> + <feature name="Echo"> + <param name="android-package" value="org.apache.cordova.plugin.Echo"/> + </feature> + </config-file> + </platform> + + +Luego agregar lo siguiente a la `src/org/apache/cordova/plugin/Echo.java` archivo: + + 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."); + } + } + } + + +Si quieres reutilizar código Android Plugin para la plataforma de Amazon fuego OS entonces modificar el plugin.xml para señalar el `android` archivo fuente especÃfica. Por ejemplo, + + <platform name="amazon-fireos"> + <config-file target="config.xml" parent="/*"> + <feature name="Echo"> + <param name="android-package" value="org.apache.cordova.plugin.Echo"/> + </feature> + </config-file> + <source-file src="src/android/Echo.java" target-dir="src/org/apache/cordova/plugin" /> + </platform> + + +Si desea escribir un plugin modificado para requisitos particulares para la plataforma Amazon fuego OS creará una carpeta llamada `amazon` bajo tu plugin src / carpeta y modificar el plugin.xml para señalar el `amazon` archivo fuente especÃfica. Por ejemplo, + + <platform name="amazon-fireos"> + <config-file target="config.xml" parent="/*"> + <feature name="Echo"> + <param name="android-package" value="org.apache.cordova.plugin.Echo"/> + </feature> + </config-file> + <source-file src="src/amazon/Echo.java" target-dir="src/org/apache/cordova/plugin" /> + </platform> + + +## Usando Amazon WebView en tu plugin + +Cordova para Amazon fuego OS hace uso de personalizado WebView de Amazon que está construido sobre el proyecto de código abierto de cromo. Es GPU acelerada y optimizado para funcionamiento fluido en Kindle Fire. + +Para entender cómo utilizar mejor Amazon WebView en su proyecto, revisa el [Amazonas Developer Portal][1]. + + [1]: https://developer.amazon.com/sdk/fire/IntegratingAWV.html \ No newline at end of file http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/21c8e8f0/www/docs/es/6.x/guide/platforms/amazonfireos/webview.md ---------------------------------------------------------------------- diff --git a/www/docs/es/6.x/guide/platforms/amazonfireos/webview.md b/www/docs/es/6.x/guide/platforms/amazonfireos/webview.md new file mode 100644 index 0000000..7754021 --- /dev/null +++ b/www/docs/es/6.x/guide/platforms/amazonfireos/webview.md @@ -0,0 +1,129 @@ +--- +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: Amazon fuego OS WebViews +--- + +# Amazon fuego OS WebViews + +Comenzando con 3.3.0, puede utilizar Cordova como componente de aplicaciones de Amazon fuego OS. Amazon fuego OS hace referencia a este componente como `CordovaWebView` . `CordovaWebView`se extiende WebView de Amazon que se construye en el cromo proyecto de código abierto. Aprovechando esta caracterÃstica, sus aplicaciones web pueden utilizar los últimos estándares web HTML5 en un motor de tiempo de ejecución web moderno. + +Si no está familiarizado con Amazon fuego OS, primero debe familiarizarse con la AmazonÃa fuego OS Platform Guide y tener instalado los últimos SDK antes de intentar la opción de desarrollo más inusual de incrustar un WebView. + +## Pre-requisitos + +* Cordova 3.3.0 o mayor + +* SDK de Android actualizado al último SDK + +* Amazon WebView SDK + +## GuÃa de uso de CordovaWebView en un proyecto Amazonas fuego OS + +1. Para seguir estas instrucciones, asegúrate de que tienes la última distribución de Córdoba. Descargar desde [cordova.apache.org][1] y descomprime su paquete de Amazon fuego OS. + +2. Descargar y expandir el [Amazonas WebView SDK][2] , luego copiar el awv_interface.jar en `/framework/libs` Directorio. Crear un libs / carpeta si no existe. + +3. Desplácese hasta el paquete `/framework` Directorio y ejecute `ant jar` . Crea el Cordova `.jar` archivo, formado como`/framework/cordova-x.x.x.jar`. + +4. Copia el `.jar` archivo del proyecto Android `/libs` Directorio. + +5. Agregar lo siguiente a la aplicación `/res/xml/main.xml` archivo, con el `layout_height` , `layout_width` y `id` modificado para adaptarse al uso: + + <org.apache.cordova.CordovaWebView + android:id="@+id/tutorialView" + android:layout_width="match_parent" + android:layout_height="match_parent" /> + + +6. Modificar su actividad para que implementa la `CordovaInterface`. Debe implementar los métodos incluidos. Puede que desee copiar desde `/framework/src/org/apache/cordova/CordovaActivity.java` , o implementarlas en tu propio. El fragmento de código siguiente muestra una aplicación básica que utiliza la interfaz. Observe cómo el id de referencia vista coincide con el atributo `id` especificado en el fragmento XML que se muestra arriba: + + public class CordovaViewTestActivity extends Activity implements CordovaInterface { + CordovaWebView cwv; + /* Called when the activity is first created. */ + @Override + public void onCreate(Bundle savedInstanceState) { + super.onCreate(savedInstanceState); + setContentView(R.layout.main); + cwv = (CordovaWebView) findViewById(R.id.tutorialView); + Config.init(this); + cwv.loadUrl(Config.getStartUrl()); + } + + + [1]: http://cordova.apache.org + [2]: https://developer.amazon.com/sdk/fire/IntegratingAWV.html#installawv + +Si se utiliza la cámara, también debe implementar esto: + + @Override + public void setActivityResultCallback(CordovaPlugin plugin) { + this.activityResultCallback = plugin; + } + /** + * Launch an activity for which you would like a result when it finished. When this activity exits, + * your onActivityResult() method is called. + * + * @param command The command object + * @param intent The intent to start + * @param requestCode The request code that is passed to callback to identify the activity + */ + public void startActivityForResult(CordovaPlugin command, Intent intent, int requestCode) { + this.activityResultCallback = command; + this.activityResultKeepRunning = this.keepRunning; + + // If multitasking turned on, then disable it for activities that return results + if (command != null) { + this.keepRunning = false; + } + + // Start activity + super.startActivityForResult(intent, requestCode); + } + + @Override + /** + * Called when an activity you launched exits, giving you the requestCode you started it with, + * the resultCode it returned, and any additional data from it. + * + * @param requestCode The request code originally supplied to startActivityForResult(), + * allowing you to identify who this result came from. + * @param resultCode The integer result code returned by the child activity through its setResult(). + * @param data An Intent, which can return result data to the caller (various data can be attached to Intent "extras"). + */ + protected void onActivityResult(int requestCode, int resultCode, Intent intent) { + super.onActivityResult(requestCode, resultCode, intent); + CordovaPlugin callback = this.activityResultCallback; + if (callback != null) { + callback.onActivityResult(requestCode, resultCode, intent); + } + } + + +Finalmente, no olvide añadir el grupo de subprocesos, de lo contrario los plugins no tienen hilos para correr en: + + @Override + public ExecutorService getThreadPool() { + return threadPool; + } + + +1. Copia archivos HTML y JavaScript de la aplicación de su proyecto Amazonas fuego OS `/assets/www` Directorio. + +2. Copia `config.xml` de `/framework/res/xml` a de su proyecto `/res/xml` Directorio. \ No newline at end of file http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/21c8e8f0/www/docs/es/6.x/guide/platforms/android/config.md ---------------------------------------------------------------------- diff --git a/www/docs/es/6.x/guide/platforms/android/config.md b/www/docs/es/6.x/guide/platforms/android/config.md new file mode 100644 index 0000000..a070a5d --- /dev/null +++ b/www/docs/es/6.x/guide/platforms/android/config.md @@ -0,0 +1,95 @@ +--- +license: > + Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +title: Configuración de Android +--- + +# 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. Consulte [el archivo config.xml][1] para obtener información sobre las opciones de configuración global. + + [1]: config_ref_index.md.html#The%20config.xml%20File + +* `KeepRunning` (por defecto valor booleano, `true`): determina si la aplicación queda funcionando en segundo plano, incluso después de un `[pause](../../../cordova/events/events.pause.html)` de evento se desencadena. Si se establece como `false` no mata la aplicación después de un `[pause](../../../cordova/events/events.pause.html)` evento, sino simplemente detiene ejecución de código en la vista Web cordova mientras la aplicación está en el fondo. + + <preference name="KeepRunning" value="false"/> + + +* `LoadUrlTimeoutValue`(número en milisegundos, por defecto `20000` , 20 segundos): 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: + + <preference name="LoadUrlTimeoutValue" value="10000"/> + + +* `SplashScreen`(string, el valor predeterminado de `splash` ): el nombre del archivo sin su extensión en el `res/drawable` Directorio. Varios activos deben compartir este nombre común en diferentes subdirectorios. + + <preference name="SplashScreen" value="mySplash"/> + + +* `SplashScreenDelay`(número en milisegundos, por defecto `3000` ): la cantidad de tiempo que muestra la imagen en pantalla splash. + + <preference name="SplashScreenDelay" value="10000"/> + + +* `InAppBrowserStorageEnabled`(por defecto es booleano, `true` ): controles si abrieron páginas dentro de un InAppBrowser pueden acceder el mismo [localStorage](../../../cordova/storage/localstorage/localstorage.html) y WebSQL almacenamiento de información como páginas abrió con el navegador por defecto. + + <preference name="InAppBrowserStorageEnabled" value="true"/> + + +* `LoadingDialog`(string, el valor predeterminado de `null` ): Si conjunto, muestra un diálogo con el mensaje y tÃtulo especificado y un hilandero, cuando cargue la primera página de una aplicación. El tÃtulo y el mensaje están separados por una coma en esta cadena de valor, y eso coma se retira antes de que se muestre el cuadro de diálogo. + + <preference name="LoadingDialog" value="My Title,My Message"/> + + +* `LoadingPageDialog`(string, el valor predeterminado de `null` ): lo mismo que `LoadingDialog` , pero para cargar cada página después de la primera página de la aplicación. + + <preference name="LoadingPageDialog" value="My Title,My Message"/> + + +* `ErrorUrl`(URL, por defecto `null` ): Si establece, se visualizará la página que se hace referencia a un error en la aplicación en lugar de un diálogo con el tÃtulo "Error de aplicación". + + <preference name="ErrorUrl" value="myErrorPage.html"/> + + +* `ShowTitle`(por defecto es booleano, `false` ): Mostrar el tÃtulo en la parte superior de la pantalla. + + <preference name="ShowTitle" value="true"/> + + +* `LogLevel`(string, el valor predeterminado de `ERROR` ): establece el nivel de registro mÃnimo a través de registro que se filtrarán los mensajes de la aplicación. Los valores válidos son `ERROR` , `WARN` , `INFO` , `DEBUG` , y`VERBOSE`. + + <preference name="LogLevel" value="VERBOSE"/> + + +* `SetFullscreen`(por defecto es booleano, `false` ): igual que el `Fullscreen` parámetro en la configuración global de este archivo xml. Este elemento especÃfico de Android está obsoleta a favor de la global `Fullscreen` elemento y se quitará en una versión futura. + +* `AndroidLaunchMode`(string, el valor predeterminado de `singleTop` ): establece la actividad `android:launchMode` atributo. Esto cambia lo que pasa cuando la aplicación se inicia desde el icono de la aplicación o intención y está ya en ejecución. Los valores válidos son `standard` , `singleTop` , `singleTask` ,`singleInstance`. + + <preference name="AndroidLaunchMode" value="singleTop"/> + + +* `DefaultVolumeStream`(string, el valor predeterminado de `default` , agregado en Córdoba-android 3.7.0): establece que volumen el volumen de hardware vinculan los botones. Por defecto es "llamar" por "medios" para tablets y teléfonos. Ajuste este parámetro a "medios" para los botones de volumen de su aplicación siempre cambiar el volumen de los medios de comunicación. Tenga en cuenta que al usar el plugin de los medios de comunicación de Cordova, los botones de volumen cambiará dinámicamente para controlar el volumen de los medios de comunicación cuando los objetos a los medios de comunicación están activos. + +* `OverrideUserAgent` (string, no establece de forma predeterminada): si se establece, el valor reemplazará el viejo UserAgent de webview. Es útil identificar la petición del navegador de la aplicación cuando solicita páginas remotas. Uso con precaución, esto puede causa compitiable problema con servidores web. Para la mayorÃa de los casos, utilice AppendUserAgent. + + <preference name="OverrideUserAgent" value="Mozilla/5.0 My Browser" /> + + +* `AppendUserAgent` (string, no establece de forma predeterminada): Si establece, el valor agregará al final del viejo UserAgent de webview. Cuando se utiliza con OverrideUserAgent, este valor se omitirá. + + <preference name="AppendUserAgent" value="My Browser" /> http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/21c8e8f0/www/docs/es/6.x/guide/platforms/android/index.md ---------------------------------------------------------------------- diff --git a/www/docs/es/6.x/guide/platforms/android/index.md b/www/docs/es/6.x/guide/platforms/android/index.md new file mode 100644 index 0000000..a1583b4 --- /dev/null +++ b/www/docs/es/6.x/guide/platforms/android/index.md @@ -0,0 +1,275 @@ +--- +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 la plataforma Android +--- + +# GuÃa de la plataforma Android + +Esta guÃa muestra cómo configurar su entorno SDK para desplegar aplicaciones Cordova para dispositivos Android y cómo utilizar opcionalmente Android centrado en herramientas de lÃnea de comandos en su flujo de trabajo de desarrollo. Tienes que instalar el SDK de Android sin importar si desea utilizar estas herramientas plataforma centrada en la cáscara o multiplataforma Cordova CLI para el desarrollo. Para una comparación de las trayectorias de dos desarrollo, vea la información general. Para más detalles sobre el CLI, vea la interfaz de lÃnea de comandos. + +## Requisitos y apoyo + +Cordova para Android requiere el SDK de Android que puede ser instalado en sistema operativo OS X, Linux o Windows. Consulte del SDK de Android [requisitos del sistema][1]. + + [1]: http://developer.android.com/sdk/index.html#Requirements + +Cordova soporta Android 4.0 (empezando por Android API nivel 14) y superiores. Como regla general, las versiones de Android se convierten soportadas por Cordova como sumergen por debajo del 5% en del Google [tablero de distribución][2]. Las versiones de Android antes de las API de nivel 10, y las versiones 3.x (panal, los niveles API 11-13) caen significativamente por debajo de ese umbral de 5%. + + [2]: http://developer.android.com/about/dashboards/index.html + +## Instalar las herramientas de Shell Cordova + +Si desea utilizar herramientas de Cordova cáscara Android-centrado en conjunción con el SDK, descargar Cordova desde [cordova.apache.org][3]. De lo contrario ignorar esta sección si va a utilizar la herramienta CLI multiplataforma descrita en la interfaz de lÃnea de comandos. + + [3]: http://cordova.apache.org + +La descarga de Cordova contiene archivos separados para cada plataforma. Asegúrese de expandir el archivo apropiado, `android` en este caso, dentro de un directorio vacÃo. Las utilidades ejecutables correspondientes están disponibles en el nivel superior `bin` Directorio. (Si es necesario para obtener instrucciones más detalladas, consulte el archivo **README** ). + +Estas herramientas de shell le permiten crear, construir y ejecutar aplicaciones Android. Para obtener información sobre la interfaz de lÃnea de comandos adicional que permite plugin caracterÃsticas en todas las plataformas, ver usando Plugman para gestionar Plugins. Ver aplicación Plugins para obtener más información sobre cómo desarrollar plugins. + +## Instale el Kit de desarrollo de Java (JDK) + +Instalar [Java Development Kit (JDK) 7][4] o posterior. + + [4]: http://www.oracle.com/technetwork/java/javase/downloads/jdk7-downloads-1880260.html + +Cuando se instala en Windows también tienes que definir la Variable de entorno `JAVA_HOME` según la ruta de instalación de JDK (por ejemplo, C:\Program Files\Java\jdk1.7.0_75). + +## Instalar el SDK de Android + +Instalar las [herramientas de Android SDK independiente][5] o [Android Studio][6]. Proceder con el `Estudio de Android` si tiene previsto desarrollar nueva Córdoba para Android plugins o utilizando herramientas nativas para ejecutar y depurar la plataforma Android. De lo contrario, `Stand-alone Android SDK Tools` son suficientes para construir e implementar aplicaciones Android. + + [5]: http://developer.android.com/sdk/installing/index.html?pkg=tools + [6]: http://developer.android.com/sdk/installing/index.html?pkg=studio + +Instrucciones de instalación detalladas están disponibles como parte de los enlaces de la instalación anteriores. + +Cordova Herramientas de lÃnea de comandos para trabajar, o la CLI que se basa en ellos, necesita incluir directorios `Herramientas` y `herramientas de la plataforma` de la SDK en tu `camino`. En un Mac o Linux, puede utilizar un editor de texto para crear o modificar la `~/.bash_profile` archivo, agregar una lÃnea como la siguiente, dependiendo de donde se instala el SDK: + + export PATH=${PATH}:/Development/android-sdk/platform-tools:/Development/android-sdk/tools + + +Esta lÃnea en `~/.bash_profile` expone estas herramientas en windows terminales recién inauguradas. Si tu ventana de terminal ya está abierto en OSX o para evitar un cierre de sesión/inicio de sesión en Linux, ejecute esto para que estén disponibles en la ventana de terminal actual: + + $ source ~/.bash_profile + + +Para modificar el entorno `PATH` en Windows: + +1. Haga clic en el menú de **Inicio** en la esquina inferior izquierda del escritorio, haga clic derecho sobre **equipo**y seleccione **Propiedades**. + +2. Seleccione **Configuración avanzada del sistema** en la columna de la izquierda. + +3. En el cuadro de diálogo resultante, presione **Environment Variables**. + +4. Seleccione la variable **PATH** y pulse **Editar**. + +5. Añadir lo siguiente a la `PATH` basada en donde se ha instalado el SDK, por ejemplo: + + ;C:\Development\android-sdk\platform-tools;C:\Development\android-sdk\tools + + +6. El valor de guardar y cerrar ambos cuadros de diálogo. + +## Instalar paquetes SDK + +Abrir el administrador de Android SDK (por ejemplo, a través de terminal: `android`) e instalar: + +1. 5.1.1 Android (API 22) platform SDK +2. Android SDK Build-tools versión 19.1.0 o superior +3. Repositorio de Android soporte (Extras) + +Ver [Instalar paquetes SDK][7] para obtener más detalles. + + [7]: http://developer.android.com/sdk/installing/adding-packages.html + +## Configurar un emulador + +El sdk de Android no proporciona ninguna instancia de emulador predeterminada por defecto. Puede crear una nueva ejecutando `android` en la lÃnea de comandos. La prensa **Herramientas â administrar AVDs** (Android dispositivos virtuales), luego elegir cualquier artÃculo de **Definiciones de dispositivos** en el cuadro de diálogo resultante: + +![][8] + + [8]: {{ site.baseurl }}/static/img/guide/platforms/android/asdk_device.png + +Pulse **Crear AVD**, opcionalmente modificar el nombre, luego pulse **OK** para aceptar los cambios: + +![][9] + + [9]: {{ site.baseurl }}/static/img/guide/platforms/android/asdk_newAVD.png + +La AVD entonces aparece en la lista de **Dispositivos Android Virtual** : + +![][10] + + [10]: {{ site.baseurl }}/static/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: + +![][11] + + [11]: {{ site.baseurl }}/static/img/guide/platforms/android/asdk_emulator.png + +Para una experiencia más rápida, puede utilizar la `Aceleración de la máquina Virtual` para mejorar la velocidad de ejecución. Muchas CPUs modernas ofrecen extensiones para ejecutar máquinas virtuales más eficientemente. Antes de usar este tipo de aceleración, es necesario determinar si CPU de su sistema actual de desarrollo, uno admite las siguientes tecnologÃas de virtualización: + +* **TecnologÃa de virtualización Intel** (VT-x, vmx) â [Intel VT-x procesador lista soportada][12] +* **AMD Virtualization** (AMD-V, SVM), sólo se admite para Linux (desde mayo de 2006, todas las CPUs de AMD incluyen AMD-V, excepto Sempron). + + [12]: http://ark.intel.com/products/virtualizationtechnology + +Otra forma de averiguar si su procesador Intel compatible con la tecnologÃa VT-x, es mediante la ejecución de la `Utilidad de identificación de procesadores Intel`, para `Windows`puede descargarlo desde el [Centro de descarga][13]de Intel, o puede utilizar la [utilidad booteable][14], que es `Independiente del sistema operativo`. + + [13]: https://downloadcenter.intel.com/Detail_Desc.aspx?ProductID=1881&DwnldID=7838 + [14]: https://downloadcenter.intel.com/Detail_Desc.aspx?ProductID=1881&DwnldID=7840&lang=eng + +Después de instalar y ejecutar la `Utilidad de identificación de procesador Intel` sobre ventanas, obtendrá la ventana siguiente, con el fin de comprobar si su CPU es compatible con las tecnologÃas de virtualización: + +![][15] + + [15]: {{ site.baseurl }}/static/img/guide/platforms/android/intel_pid_util_620px.png + +Para acelerar el emulador, tienes que descargar e instalar uno o más imágenes del sistema `x 86 de Intel Atom` , asà como el `Intel Hardware acelerado ejecución Manager (HAXM)`. + +Abre tu Android SDK Manager y seleccione la imagen del sistema `x 86 de Intel Atom` , para cualquier versión que desea probar. Luego ir a `Extras` `Acelerador Intel x 86 de emulador (HAXM)`y seleccione instalar los paquetes: + +![][16] + + [16]: {{ site.baseurl }}/static/img/guide/platforms/android/asdk_man_intel_image_haxm.png + +Después de la descarga, ejecute al instalador de Intel, que está disponible en el SDK de Android en `extras/intel/Hardware_Accelerated_Execution_Manager`. **Nota**:`si tienes algún problema al instalar el paquete, usted puede encontrar más información y orientación paso a paso revise este` [ArtÃculo de Intel][17]. + + [17]: http://software.intel.com/en-us/android/articles/speeding-up-the-android-emulator-on-intel-architecture + +1. Instalar una o más imágenes del sistema `x 86 de Intel Atom` , asà como la `Acelerada ejecución administrador de Hardware de Intel`, disponible bajo **Extras**. + +2. Ejecute al instalador de Intel, que está disponible en el SDK de Android en `extras/intel/Hardware_Accelerated_Execution_Manager`. + +3. Crear un nuevo AVD con el objetivo fijado a una imagen de Intel. + +4. Al iniciar el emulador, asegúrese que no hay error mensajes indicando la imposibilidad de cargar módulos HAX. + +## Crear un nuevo proyecto + +En este punto, para crear un nuevo proyecto puede elegir entre la herramienta de la cruz-plataforma CLI que se describe en la interfaz de lÃnea de comandos, o el conjunto de herramientas de shell especÃficas para Android. Desde dentro de un directorio del código fuente, aquà es el enfoque CLI: + + $ cordova create hello com.example.hello HelloWorld + $ cd hello + $ cordova platform add android + $ ccordova prepare # or "cordova build" + + +Aquà es el enfoque de shell-herramienta de nivel inferior correspondiente para Unix y Windows: + + $ /path/to/cordova-android/bin/create /path/to/new/hello com.example.hello HelloWorld + C:\path\to\cordova-android\bin\create.bat C:\path\to\new\hello com.example.hello HelloWorld + + +## Construcción del proyecto + +Si utilizas la CLI en desarrollo, directorio de nivel superior `www` del directorio proyecto contiene los archivos de origen. Ejecutar cualquiera de éstos dentro del directorio del proyecto para la reconstrucción de la aplicación: + + $ cordova build # build all platforms that were added + $ cordova build android # build debug for only Android + $ cordova build android --debug # build debug for only Android + $ cordova build android --release # build release for only Android + + +Si está utilizando las herramientas de shell especÃficas para Android en desarrollo, hay un enfoque diferente. Una vez que se genera el proyecto, fuente de la aplicación por defecto está disponible en el subdirectorio de `activos/www` . Los comandos están disponibles en su subdirectorio `cordova` . + +El comando `build` limpia archivos de proyecto y reconstruye la aplicación. Aquà está la sintaxis para Mac y Windows. El primer par de ejemplos generará información de depuración, y la segunda crea las aplicaciones para el lanzamiento: + + $ /path/to/project/cordova/build --debug + C:\path\to\project\cordova\build.bat --debug + + $ /path/to/project/cordova/build --release + C:\path\to\project\cordova\build.bat --release + + +## Desplegar la aplicación + +Puede utilizar la utilidad CLI `cordova` para desplegar la aplicación en el emulador o el dispositivo desde la lÃnea de comandos: + + $ cordova emulate android #to deploy the app on a default android emulator + $ cordova run android --device #to deploy the app on a connected device + + +De lo contrario, utilice la interfaz de shell alterno: + + $ /path/to/project/cordova/run --emulator + $ /path/to/project/cordova/run --device + + +Puede utilizar **cordova run android --list** para ver todos los destinos disponibles y **cordova run android --target = target_name** para ejecutar la aplicación en un dispositivo especÃfico o un emulador (por ejemplo, `cordova run android --target = "Nexus4_emulator"`). + +También puede utilizar **cordova run --help** para ver opciones adicionales para construir y correr. + +Esto empuja la aplicación a la pantalla de inicio y lo lanza: + +![][18] + + [18]: {{ site.baseurl }}/static/img/guide/platforms/android/emulator2x.png + +Cuando se `ejecuta` la aplicación, también se `construye` . Puede anexar adicional `--debug`, `--release`y `--nobuild` banderas para controlar cómo se construye, o incluso si es necesaria una reconstrucción: + + $ /path/to/project/cordova/run --emulator --nobuild + + +## Otros comandos + +Los siguientes genera un registro detallado de la aplicación que se ejecuta: + + $ /path/to/project/cordova/log + C:\path\to\project\cordova\log.bat + + +A continuación limpia los archivos del proyecto: + + $ /path/to/project/cordova/clean + C:\path\to\project\cordova\clean.bat + + +## Abra un nuevo proyecto en el SDK + +Una vez que la plataforma android se agrega a su proyecto, puede abrir desde dentro de [Android Studio][6]: + +1. Inicie la aplicación **Android Studio** . + +2. Seleccione **Importar proyecto (Eclipse ADT, Gradle, etc.)**. + + ![][19] + +3. Seleccione la ubicación donde la plataforma android es almacenado (`su/proyecto/platform/android`). + + ![][20] + +4. Para la pregunta `Gradle Sync` puede responder simplemente **SÃ**. + + [19]: {{ site.baseurl }}/static/img/guide/platforms/android/asdk_import_project.png + [20]: {{ site.baseurl }}/static/img/guide/platforms/android/asdk_import_select_location.png + +Listo ahora y puede construir y ejecutar la aplicación directamente desde `Android Studio`. + +![][21] + + [21]: {{ site.baseurl }}/static/img/guide/platforms/android/asdk_import_done.png + +Ver [Resumen estudio Android][22] y [construcción y huyendo de Android Studio][23] para más detalles. + + [22]: http://developer.android.com/tools/studio/index.html + [23]: http://developer.android.com/tools/building/building-studio.html --------------------------------------------------------------------- To unsubscribe, e-mail: commits-unsubscr...@cordova.apache.org For additional commands, e-mail: commits-h...@cordova.apache.org