http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/f061b980/www/docs/es/dev/guide/platforms/blackberry10/upgrade.md ---------------------------------------------------------------------- diff --git a/www/docs/es/dev/guide/platforms/blackberry10/upgrade.md b/www/docs/es/dev/guide/platforms/blackberry10/upgrade.md new file mode 100644 index 0000000..adac478 --- /dev/null +++ b/www/docs/es/dev/guide/platforms/blackberry10/upgrade.md @@ -0,0 +1,484 @@ +--- +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: Actualizar BlackBerry 10 +--- + +# Actualizar BlackBerry 10 + +Esta guÃa le muestra cómo modificar proyectos de BlackBerry para actualizar desde versiones anteriores de Córdoba. La mayorÃa de estas instrucciones se aplica a proyectos creados con un conjunto mayor de herramientas de lÃnea de comandos que preceden a la utilidad de la CLI de `cordova`. Vea la interfaz de lÃnea de comandos para información de cómo actualizar la versión de la CLI. + +## Proyectos de modernización 3.6.0 a 4.0.0 + +Para proyectos no-CLI, ejecute: + + bin/ruta/a/proyecto de actualización + + +Para los proyectos de CLI: + +1. Actualización de la `cordova` versión CLI. Vea la interfaz de lÃnea de comandos. + +2. Ejecute `cordova platform update blackberry` en tus proyectos ya existentes. + +## Actualización a 3.2.0 de 3.1.0 + +Para los proyectos que se crearon con el cordova CLI: + +1. Actualización de la `cordova` versión CLI. Vea la interfaz de lÃnea de comandos. + +2. Ejecutar`cordova platform update blackberry` + +Para proyectos no creados con el cordova CLI, ejecute: + + bin/update <project_path> + + +## Actualizar a 3.1.0 desde 3.0.0 + +1. Crear un nuevo proyecto de Apache Cordova 3.1.0 usando el cordova CLI, tal como se describe en la interfaz de lÃnea de comandos. + +2. Agregue sus plataformas al proyecto cordova, por ejemplo: `cordova platform add blackberry10`. + +3. Copiar el contenido del proyecto original `www` Directorio del `www` Directorio en la raÃz del proyecto cordova que acaba de crear. + +4. Copiar o sobrescribir ningún activo nativo de su proyecto original ( `Resources` , etc..) + +5. Copia del `config.xml` de archivos a la `www` Directorio y quite cualquier plugin definiciones. Tienes que modificar la configuración aquà más que en el directorio de plataforma. + +6. Utilice la herramienta CLI cordova instalar algún plugin que necesita. Tenga en cuenta que la CLI maneja todo núcleo APIs como plugins, asà pueden necesitar ser agregado. Solo plugins marcó 3.0.0 y encima son compatibles con la CLI. + +7. Construir y probar. + +Por favor tenga en cuenta que el CLI compatible con la plataforma BlackBerry10 exclusivamente. Para el libro de jugadas y BBOS, ver Cordova versión 2.9.0 magnetohidrodinámica y por debajo. + +## ActualÃcese a la CLI (3.0.0) de 2.9.0 magnetohidrodinámica + +1. Crear un nuevo proyecto de Apache Cordova 3.0.0 usando el cordova CLI, tal como se describe en la interfaz de lÃnea de comandos. + +2. Agregue sus plataformas al proyecto cordova, por ejemplo:`cordova +platform add blackberry10`. + +3. Copiar el contenido del proyecto original `www` Directorio del `www` Directorio en la raÃz del proyecto cordova que acaba de crear. + +4. Copiar o sobrescribir ningún activo nativo de su proyecto original ( `Resources` , etc..) + +5. Copia del `config.xml` de archivos a la `www` Directorio y quite cualquier plugin definiciones. Tienes que modificar la configuración aquà más que en el directorio de plataforma. + +6. Utilice la herramienta CLI cordova instalar algún plugin que necesita. Tenga en cuenta que la CLI maneja todo núcleo APIs como plugins, asà pueden necesitar ser agregado. Sólo 3.0.0 plugins son compatibles con la CLI. + +7. Construir y probar. + +## Proyectos de modernización 2.8.0 a 2.9.0 magnetohidrodinámica + +Para BlackBerry 10: + +1. Descargue y extraiga la fuente Cordova 2.9.0 magnetohidrodinámica a una ubicación de directorio permanente en tu disco duro, por ejemplo a`~/Cordova-2.9.0`. + +2. Dejar cualquier corriente SDK Herramientas: Eclipse, Momentics y similares. + +3. Desplácese hasta el directorio donde pusiste la fuente descargada anteriormente, utilizando un unix como terminal: Terminal.app Cygwin, Bash, etc.. + +4. Crear un nuevo proyecto, como se describe en la guÃa de herramientas de Shell de BlackBerry. Esto se convierte en la página de inicio de tu proyecto actualizado. + +5. Copie su fuente de proyectos desde el viejo proyecto `/www` del proyecto nuevo directorio `/www` Directorio. + +6. Actualizar la referencia de script Cordova en el `www/index.html` archivo (y otros archivos que contienen la referencia de comandos) para que apunte a la nueva `cordova.js` archivo. + +Para BlackBerryOS/Playbook: + +1. Descargue y extraiga la fuente Cordova 2.9.0 magnetohidrodinámica a una ubicación de directorio permanente en tu disco duro, por ejemplo a`~/Cordova-2.9.0`. + +2. Dejar cualquier corriente SDK Herramientas: Eclipse, Momentics y similares. + +3. Desplácese hasta el directorio donde pusiste la fuente descargada anteriormente, utilizando un unix como terminal: Terminal.app Cygwin, Bash, etc.. + +4. Crear un nuevo proyecto, como se describe en la guÃa de herramientas de Shell de BlackBerry. Necesita los activos de este nuevo proyecto. + +5. Copia el `www/cordova.js` archivo del nuevo proyecto en el `www` Directorio y eliminar el `www/cordova.js` archivo. + +6. Actualizar la referencia de script Cordova en el `www/index.html` archivo (y otros archivos que contienen la referencia de comandos) para que apunte a la nueva `cordova.js` archivo. + +7. Copia el `native` directorio desde el nuevo proyecto en el proyecto existente, sobrescribiendo el viejo `native` Directorio. + +8. Copia el `lib` directorio desde el nuevo proyecto en el proyecto existente, sobrescribiendo el viejo `lib` Directorio. + +9. Copia el `cordova` directorio desde el nuevo proyecto en el proyecto existente, sobrescribiendo el viejo `cordova` Directorio. + +## Proyectos de modernización 2.7.0 a 2.8.0 + +BlackBerry 10 utiliza las nuevas herramientas de CLI y gestiona núcleo APIs como plugins. Las instrucciones de migran su proyecto a un nuevo proyecto, en lugar de actualizar un proyecto existente, debido a la complejidad de un proyecto de actualización. También nota que el js cordova de la escritura de archivos ahora se llama 'cordova.js' y ya no contiene una cadena de versión. + +1. Descargue y extraiga la fuente Cordova 2.8.0 a una ubicación de directorio permanente en tu disco duro, por ejemplo a`~/Cordova-2.8.0`. + +2. Dejar cualquier corriente SDK Herramientas: Eclipse, Momentics y similares. + +3. Desplácese hasta el directorio donde pusiste la fuente descargada anteriormente, utilizando un unix como terminal: Terminal.app Cygwin, Bash, etc.. + +4. Crear un nuevo proyecto, como se describe en la guÃa de herramientas de Shell de BlackBerry. Esto se convierte en la página de inicio de tu proyecto actualizado. + +5. Copie su fuente de proyectos desde el viejo proyecto `/www` del proyecto nuevo directorio `/www` Directorio. + +6. Actualizar la referencia de script Cordova en el `www/index.html` archivo (y otros archivos que contienen la referencia de comandos) para que apunte a la nueva `cordova.js` archivo. + +Para BlackBerryOS/Playbook: + +1. Descargue y extraiga la fuente Cordova 2.8.0 a una ubicación de directorio permanente en tu disco duro, por ejemplo a`~/Cordova-2.8.0`. + +2. Dejar cualquier corriente SDK Herramientas: Eclipse, Momentics y similares. + +3. Desplácese hasta el directorio donde pusiste la fuente descargada anteriormente, utilizando un unix como terminal: Terminal.app Cygwin, Bash, etc.. + +4. Crear un nuevo proyecto, como se describe en la guÃa de herramientas de Shell de BlackBerry. Necesita los activos de este nuevo proyecto. + +5. Copia el `www/cordova.js` archivo del nuevo proyecto en el `www` Directorio y eliminar el `www/cordova.js` archivo. + +6. Actualizar la referencia de script Cordova en el `www/index.html` archivo (y otros archivos que contienen la referencia de comandos) para que apunte a la nueva `cordova.js` archivo. + +7. Copia el `native` directorio desde el nuevo proyecto en el proyecto existente, sobrescribiendo el viejo `native` Directorio. + +8. Copia el `lib` directorio desde el nuevo proyecto en el proyecto existente, sobrescribiendo el viejo `lib` Directorio. + +9. Copia el `cordova` directorio desde el nuevo proyecto en el proyecto existente, sobrescribiendo el viejo `cordova` Directorio. + +## Proyectos de modernización 2.6.0 a 2.7.0 + +1. Descargue y extraiga la fuente Cordova 2.7.0 a una ubicación de directorio permanente en tu disco duro, por ejemplo a`~/Cordova-2.7.0`. + +2. Dejar cualquier corriente SDK Herramientas: Eclipse, Momentics y similares. + +3. Desplácese hasta el directorio donde pusiste la fuente descargada anteriormente, utilizando un unix como terminal: Terminal.app Cygwin, Bash, etc.. + +4. Crear un nuevo proyecto, como se describe en la guÃa de herramientas de Shell de BlackBerry. Necesitas los activos de este nuevo proyecto. + +5. Copia el `www/cordova-2.7.0.js` archivo del nuevo proyecto en el `www` Directorio y eliminar el `www/cordova-2.6.0.js` archivo. + +6. Actualizar la referencia de script Cordova en el `www/index.html` archivo (y otros archivos que contienen la referencia de comandos) para que apunte a la nueva `cordova-2.7.0.js` archivo. + +7. Copia el `native` directorio desde el nuevo proyecto en el proyecto existente, sobrescribiendo el viejo `native` Directorio. + +8. Copia el `lib` directorio desde el nuevo proyecto en el proyecto existente, sobrescribiendo el viejo `lib` Directorio. + +9. Copia el `cordova` directorio desde el nuevo proyecto en el proyecto existente, sobrescribiendo el viejo `cordova` Directorio. + +## Actualizar a 2.6.0 desde 2.5.0 + +Actualizar el directorio de descarga PhoneGap: + +Se recomienda que usted descargar una copia nueva de todo el directorio. + +Sin embargo, aquà están las nuevas piezas necesarias para la actualización gradual: + +1. Actualizar el archivo cordova.blackberry.js en la `Phonegap-2.6.0/lib/blackberry/javascript` Directorio. + +2. Actualización de la `ext` , `ext-air` , y `ext-qnx` en el `Phonegap-2.6.0/lib/blackberry/framework` Directorio. + +3. Actualización de la `build.xml` de los archivos en el `Phonegap-2.6.0/lib/blackberry` Directorio. + +4. Actualización del `Phonegap-2.6.0/lib/blackberry/bin` Directorio. + +5. Actualización de la `VERSION` de los archivos en el `Phonegap-2.6.0/lib/blackberry` Directorio. + +Actualizando el ejemplo / proyecto de directorio o migrar existente: + +1. Abierta la `www` directorio que contiene la aplicación. + +2. Quitar y actualizar el archivo .jar en la `ext/` Directorio. + +3. Actualizar el contenido de la `ext-air/` Directorio. + +4. Actualizar el contenido de la `ext-qnx/` Directorio. + +5. Copie el nuevo `cordova-2.6.0.js` en su proyecto. + +6. Actualizar el código HTML para usar el nuevo `cordova-2.6.0.js` archivo. + +## Actualizar a 2.5.0 desde 2.4.0 + +Actualizar el directorio de descarga PhoneGap: + +Se recomienda que usted descargar una copia nueva de todo el directorio. + +Sin embargo, aquà están las nuevas piezas necesarias para la actualización gradual: + +1. Actualizar el archivo cordova.blackberry.js en la `Phonegap-2.5.0/lib/blackberry/javascript` Directorio. + +2. Actualización de la `ext` , `ext-air` , y `ext-qnx` en el `Phonegap-2.5.0/lib/blackberry/framework` Directorio. + +3. Actualización de la `build.xml` de los archivos en el `Phonegap-2.5.0/lib/blackberry` Directorio. + +4. Actualización del `Phonegap-2.5.0/lib/blackberry/bin` Directorio. + +5. Actualización de la `VERSION` de los archivos en el `Phonegap-2.5.0/lib/blackberry` Directorio. + +Actualizando el ejemplo / proyecto de directorio o migrar existente: + +1. Abierta la `www` directorio que contiene la aplicación. + +2. Quitar y actualizar el archivo .jar en la `ext/` Directorio. + +3. Actualizar el contenido de la `ext-air/` Directorio. + +4. Actualizar el contenido de la `ext-qnx/` Directorio. + +5. Copie el nuevo `cordova-2.5.0.js` en su proyecto. + +6. Actualizar el código HTML para usar el nuevo `cordova-2.5.0.js` archivo. + +## Actualizar a 2.4.0 desde 2.3.0 + +Actualizar el `www` Directorio: + +1. Abierta la `www` directorio que contiene la aplicación. + +2. Quitar y actualizar el archivo .jar en la `ext/` Directorio. + +3. Actualizar el contenido de la `ext-air/` Directorio. + +4. Copie el nuevo `cordova-2.4.0.js` en su proyecto. + + * Si el libro de jugadas, luego actualizar el .js archivo en el `playbook/` Directorio. + * Si BlackBerry 10, luego actualizar el archivo .js en el `qnx/` Directorio. + +5. Actualizar el código HTML para usar el nuevo `cordova-2.4.0.js` archivo. + +Actualizar el directorio de muestra (es decir, actualización usando las herramientas de hormiga): + +1. Abierta la `sample/lib/` Directorio. + +2. Actualizar el archivo .jar en la `cordova.2.3.0/ext/` Directorio. + +3. Actualizar el contenido de la `cordova.2.3.0/ext-air/` Directorio. + +4. Actualizar el contenido de la `cordova.2.3.0/ext-qnx/` Directorio. + +5. Actualizar el archivo .js en el `cordova.2.3.0/javascript/` Directorio. + +6. Abierta la `sample/lib/` Directorio y renombrar el `cordova.2.3.0/` Directorio`cordova.2.4.0/`. + +7. Tipo `ant blackberry build` o `ant playbook build` para actualizar el `www` Directorio con Cordova actualizado. + +8. Abierta la `www` Directorio y actualizar el código HTML para usar el nuevo `cordova-2.4.0.js` archivo. + +## Actualizar a 2.3.0 desde 2.2.0 + +Actualizar el `www` Directorio: + +1. Abierta la `www` directorio que contiene la aplicación. + +2. Quitar y actualizar el archivo .jar en la `ext/` Directorio. + +3. Actualizar el contenido de la `ext-air/` Directorio. + +4. Copie el nuevo `cordova-2.3.0.js` en su proyecto. + + * Si el libro de jugadas, luego actualizar el .js archivo en el `playbook/` Directorio. + * Si BlackBerry 10, luego actualizar el archivo .js en el `qnx/` Directorio. + +5. Actualizar el código HTML para usar el nuevo `cordova-2.3.0.js` archivo. + +Actualizar el directorio de muestra (es decir, actualización usando las herramientas de hormiga): + +1. Abierta la `sample/lib/` Directorio. + +2. Actualizar el archivo .jar en la `cordova.2.2.0/ext/` Directorio. + +3. Actualizar el contenido de la `cordova.2.2.0/ext-air/` Directorio. + +4. Actualizar el contenido de la `cordova.2.2.0/ext-qnx/` Directorio. + +5. Actualizar el archivo .js en el `cordova.2.2.0/javascript/` Directorio. + +6. Abierta la `sample/lib/` Directorio y renombrar el `cordova.2.2.0/` Directorio`cordova.2.3.0/`. + +7. Tipo `ant blackberry build` o `ant playbook build` para actualizar el `www` Directorio con Cordova actualizado. + +8. Abierta la `www` Directorio y actualizar el código HTML para usar el nuevo `cordova-2.3.0.js` archivo. + +## Actualizar a 2.2.0 desde 2.1.0 + +Actualizar sólo el directorio www: + +1. Abierta la `www` directorio que contiene la aplicación. + +2. Quitar y actualizar el archivo .jar en la `ext/` Directorio. + +3. Actualizar el contenido de la `ext-air/` Directorio. + +4. Copie el nuevo `cordova-2.2.0.js` en su proyecto. + + * Si el libro de jugadas, luego actualizar el .js archivo en el `playbook/` Directorio. + * Si BlackBerry 10, luego actualizar el archivo .js en el `qnx/` Directorio. + +5. Actualizar el código HTML para usar el nuevo `cordova-2.2.0.js` archivo. + +Actualizar el directorio de muestra (es decir, actualización usando las herramientas de hormiga): + +1. Abierta la `sample/lib/` Directorio. + +2. Actualizar el archivo .jar en la `cordova.2.1.0/ext/` Directorio. + +3. Actualizar el contenido de la `cordova.2.1.0/ext-air/` Directorio. + +4. Actualizar el contenido de la `cordova.2.1.0/ext-qnx/` Directorio. + +5. Actualizar el archivo .js en el `cordova.2.1.0/javascript/` Directorio. + +6. Abierta la `sample/lib/` Directorio y renombrar el `cordova.2.1.0/` Directorio`cordova.2.2.0/`. + +7. Tipo `ant blackberry build` o `ant playbook build` para actualizar el `www` Directorio con Cordova actualizado. + +8. Abierta la `www` Directorio y actualizar el código HTML para usar el nuevo `cordova-2.2.0.js` archivo. + +## Actualizar a 2.1.0 desde 2.0.0 + +Actualizar el `www` Directorio: + +1. Abierta la `www` directorio que contiene la aplicación. + +2. Quitar y actualizar el archivo .jar en la `ext/` Directorio. + +3. Actualizar el contenido de la `ext-air/` Directorio. + +4. Copie el nuevo `cordova-2.1.0.js` en su proyecto. + + * Si el libro de jugadas, luego actualizar el .js archivo en el `playbook/` Directorio. + +5. Actualizar el código HTML para usar el nuevo `cordova-2.1.0.js` archivo. + +Actualizar el directorio de muestra (es decir, actualización usando las herramientas de hormiga): + +1. Abierta la `sample/lib/` Directorio. + +2. Actualizar el archivo .jar en la `cordova.2.0.0/ext/` Directorio. + +3. Actualizar el contenido de la `cordova.2.0.0/ext-air/` Directorio. + +4. Actualizar el archivo .js en el `cordova.2.0.0/javascript/` Directorio. + +5. Abierta la `sample/lib/` Directorio y renombrar el `cordova.2.0.0/` Directorio`cordova.2.1.0/`. + +6. Tipo `ant blackberry build` o `ant playbook build` para actualizar el `www` Directorio con Cordova actualizado. + +7. Abierta la `www` Directorio y actualizar el código HTML para usar el nuevo `cordova-2.1.0.js` archivo. + +## Actualizar a 2.0.0 desde 1.9.0 + +Actualizar el `www` Directorio: + +1. Abierta la `www` directorio que contiene la aplicación. + +2. Quitar y actualizar el archivo .jar en la `ext/` Directorio. + +3. Actualizar el contenido de la `ext-air/` Directorio. + +4. Copie el nuevo `cordova-2.0.0.js` en su proyecto. + + * Si el libro de jugadas, luego actualizar el .js archivo en el `playbook/` Directorio. + +5. Actualizar el código HTML para usar el nuevo `cordova-2.0.0.js` archivo. + +6. Actualización de la `www/plugins.xml` archivo. Dos plugins cambió su etiqueta de servicio de nombres. Cambiar las entradas viejas para los plugins de captura y contacto: + + < nombre del plugin = "Capturar" value="org.apache.cordova.media.MediaCapture"/ >< nombre del plugin = "Contacto" value="org.apache.cordova.pim.Contact"/ > + + + Para: + + < nombre del plugin = "Capturar" value="org.apache.cordova.capture.MediaCapture"/ >< nombre del plugin "Contactos" value="org.apache.cordova.pim.Contact"/ = > + + +Actualizar el directorio de muestra (es decir, actualización usando las herramientas de hormiga): + +1. Abierta la `sample/lib/` Directorio. + +2. Actualizar el archivo .jar en la `cordova.1.9.0/ext/` Directorio. + +3. Actualizar el contenido de la `cordova.1.9.0/ext-air/` Directorio. + +4. Actualizar el archivo .js en el `cordova.1.9.0/javascript/` Directorio. + +5. Abierta la `sample/lib/` Directorio y renombrar el `cordova.1.9.0/` Directorio`cordova.2.0.0/`. + +6. Tipo `ant blackberry build` o `ant playbook build` para actualizar el `www` Directorio con Cordova actualizado. + +7. Abierta la `www` Directorio y actualizar el código HTML para usar el nuevo `cordova-2.0.0.js` archivo. + +8. Abierta la `www` Directorio y actualizar el `plugins.xml` archivo. Dos plugins cambió su etiqueta de servicio de nombres. Cambiar las entradas viejas para los plugins de captura y contacto: + + < nombre del plugin = "Capturar" value="org.apache.cordova.media.MediaCapture"/ >< nombre del plugin = "Contacto" value="org.apache.cordova.pim.Contact"/ > + + + Para: + + < nombre del plugin = "Capturar" value="org.apache.cordova.capture.MediaCapture"/ >< nombre del plugin "Contactos" value="org.apache.cordova.pim.Contact"/ = > + + +* Para actualizar a 1.8.0, por favor ir de 1.7.0 + +## Actualizar a 1.8.0 de 1.7.0 + +Actualizar el `www` Directorio: + +1. Abierta la `www` directorio que contiene la aplicación. + +2. Quitar y actualizar el archivo .jar en la `ext/` Directorio. + +3. Actualizar el contenido de la `ext-air/` Directorio. + +4. Copie el nuevo `cordova-1.8.0.js` en su proyecto. + + * Si el libro de jugadas, luego actualizar el .js archivo en el `playbook/` Directorio. + +5. Actualizar el código HTML para usar el nuevo `cordova-1.8.0.js` archivo. + +6. Actualización de la `www/plugins.xml` archivo. Dos plugins cambió su etiqueta de servicio de nombres. Cambiar las entradas viejas para los plugins de captura y contacto: + + < nombre del plugin = "Capturar" value="org.apache.cordova.media.MediaCapture"/ >< nombre del plugin = "Contacto" value="org.apache.cordova.pim.Contact"/ > + + + Para: + + < nombre del plugin = "Capturar" value="org.apache.cordova.capture.MediaCapture"/ >< nombre del plugin "Contactos" value="org.apache.cordova.pim.Contact"/ = > + + +Actualizar el directorio de muestra (es decir, actualización usando las herramientas de hormiga): + +1. Abierta la `sample/lib/` Directorio. + +2. Actualizar el archivo .jar en la `cordova.1.7.0/ext/` Directorio. + +3. Actualizar el contenido de la `cordova.1.7.0/ext-air/` Directorio. + +4. Actualizar el archivo .js en el `cordova.1.7.0/javascript/` Directorio. + +5. Abierta la `sample/lib/` Directorio y renombrar el `cordova.1.7.0/` Directorio`cordova.1.8.0/`. + +6. Tipo `ant blackberry build` o `ant playbook build` para actualizar el `www` Directorio con Cordova actualizado. + +7. Abierta la `www` Directorio y actualizar el código HTML para usar el nuevo `cordova-1.8.0.js` archivo. + +8. Abierta la `www` Directorio y actualizar el `plugins.xml` archivo. Dos plugins cambió su etiqueta de servicio de nombres. Cambiar las entradas viejas para los plugins de captura y contacto: + + < nombre del plugin = "Capturar" value="org.apache.cordova.media.MediaCapture"/ >< nombre del plugin = "Contacto" value="org.apache.cordova.pim.Contact"/ > + + + Para: + + < nombre del plugin = "Capturar" value="org.apache.cordova.capture.MediaCapture"/ >< nombre del plugin "Contactos" value="org.apache.cordova.pim.Contact"/ = > \ No newline at end of file
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/f061b980/www/docs/es/dev/guide/platforms/blackberry10/upgrading.md ---------------------------------------------------------------------- diff --git a/www/docs/es/dev/guide/platforms/blackberry10/upgrading.md b/www/docs/es/dev/guide/platforms/blackberry10/upgrading.md new file mode 100644 index 0000000..ec28cb9 --- /dev/null +++ b/www/docs/es/dev/guide/platforms/blackberry10/upgrading.md @@ -0,0 +1,472 @@ +--- +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: Actualizar BlackBerry 10 +--- + +# Actualizar BlackBerry 10 + +Esta guÃa le muestra cómo modificar los proyectos de BlackBerry para actualizar desde versiones anteriores de Córdoba. La mayorÃa de estas instrucciones se aplica a proyectos creados con un mayor conjunto de herramientas de lÃnea de comandos que preceden a la `cordova` utilidad de CLI. Vea la interfaz de lÃnea de comandos para información de cómo actualizar la versión de la CLI. + +## Actualización a 3.2.0 de 3.1.0 + +Para los proyectos que se crearon con el cordova CLI: + +1. Actualización de la `cordova` versión CLI. Vea la interfaz de lÃnea de comandos. + +2. Ejecutar`cordova platform update blackberry` + +Para proyectos no creados con el cordova CLI, ejecute: + + bin/actualizar < project_path > + + +## Actualizar a 3.1.0 desde 3.0.0 + +1. Crear un nuevo proyecto de Apache Cordova 3.1.0 usando el cordova CLI, tal como se describe en la interfaz de lÃnea de comandos. + +2. Agregue sus plataformas al proyecto cordova, por ejemplo:`cordova +platform add blackberry10`. + +3. Copiar el contenido del proyecto original `www` Directorio del `www` Directorio en la raÃz del proyecto cordova que acaba de crear. + +4. Copiar o sobrescribir ningún activo nativo de su proyecto original ( `Resources` , etc..) + +5. Copia del `config.xml` de archivos a la `www` Directorio y quite cualquier plugin definiciones. Tienes que modificar la configuración aquà más que en el directorio de plataforma. + +6. Utilice la herramienta CLI cordova instalar algún plugin que necesita. Tenga en cuenta que la CLI maneja todo núcleo APIs como plugins, asà pueden necesitar ser agregado. Solo plugins marcó 3.0.0 y encima son compatibles con la CLI. + +7. Construir y probar. + +Por favor tenga en cuenta que el CLI compatible con la plataforma BlackBerry10 exclusivamente. Para el libro de jugadas y BBOS, ver Cordova versión 2.9.0 magnetohidrodinámica y por debajo. + +## ActualÃcese a la CLI (3.0.0) de 2.9.0 magnetohidrodinámica + +1. Crear un nuevo proyecto de Apache Cordova 3.0.0 usando el cordova CLI, tal como se describe en la interfaz de lÃnea de comandos. + +2. Agregue sus plataformas al proyecto cordova, por ejemplo:`cordova +platform add blackberry10`. + +3. Copiar el contenido del proyecto original `www` Directorio del `www` Directorio en la raÃz del proyecto cordova que acaba de crear. + +4. Copiar o sobrescribir ningún activo nativo de su proyecto original ( `Resources` , etc..) + +5. Copia del `config.xml` de archivos a la `www` Directorio y quite cualquier plugin definiciones. Tienes que modificar la configuración aquà más que en el directorio de plataforma. + +6. Utilice la herramienta CLI cordova instalar algún plugin que necesita. Tenga en cuenta que la CLI maneja todo núcleo APIs como plugins, asà pueden necesitar ser agregado. Sólo 3.0.0 plugins son compatibles con la CLI. + +7. Construir y probar. + +## Proyectos de modernización 2.8.0 a 2.9.0 magnetohidrodinámica + +Para BlackBerry 10: + +1. Descargue y extraiga la fuente Cordova 2.9.0 magnetohidrodinámica a una ubicación de directorio permanente en tu disco duro, por ejemplo a`~/Cordova-2.9.0`. + +2. Dejar cualquier corriente SDK Herramientas: Eclipse, Momentics y similares. + +3. Desplácese hasta el directorio donde pusiste la fuente descargada anteriormente, utilizando un unix como terminal: Terminal.app Cygwin, Bash, etc.. + +4. Crear un nuevo proyecto, como se describe en las herramientas de lÃnea de comandos de BlackBerry. Esto se convierte en la página de inicio de tu proyecto actualizado. + +5. Copie su fuente de proyectos desde el viejo proyecto `/www` del proyecto nuevo directorio `/www` Directorio. + +6. Actualizar la referencia de script Cordova en su `www/index.html` archivo (y otros archivos que contienen la referencia de comandos) para que apunte a la nueva `cordova.js` archivo. + +Para BlackBerryOS/Playbook: + +1. Descargue y extraiga la fuente Cordova 2.9.0 magnetohidrodinámica a una ubicación de directorio permanente en tu disco duro, por ejemplo a`~/Cordova-2.9.0`. + +2. Dejar cualquier corriente SDK Herramientas: Eclipse, Momentics y similares. + +3. Desplácese hasta el directorio donde pusiste la fuente descargada anteriormente, utilizando un unix como terminal: Terminal.app Cygwin, Bash, etc.. + +4. Crear un nuevo proyecto, como se describe en iOS herramientas de lÃnea de comandos. Necesitas los activos de este nuevo proyecto. + +5. Copia el `www/cordova.js` archivo del nuevo proyecto en tu `www` Directorio y eliminar su `www/cordova.js` archivo. + +6. Actualizar la referencia de script Cordova en su `www/index.html` archivo (y otros archivos que contienen la referencia de comandos) para que apunte a la nueva `cordova.js` archivo. + +7. Copia el `native` directorio desde el nuevo proyecto en el proyecto existente, sobrescribiendo el viejo `native` Directorio. + +8. Copia el `lib` directorio desde el nuevo proyecto en el proyecto existente, sobrescribiendo el viejo `lib` Directorio. + +9. Copia el `cordova` directorio desde el nuevo proyecto en el proyecto existente, sobrescribiendo el viejo `cordova` Directorio. + +## Proyectos de modernización 2.7.0 a 2.8.0 + +BlackBerry 10 utiliza las nuevas herramientas de CLI y gestiona núcleo APIs como plugins. Las instrucciones de migran su proyecto a un nuevo proyecto, en lugar de actualizar un proyecto existente, debido a la complejidad de un proyecto de actualización. También nota que el js cordova de la escritura de archivos ahora se llama 'cordova.js' y ya no contiene una cadena de versión. + +1. Descargue y extraiga la fuente Cordova 2.8.0 a una ubicación de directorio permanente en tu disco duro, por ejemplo a`~/Cordova-2.8.0`. + +2. Dejar cualquier corriente SDK Herramientas: Eclipse, Momentics y similares. + +3. Desplácese hasta el directorio donde pusiste la fuente descargada anteriormente, utilizando un unix como terminal: Terminal.app Cygwin, Bash, etc.. + +4. Crear un nuevo proyecto, como se describe en las herramientas de lÃnea de comandos de BlackBerry. Esto se convierte en la página de inicio de tu proyecto actualizado. + +5. Copie su fuente de proyectos desde el viejo proyecto `/www` del proyecto nuevo directorio `/www` Directorio. + +6. Actualizar la referencia de script Cordova en su `www/index.html` archivo (y otros archivos que contienen la referencia de comandos) para que apunte a la nueva `cordova.js` archivo. + +Para BlackBerryOS/Playbook: + +1. Descargue y extraiga la fuente Cordova 2.8.0 a una ubicación de directorio permanente en tu disco duro, por ejemplo a`~/Cordova-2.8.0`. + +2. Dejar cualquier corriente SDK Herramientas: Eclipse, Momentics y similares. + +3. Desplácese hasta el directorio donde pusiste la fuente descargada anteriormente, utilizando un unix como terminal: Terminal.app Cygwin, Bash, etc.. + +4. Crear un nuevo proyecto, como se describe en iOS herramientas de lÃnea de comandos. Necesitas los activos de este nuevo proyecto. + +5. Copia el `www/cordova.js` archivo del nuevo proyecto en tu `www` Directorio y eliminar su `www/cordova.js` archivo. + +6. Actualizar la referencia de script Cordova en su `www/index.html` archivo (y otros archivos que contienen la referencia de comandos) para que apunte a la nueva `cordova.js` archivo. + +7. Copia el `native` directorio desde el nuevo proyecto en el proyecto existente, sobrescribiendo el viejo `native` Directorio. + +8. Copia el `lib` directorio desde el nuevo proyecto en el proyecto existente, sobrescribiendo el viejo `lib` Directorio. + +9. Copia el `cordova` directorio desde el nuevo proyecto en el proyecto existente, sobrescribiendo el viejo `cordova` Directorio. + +## Proyectos de modernización 2.6.0 a 2.7.0 + +1. Descargue y extraiga la fuente Cordova 2.7.0 a una ubicación de directorio permanente en tu disco duro, por ejemplo a`~/Cordova-2.7.0`. + +2. Dejar cualquier corriente SDK Herramientas: Eclipse, Momentics y similares. + +3. Desplácese hasta el directorio donde pusiste la fuente descargada anteriormente, utilizando un unix como terminal: Terminal.app Cygwin, Bash, etc.. + +4. Crear un nuevo proyecto, como se describe en las herramientas de lÃnea de comandos de BlackBerry. Necesitas los activos de este nuevo proyecto. + +5. Copia el `www/cordova-2.7.0.js` archivo del nuevo proyecto en tu `www` Directorio y eliminar su `www/cordova-2.6.0.js` archivo. + +6. Actualizar la referencia de script Cordova en su `www/index.html` archivo (y otros archivos que contienen la referencia de comandos) para que apunte a la nueva `cordova-2.7.0.js` archivo. + +7. Copia el `native` directorio desde el nuevo proyecto en el proyecto existente, sobrescribiendo el viejo `native` Directorio. + +8. Copia el `lib` directorio desde el nuevo proyecto en el proyecto existente, sobrescribiendo el viejo `lib` Directorio. + +9. Copia el `cordova` directorio desde el nuevo proyecto en el proyecto existente, sobrescribiendo el viejo `cordova` Directorio. + +## Actualizar a 2.6.0 desde 2.5.0 + +Actualizar el directorio de descarga PhoneGap: + +Se recomienda que usted descargar una copia nueva de todo el directorio. + +Sin embargo, aquà están las nuevas piezas necesarias para la actualización gradual: + +1. Actualizar el archivo cordova.blackberry.js en la `Phonegap-2.6.0/lib/blackberry/javascript` Directorio. + +2. Actualización de la `ext` , `ext-air` , y `ext-qnx` en el `Phonegap-2.6.0/lib/blackberry/framework` Directorio. + +3. Actualización de la `build.xml` de los archivos en el `Phonegap-2.6.0/lib/blackberry` Directorio. + +4. Actualización del `Phonegap-2.6.0/lib/blackberry/bin` Directorio. + +5. Actualización de la `VERSION` de los archivos en el `Phonegap-2.6.0/lib/blackberry` Directorio. + +Actualizando el ejemplo / proyecto de directorio o migrar existente: + +1. Abre tu `www/` Directorio, que contiene su aplicación. + +2. Quitar y actualizar el archivo .jar en la `ext/` Directorio. + +3. Actualizar el contenido de la `ext-air/` Directorio. + +4. Actualizar el contenido de la `ext-qnx/` Directorio. + +5. Copie el nuevo `cordova-2.6.0.js` en su proyecto. + +6. Actualizar el código HTML para usar el nuevo `cordova-2.6.0.js` archivo. + +## Actualizar a 2.5.0 desde 2.4.0 + +Actualizar el directorio de descarga PhoneGap: + +Se recomienda que usted descargar una copia nueva de todo el directorio. + +Sin embargo, aquà están las nuevas piezas necesarias para la actualización gradual: + +1. Actualizar el archivo cordova.blackberry.js en la `Phonegap-2.5.0/lib/blackberry/javascript` Directorio. + +2. Actualización de la `ext` , `ext-air` , y `ext-qnx` en el `Phonegap-2.5.0/lib/blackberry/framework` Directorio. + +3. Actualización de la `build.xml` de los archivos en el `Phonegap-2.5.0/lib/blackberry` Directorio. + +4. Actualización del `Phonegap-2.5.0/lib/blackberry/bin` Directorio. + +5. Actualización de la `VERSION` de los archivos en el `Phonegap-2.5.0/lib/blackberry` Directorio. + +Actualizando el ejemplo / proyecto de directorio o migrar existente: + +1. Abre tu `www/` Directorio, que contiene su aplicación. + +2. Quitar y actualizar el archivo .jar en la `ext/` Directorio. + +3. Actualizar el contenido de la `ext-air/` Directorio. + +4. Actualizar el contenido de la `ext-qnx/` Directorio. + +5. Copie el nuevo `cordova-2.5.0.js` en su proyecto. + +6. Actualizar el código HTML para usar el nuevo `cordova-2.5.0.js` archivo. + +## Actualizar a 2.4.0 desde 2.3.0 + +Actualizar el `www` Directorio: + +1. Abre tu `www/` Directorio, que contiene su aplicación. + +2. Quitar y actualizar el archivo .jar en la `ext/` Directorio. + +3. Actualizar el contenido de la `ext-air/` Directorio. + +4. Copie el nuevo `cordova-2.4.0.js` en su proyecto. + + * Si el libro de jugadas, luego actualizar el .js archivo en el `playbook/` Directorio. + * Si BlackBerry 10, luego actualizar el archivo .js en el `qnx/` Directorio. + +5. Actualizar el código HTML para usar el nuevo `cordova-2.4.0.js` archivo. + +Actualizar el directorio de muestra (es decir, actualización usando las herramientas de hormiga): + +1. Abierta la `sample/lib/` Directorio. + +2. Actualizar el archivo .jar en la `cordova.2.3.0/ext/` Directorio. + +3. Actualizar el contenido de la `cordova.2.3.0/ext-air/` Directorio. + +4. Actualizar el contenido de la `cordova.2.3.0/ext-qnx/` Directorio. + +5. Actualizar el archivo .js en el `cordova.2.3.0/javascript/` Directorio. + +6. Abierta la `sample/lib/` Directorio y renombrar el `cordova.2.3.0/` Directorio`cordova.2.4.0/`. + +7. Tipo `ant blackberry build` o `ant playbook build` para actualizar el `www/` Directorio con Cordova actualizado. + +8. Abierta la `www/` Directorio y actualizar el código HTML para usar el nuevo `cordova-2.4.0.js` archivo. + +## Actualizar a 2.3.0 desde 2.2.0 + +Actualizar el `www` Directorio: + +1. Abre tu `www/` Directorio, que contiene su aplicación. + +2. Quitar y actualizar el archivo .jar en la `ext/` Directorio. + +3. Actualizar el contenido de la `ext-air/` Directorio. + +4. Copie el nuevo `cordova-2.3.0.js` en su proyecto. + + * Si el libro de jugadas, luego actualizar el .js archivo en el `playbook/` Directorio. + * Si BlackBerry 10, luego actualizar el archivo .js en el `qnx/` Directorio. + +5. Actualizar el código HTML para usar el nuevo `cordova-2.3.0.js` archivo. + +Actualizar el directorio de muestra (es decir, actualización usando las herramientas de hormiga): + +1. Abierta la `sample/lib/` Directorio. + +2. Actualizar el archivo .jar en la `cordova.2.2.0/ext/` Directorio. + +3. Actualizar el contenido de la `cordova.2.2.0/ext-air/` Directorio. + +4. Actualizar el contenido de la `cordova.2.2.0/ext-qnx/` Directorio. + +5. Actualizar el archivo .js en el `cordova.2.2.0/javascript/` Directorio. + +6. Abierta la `sample/lib/` Directorio y renombrar el `cordova.2.2.0/` Directorio`cordova.2.3.0/`. + +7. Tipo `ant blackberry build` o `ant playbook build` para actualizar el `www/` Directorio con Cordova actualizado. + +8. Abierta la `www/` Directorio y actualizar el código HTML para usar el nuevo `cordova-2.3.0.js` archivo. + +## Actualizar a 2.2.0 desde 2.1.0 + +Actualizar sólo el directorio www: + +1. Abre tu `www/` Directorio, que contiene su aplicación. + +2. Quitar y actualizar el archivo .jar en la `ext/` Directorio. + +3. Actualizar el contenido de la `ext-air/` Directorio. + +4. Copie el nuevo `cordova-2.2.0.js` en su proyecto. + + * Si el libro de jugadas, luego actualizar el .js archivo en el `playbook/` Directorio. + * Si BlackBerry 10, luego actualizar el archivo .js en el `qnx/` Directorio. + +5. Actualizar el código HTML para usar el nuevo `cordova-2.2.0.js` archivo. + +Actualizar el directorio de muestra (es decir, actualización usando las herramientas de hormiga): + +1. Abierta la `sample/lib/` Directorio. + +2. Actualizar el archivo .jar en la `cordova.2.1.0/ext/` Directorio. + +3. Actualizar el contenido de la `cordova.2.1.0/ext-air/` Directorio. + +4. Actualizar el contenido de la `cordova.2.1.0/ext-qnx/` Directorio. + +5. Actualizar el archivo .js en el `cordova.2.1.0/javascript/` Directorio. + +6. Abierta la `sample/lib/` Directorio y renombrar el `cordova.2.1.0/` Directorio`cordova.2.2.0/`. + +7. Tipo `ant blackberry build` o `ant playbook build` para actualizar el `www/` Directorio con Cordova actualizado. + +8. Abierta la `www/` Directorio y actualizar el código HTML para usar el nuevo `cordova-2.2.0.js` archivo. + +## Actualizar a 2.1.0 desde 2.0.0 + +Actualizar el `www` Directorio: + +1. Abre tu `www/` Directorio, que contiene su aplicación. + +2. Quitar y actualizar el archivo .jar en la `ext/` Directorio. + +3. Actualizar el contenido de la `ext-air/` Directorio. + +4. Copie el nuevo `cordova-2.1.0.js` en su proyecto. + + * Si el libro de jugadas, luego actualizar el .js archivo en el `playbook/` Directorio. + +5. Actualizar el código HTML para usar el nuevo `cordova-2.1.0.js` archivo. + +Actualizar el directorio de muestra (es decir, actualización usando las herramientas de hormiga): + +1. Abierta la `sample/lib/` Directorio. + +2. Actualizar el archivo .jar en la `cordova.2.0.0/ext/` Directorio. + +3. Actualizar el contenido de la `cordova.2.0.0/ext-air/` Directorio. + +4. Actualizar el archivo .js en el `cordova.2.0.0/javascript/` Directorio. + +5. Abierta la `sample/lib/` Directorio y renombrar el `cordova.2.0.0/` Directorio`cordova.2.1.0/`. + +6. Tipo `ant blackberry build` o `ant playbook build` para actualizar el `www/` Directorio con Cordova actualizado. + +7. Abierta la `www/` Directorio y actualizar el código HTML para usar el nuevo `cordova-2.1.0.js` archivo. + +## Actualizar a 2.0.0 desde 1.9.0 + +Actualizar el `www` Directorio: + +1. Abre tu `www/` Directorio, que contiene su aplicación. + +2. Quitar y actualizar el archivo .jar en la `ext/` Directorio. + +3. Actualizar el contenido de la `ext-air/` Directorio. + +4. Copie el nuevo `cordova-2.0.0.js` en su proyecto. + + * Si el libro de jugadas, luego actualizar el .js archivo en el `playbook/` Directorio. + +5. Actualizar el código HTML para usar el nuevo `cordova-2.0.0.js` archivo. + +6. Actualizar su `www/plugins.xml` archivo. Dos plugins cambió su etiqueta de servicio de nombres. Cambiar las entradas viejas para los plugins de captura y contacto: + + < nombre del plugin = "Capturar" value="org.apache.cordova.media.MediaCapture"/ >< nombre del plugin = "Contacto" value="org.apache.cordova.pim.Contact"/ > + + Para: + + < nombre del plugin = "Capturar" value="org.apache.cordova.capture.MediaCapture"/ >< nombre del plugin "Contactos" value="org.apache.cordova.pim.Contact"/ = > + + +Actualizar el directorio de muestra (es decir, actualización usando las herramientas de hormiga): + +1. Abierta la `sample/lib/` Directorio. + +2. Actualizar el archivo .jar en la `cordova.1.9.0/ext/` Directorio. + +3. Actualizar el contenido de la `cordova.1.9.0/ext-air/` Directorio. + +4. Actualizar el archivo .js en el `cordova.1.9.0/javascript/` Directorio. + +5. Abierta la `sample/lib/` Directorio y renombrar el `cordova.1.9.0/` Directorio`cordova.2.0.0/`. + +6. Tipo `ant blackberry build` o `ant playbook build` para actualizar el `www/` Directorio con Cordova actualizado. + +7. Abierta la `www/` Directorio y actualizar el código HTML para usar el nuevo `cordova-2.0.0.js` archivo. + +8. Abierta la `www/` Directorio y actualizar el `plugins.xml` archivo. Dos plugins cambió su etiqueta de servicio de nombres. Cambiar las entradas viejas para los plugins de captura y contacto: + + <plugin name="Capture" value="org.apache.cordova.media.MediaCapture"/> + <plugin name="Contact" value="org.apache.cordova.pim.Contact"/> + + Para: + + <plugin name="Capture" value="org.apache.cordova.capture.MediaCapture"/> + <plugin name="Contacts" value="org.apache.cordova.pim.Contact"/> + + +* Para actualizar a 1.8.0, por favor vaya de 1.7.0 + +## Actualizar a 1.8.0 de 1.7.0 + +Actualizar el `www` Directorio: + +1. Abre tu `www/` Directorio, que contiene su aplicación. + +2. Quitar y actualizar el archivo .jar en la `ext/` Directorio. + +3. Actualizar el contenido de la `ext-air/` Directorio. + +4. Copie el nuevo `cordova-1.8.0.js` en su proyecto. + + * Si el libro de jugadas, luego actualizar el .js archivo en el `playbook/` Directorio. + +5. Actualizar el código HTML para usar el nuevo `cordova-1.8.0.js` archivo. + +6. Actualizar su `www/plugins.xml` archivo. Dos plugins cambió su etiqueta de servicio de nombres. Cambiar las entradas viejas para los plugins de captura y contacto: + + < nombre del plugin = "Capturar" value="org.apache.cordova.media.MediaCapture"/ >< nombre del plugin = "Contacto" value="org.apache.cordova.pim.Contact"/ > + + Para: + + < nombre del plugin = "Capturar" value="org.apache.cordova.capture.MediaCapture"/ >< nombre del plugin "Contactos" value="org.apache.cordova.pim.Contact"/ = > + + +Actualizar el directorio de muestra (es decir, actualización usando las herramientas de hormiga): + +1. Abierta la `sample/lib/` Directorio. + +2. Actualizar el archivo .jar en la `cordova.1.7.0/ext/` Directorio. + +3. Actualizar el contenido de la `cordova.1.7.0/ext-air/` Directorio. + +4. Actualizar el archivo .js en el `cordova.1.7.0/javascript/` Directorio. + +5. Abierta la `sample/lib/` Directorio y renombrar el `cordova.1.7.0/` Directorio`cordova.1.8.0/`. + +6. Tipo `ant blackberry build` o `ant playbook build` para actualizar el `www/` Directorio con Cordova actualizado. + +7. Abierta la `www/` Directorio y actualizar el código HTML para usar el nuevo `cordova-1.8.0.js` archivo. + +8. Abierta la `www/` Directorio y actualizar el `plugins.xml` archivo. Dos plugins cambió su etiqueta de servicio de nombres. Cambiar las entradas viejas para los plugins de captura y contacto: + + <plugin name="Capture" value="org.apache.cordova.media.MediaCapture"/> + <plugin name="Contact" value="org.apache.cordova.pim.Contact"/> + + Para: + + <plugin name="Capture" value="org.apache.cordova.capture.MediaCapture"/> + <plugin name="Contacts" value="org.apache.cordova.pim.Contact"/> \ No newline at end of file http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/f061b980/www/docs/es/dev/guide/platforms/firefoxos/config.md ---------------------------------------------------------------------- diff --git a/www/docs/es/dev/guide/platforms/firefoxos/config.md b/www/docs/es/dev/guide/platforms/firefoxos/config.md new file mode 100644 index 0000000..2ede80d --- /dev/null +++ b/www/docs/es/dev/guide/platforms/firefoxos/config.md @@ -0,0 +1,23 @@ +--- +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 FirefoxOS +--- + +# Configuración de FirefoxOS \ No newline at end of file http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/f061b980/www/docs/es/dev/guide/platforms/firefoxos/index.md ---------------------------------------------------------------------- diff --git a/www/docs/es/dev/guide/platforms/firefoxos/index.md b/www/docs/es/dev/guide/platforms/firefoxos/index.md new file mode 100644 index 0000000..1abd596 --- /dev/null +++ b/www/docs/es/dev/guide/platforms/firefoxos/index.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: Firefox OS Platform Guide +--- + +# Firefox OS Platform Guide + +Esta guÃa describe cómo configurar el entorno de desarrollo para crear Cordova aplicaciones para dispositivos de Firefox OS, entonces probar y publicar las aplicaciones. + +## Requisitos y apoyo + +Firefox las apps son básicamente sólo aplicaciones web, con la adición de un archivo manifest.webapp que define metadatos acerca de la aplicación y le permite ser instalado en dispositivos Firefox OS. Puede utilizarse cualquier plataforma que soporta Cordova.Para averiguar más sobre la construcción de aplicaciones web, consulte la [App Center][1] en [MDN][2]. + + [1]: https://developer.mozilla.org/en-US/Apps + [2]: https://developer.mozilla.org/en-US/ + +## Instalación y configuración del entorno + +Primero instale [Node.js][3], luego instale el paquete Cordova asÃ: + + [3]: http://nodejs.org/ + + $ npm install -g cordova + + +A continuación, crear una aplicación de muestra Cordova luego navegar al directorio recién creado: + + $ cordova create test-app + $ cd test-app + + +Añadir Firefox OS como plataforma de apoyada a la aplicación con las siguientes: + + $ cordova platform add firefoxos + + +Esto crea una aplicación de Firefox OS en directorio de plataformas/firefoxos/www, que actualmente es la misma excepto que tiene un archivo de manifiesto de Firefox (manifest.webapp) dentro del directorio de www. + +## Desarrollo de su aplicación + +En este momento usted está listo para ir â cambiar el código dentro de prueba-app/www para lo que quieras tu app para ser. Puede agregar [plugins de apoyo]() a la aplicación usando "cordova plugin añade", por ejemplo: + + cordova plugin add cordova-plugin-device + cordova plugin add cordova-plugin-vibration + + +Cuando se escribe el código de la aplicación, implementar los cambios en la aplicación de Firefox OS con que ha agregado a su proyecto + + $ cordova prepare firefoxos + + +Para crear una aplicación empaquetada uno puede postal el directorio plataformas/firefoxos/www. Usted puede también simplemente construir usando + + $ cordova build firefoxos + + +La aplicación empaquetada Firefox OS será construida en platforms/firefoxos/build/package.zip + +## Pruebas y depuración + +La aplicación puede ser probada usando el Firefox OS [Web IDE][4]. + + [4]: https://developer.mozilla.org/en-US/docs/Tools/WebIDE + +Cuando conecte el IDE de Web a tu dispositivo/simulador de prueba, seleccione la opción "Open App empaquetados", y asegúrese de que usted señala a la prueba-app/plataformas/firefoxos/www/directorio para incluir la aplicación en la interfaz del administrador. + +Aquà usted puede instalar la aplicación en tu dispositivo/simulador de prueba (con el botón "Play"). Usando la "pausa" botón puede depurar la aplicación y modificar su código en vivo. + +Nota: Antes de intentar publicar su aplicación debe considerar validarlo utilizando el [validador App][5]. + + [5]: https://marketplace.firefox.com/developers/validator + +## Publican su aplicación en el mercado de Firefox + +Puede enviar su aplicación al mercado de Firefox, o publicarlo mismo. Visite la [Zona de mercado de Firefox][6] en MDN para averiguar más acerca de cómo hacer esto; [Opciones de publicación de la aplicación][7] es el mejor lugar para empezar. + + [6]: https://developer.mozilla.org/en-US/Marketplace + [7]: https://developer.mozilla.org/en-US/Marketplace/Publishing/Publish_options \ No newline at end of file http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/f061b980/www/docs/es/dev/guide/platforms/index.md ---------------------------------------------------------------------- diff --git a/www/docs/es/dev/guide/platforms/index.md b/www/docs/es/dev/guide/platforms/index.md new file mode 100644 index 0000000..4c3fbea --- /dev/null +++ b/www/docs/es/dev/guide/platforms/index.md @@ -0,0 +1,87 @@ +--- +license: > + Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +title: GuÃas de plataformas +--- + +# GuÃas de plataformas + +Antes de desarrollar para cualquiera de las plataformas que se enumeran a continuación, instalar la interfaz de lÃnea de comandos de cordova (CLI). (Para más detalles, ver la interfaz de lÃnea de comandos). + +Para desarrollar aplicaciones de Cordova, debe instalar los SDK para cada plataforma móvil que usted está apuntando. Esta instalación es necesaria independientemente de los hacen la mayorÃa de su trabajo en el SDK o utiliza la CLI para su ciclo de construir. + +Cada *Plataforma guÃa* a continuación te dice lo que necesitas saber para configurar el entorno de desarrollo de cada plataforma: dónde obtener el SDK, cómo configurar emuladores de dispositivo, cómo conectar dispositivos para pruebas directas y cómo administrar los requerimientos claves de firma. [GuÃas](../../index.html) adicionales proporcionan información sobre el conjunto único de cada plataforma de opciones de configuración, instrucciones para agregar plugins, cómo actualizar cada plataforma y herramientas de lÃnea de comandos especÃficos a la plataforma que sirven como una alternativa de nivel inferior a la utilidad de lÃnea de comandos de `cordova`. + +## Amazon fire OS + +* [Amazon fuego OS Platform Guide](amazonfireos/index.html) +* [Amazon fuego OS configuración](amazonfireos/config.html) +* [Amazon fuego OS WebViews](amazonfireos/webview.html) +* [Amazon fuego OS Plugins](amazonfireos/plugin.html) + +## Android + +* [GuÃa de la plataforma Android](android/index.html) +* [GuÃa de herramientas de Shell Android](android/tools.html) +* [Configuración de Android](android/config.html) +* [Android Plugins](android/plugin.html) +* [Android WebViews](android/webview.html) +* [Actualizar Android](android/upgrading.html) + +## BlackBerry 10 + +* [GuÃa de la plataforma BlackBerry 10](blackberry10/index.html) +* [BlackBerry 10 GuÃa de herramientas de Shell](blackberry10/tools.html) +* [Configuración de BlackBerry 10](blackberry10/config.html) +* [BlackBerry 10 Plugins](blackberry10/plugin.html) +* [Actualizar BlackBerry](blackberry/upgrading.html) 10 + +## Firefox OS + +* [Firefox OS Platform Guide](firefoxos/index.html) + +## iOS + +* [iOS Platform Guide](ios/index.html) +* [iOS GuÃa de herramientas de Shell](ios/tools.html) +* [iOS configuración](ios/config.html) +* [iOS Plugins](ios/plugin.html) +* [iOS WebViews](ios/webview.html) +* [Actualizar iOS](ios/upgrading.html) + +## Ubuntu + +* [GuÃa de la plataforma de Ubuntu](ubuntu/index.html) + +## Windows Phone 8 + +* [GuÃa de la plataforma de Windows Phone 8](wp8/index.html) +* [Windows Phone 8 Plugins](wp8/plugin.html) +* [Actualización de Windows Phone 8](wp8/upgrade.html) + +## Windows + +* [GuÃa de la plataforma Windows](win8/index.html) +* [Windows Plugins](win8/plugin.html) +* [Empaquetado de Windows](win8/packaging.html) +* [Actualización de Windows 8](win8/upgrading.html) + +## Tizen + +* [GuÃa de la plataforma Tizen](tizen/index.html) \ No newline at end of file http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/f061b980/www/docs/es/dev/guide/platforms/ios/config.md ---------------------------------------------------------------------- diff --git a/www/docs/es/dev/guide/platforms/ios/config.md b/www/docs/es/dev/guide/platforms/ios/config.md new file mode 100644 index 0000000..2429a97 --- /dev/null +++ b/www/docs/es/dev/guide/platforms/ios/config.md @@ -0,0 +1,111 @@ +--- +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: iOS configuración +--- + +# iOS 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. Esta sección detalla las preferencias que se aplican sólo a estructuras de iOS. 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 + +* `EnableViewportScale`(por defecto es booleano, `false` ): A `true` para permitir una etiqueta meta viewport a deshabilitar o restringir el intervalo de usuario escalamiento, que está habilitada de forma predeterminada. + + <preference name="EnableViewportScale" value="true"/> + + + Colocar una ventana como la siguiente en el código HTML para desactivar la escala y el ajuste contenido fexiblemente dentro de la representación WebView: + + <meta name='viewport' content='width=device-width, initial-scale=1, user-scalable=no' /> + + +* `MediaPlaybackAllowsAirPlay`(booleano, por defecto `true` ): A `false` para evitar que aire jugar siendo utilizado en este punto de vista. Disponible en defecto UIWebView y WKWebView. + + <preference name="MediaPlaybackAllowsAirPlay" value="false"/> + + +* `MediaPlaybackRequiresUserAction`(booleano, por defecto `false` ): A `true` para evitar que HTML5 videos o audios de jugar automáticamente con el `autoplay` atributo o a través de JavaScript. + + <preference name="MediaPlaybackRequiresUserAction" value="true"/> + + +* `AllowInlineMediaPlayback`(booleano, por defecto `false` ): para `true` para permitir la reproducción de multimedia de HTML5 aparecer *en lÃnea* en el diseño de la pantalla, usando controles suministrados por el navegador en lugar de controles nativos. Para que ello, agregue el `webkit-playsinline` atributo para cualquier `<video>` elementos. + + <preference name="AllowInlineMediaPlayback" value="true"/> + + +* `BackupWebStorage`(cadena, ya sea `none` , `local` , o el valor por defecto `cloud` ): para `cloud` para permitir que los datos de almacenamiento web para copia de seguridad mediante iCloud. A `local` a permiten solamente locales backups mediante iTunes sync. Para `none` prevenir backups de almacenamiento web. + + <preference name="BackupWebStorage" value="local"/> + + +* `TopActivityIndicator`(cadena, por defecto es `gray` ): controla la apariencia del icono pequeño giro en la barra de estado que indica actividad de procesador significativo. Los valores válidos son `whiteLarge` , `white` , y`gray`. + + <preference name="TopActivityIndicator" value="white"/> + + +* `KeyboardDisplayRequiresUserAction`(booleano, por defecto `true` ): para `false` para permitir que el teclado aparezca cuando se llama a `focus()` en las entradas del formulario. + + <preference name="KeyboardDisplayRequiresUserAction" value="false"/> + + +* `SuppressesIncrementalRendering`(booleano, por defecto `false` ): A `true` que esperar hasta que todo el contenido ha sido recibido antes de que presta a la pantalla. + + <preference name="SuppressesIncrementalRendering" value="true"/> + + +* `GapBetweenPages`(flotador, por defecto es `` ): el tamaño de la brecha, en puntos, entre las páginas. + + <preference name="GapBetweenPages" value="0"/> + + +* `PageLength`(flotador, por defecto es `` ): el tamaño de cada página, en puntos, en la dirección en que fluyen las páginas. Cuando PaginationMode es derecha a izquierda o de izquierda a derecha, esta propiedad representa el ancho de cada página. Cuando PaginationMode es topToBottom o bottomToTop, esta propiedad representa la altura de cada página. El valor predeterminado es 0, lo que significa que el diseño utiliza el tamaño de la ventanilla para determinar las dimensiones de la página. + + <preference name="PageLength" value="0"/> + + +* `PaginationBreakingMode`(cadena, por defecto es `page` ): los valores válidos son `page` y `column` . La manera en que se produzca fractura de columna o página. Esta propiedad determina si ciertas propiedades CSS sobre columna y página romper son honrados o ignorados. Cuando esta propiedad está establecida `column` , el contenido respeta las propiedades CSS relacionadas con fractura de columna en lugar de la página-última hora. + + <preference name="PaginationBreakingMode" value="page"/> + + +* `PaginationMode`(cadena, por defecto es `unpaginated` ): los valores válidos son `unpaginated` , `leftToRight` , `topToBottom` , `bottomToTop` , y `rightToLeft` . Esta propiedad determina si contenido en la vista web se divide en páginas que llenan la pantalla de una vista a la vez, o se muestra como un largo desplazamiento. Si establece en forma paginada, esta propiedad cambia un esquema paginado en el contenido, haciendo que la vista de web para utilizar los valores de PageLength y GapBetweenPages a cachés su contenido. + + <preference name="PaginationMode" value="unpaginated"/> + + +* `UIWebViewDecelerationSpeed`(cadena, por defecto es `normal` ): los valores válidos son `normal` , `fast` . Esta propiedad controla la velocidad de desaceleración del impulso de desplazamiento. `normal`es la velocidad por defecto de aplicaciones nativas más, y `fast` es el valor por defecto de Safari Mobile. + + <preference name="UIWebViewDecelerationSpeed" value="fast" /> + + +* `ErrorUrl`(string, no establece de forma predeterminada): Si establece, se visualizará la página local que se hace referencia a un error en la aplicación. + + <preference name="ErrorUrl" value="myErrorPage.html"/> + + +* `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/f061b980/www/docs/es/dev/guide/platforms/ios/index.md ---------------------------------------------------------------------- diff --git a/www/docs/es/dev/guide/platforms/ios/index.md b/www/docs/es/dev/guide/platforms/ios/index.md new file mode 100644 index 0000000..f18bf58 --- /dev/null +++ b/www/docs/es/dev/guide/platforms/ios/index.md @@ -0,0 +1,218 @@ +--- +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: iOS Platform Guide +--- + +# iOS Platform Guide + +Esta guÃa le muestra cómo configurar el entorno de desarrollo SDK para desplegar aplicaciones Cordova para dispositivos iOS como el iPhone y iPad. Vea el siguiente para obtener más información especÃfica de la plataforma: + +* [iOS configuración](config.html) +* [Actualizar iOS](upgrading.html) +* [iOS WebViews](webview.html) +* [iOS Plugins](plugin.html) +* iOS Shell herramienta guÃa + +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 para obtener información sobre la interfaz actual. + +## Requisitos y apoyo + +Apple ® herramientas necesarias para crear aplicaciones de iOS ejecutar sólo en el sistema operativo OS X Macs basados en Intel. Xcode ® 6.0 (la versión mÃnima requerida) se ejecuta en OS X versión 10.9 (Mavericks) o mayor e incluye el iOS 8 SDK (Software Development Kit). Presentar aplicaciones para el Apple App Storeâ requiere las últimas versiones de las herramientas de Apple. + +Muchas de las caracterÃsticas de Cordova usando el emulador de iOS instalado con el iOS SDK y Xcode puede probar, pero necesitas un dispositivo real para completamente todas las caracterÃsticas de la aplicación dispositivo de prueba antes de presentar a la App Store. El dispositivo debe tener por lo menos iOS 6.x instalado, la versión de iOS mÃnimo apoyado desde Cordova 3.0. Dispositivos de apoyo incluyen todos iPad ® modelos, iPhone ® 3GS y arriba y iPod ® Touch de 3ª generación o posterior. Para instalar aplicaciones en un dispositivo, también debe ser un miembro de Apple [iOS Developer Program][1], que cuesta $99 por año. Esta guÃa le muestra cómo implementar aplicaciones para el emulador de iOS, para lo cual no debes registrarte con el programa de desarrolladores. + + [1]: https://developer.apple.com/programs/ios/ + +Las herramientas [ios-sim][2] y [ios-deploy][3] - le permiten lanzar aplicaciones iOS en el simulador de iOS y dispositivo iOS desde la lÃnea de comandos. + + [2]: https://www.npmjs.org/package/ios-sim + [3]: https://www.npmjs.org/package/ios-deploy + +## Instalar el SDK + +Hay dos maneras de descargar Xcode: + +* desde la [App Store][4], disponible mediante la búsqueda de "Xcode" en la aplicación de **La App Store**. + +* de [Descargas de desarrollador de Apple][5], que requiere el registro como desarrollador de Apple. + + [4]: https://itunes.apple.com/us/app/xcode/id497799835?mt=12 + [5]: https://developer.apple.com/downloads/index.action + +Una vez instalado Xcode, varias herramientas de lÃnea de comandos necesitan estar habilitada para que Córdoba ejecutar. En el menú de **Xcode** , seleccione **preferencias**y luego la pestaña **descargas** . Desde el panel **componentes** , pulse el botón **instalar** junto a la lista de **Herramientas de lÃnea de comandos** . + +## Instalar implementar herramientas + +Ejecutar desde la terminal de lÃnea de comandos: + + $ npm install -g ios-sim + $ npm install -g ios-deploy + + +## Cree un nuevo proyecto + +La utilidad `cordova` para configurar un nuevo proyecto, tal como se describe en la Cordova del interfaz de comandos. Por ejemplo, en un directorio del código fuente: + + $ cordova create hello com.example.hello "HelloWorld" + $ cd hello + $ cordova platform add ios + $ cordova prepare # or "cordova build" + + +## Desplegar la aplicación + +Para desplegar la aplicación en un dispositivo iOS conectado: + + $ cordova run ios --device + + +Para desplegar la aplicación en un emulador de iOS por defecto: + + $ cordova emulate ios + + +Puede usar **cordova run ios --list** para ver todos los destinos disponibles y **cordova run ios --target=target_name** para ejecutar la aplicación en un dispositivo especÃfico o un emulador (por ejemplo, `cordova run ios --target="iPhone-6"`). + +También puede utilizar **cordova ejecutar--ayuda** adicional construir y ejecutar opciones. + +## Abrir un proyecto en el SDK + +Una vez que la plataforma ios es añadido a su proyecto, puede abrir desde dentro de Xcode. Haga doble clic para abrir el archivo `hello/platforms/ios/hello.xcodeproj` . La pantalla debe verse asÃ: + +![][6] + + [6]: {{ site.baseurl }}/static/img/guide/platforms/ios/helloworld_project.png + +## Desplegar en emulador + +Para previsualizar la aplicación en el emulador de iOS: + +1. Asegúrese de que el archivo *.xcodeproj* es seleccionado en el panel izquierdo. + +2. Seleccione la aplicación **hello** en el panel inmediatamente a la derecha. + +3. Seleccione el dispositivo deseado desde el menú de la barra de herramientas **Scheme**, como el iPhone Simulator 6.0 como destacado aquÃ: + + ![][7] + +4. Presione el botón **Run** que aparece en la misma barra de herramientas a la izquierda del **Scheme**. Construye, implementa y ejecuta la aplicación en el emulador. Una aplicación separada emulador se abre para mostrar la aplicación: + + ![][8] + + Sólo un emulador puede ejecutar al mismo tiempo, asà que si quieres probar la aplicación en un emulador diferente, tienes que dejar la aplicación del emulador y llevar un objetivo diferente dentro de Xcode. + + [7]: {{ site.baseurl }}/static/img/guide/platforms/ios/select_xcode_scheme.png + [8]: {{ site.baseurl }}/static/img/guide/platforms/ios/HelloWorldStandard.png + +Xcode viene liado con emuladores para las últimas versiones de iPhone y iPad. Las versiones más antiguas pueden estar disponibles en el **Xcode â preferencias â descargas â componentes** panel. + +## Desplegar en el dispositivo + +Para obtener más información acerca de varios requisitos para implementar en un dispositivo, consulte la sección de *Lanzar su aplicación en dispositivos* de Apple [Sobre aplicación de distribución de los flujos de trabajo][9]. Brevemente, necesitas hacer lo siguiente antes de implementar: + + [9]: https://developer.apple.com/library/prerelease/ios/documentation/IDEs/Conceptual/AppDistributionGuide/Introduction/Introduction.html + +1. Ãnete a la Apple iOS Developer Program. + +2. Crear un *Perfil de Provisioning* dentro del [iOS Provisioning Portal][10]. Puede utilizar su *Asistente de Provisioning de desarrollo* para crear e instalar el perfil y requiere certificado Xcode. + +3. Verificar que de la sección *Firma de código* *Identidad de firma de código* dentro de la configuración del proyecto se establece en su aprovisionamiento nombre de perfil. + + [10]: https://developer.apple.com/ios/manage/overview/index.action + +Para desplegar en el dispositivo: + +1. Utilice el cable USB para enchufar el dispositivo en tu Mac. + +2. Seleccione el nombre del proyecto en la lista desplegable de la ventana Xcode **Scheme**. + +3. Seleccione su dispositivo de la lista desplegable de **dispositivos**. Si está conectado vÃa USB, pero aún no aparece, pulse el botón **organizador** para resolver los errores. + +4. Presione el botón **Run** para construir, implementar y ejecutar la aplicación en tu dispositivo. + +## Problemas comunes + +**Descarte las advertencias**: cuando una aplicación es modificada o sustituida por otra API interfaz de programación (API), que está marcado como *obsoleto*. La API todavÃa funciona en el corto plazo, pero eventualmente se retira. Algunas de estas interfaces obsoletas se reflejan en Apache Cordova y Xcode emite advertencias sobre ellos cuando construir y desplegar una aplicación. + +ADVERTENCIA de Xcode sobre el método `invokeString` refiere a una funcionalidad que lanza una app desde una dirección URL personalizada. Mientras que el mecanismo para cargar desde una dirección URL personalizada ha cambiado, este código todavÃa está presente para proporcionar la funcionalidad al revés para aplicaciones creadas con versiones anteriores de Córdoba. La aplicación muestra no utiliza esta funcionalidad, asà que estas advertencias pueden ser ignoradas. Para evitar que aparezcan estas advertencias, quitar el código que hace referencia a la invokeString obsoleta API: + +* Editar el archivo *Classes/MainViewController.m*, rodean el siguiente bloque de código con `/ *` y `* /` comentarios como se muestra a continuación, escriba el **Comando-s** para guardar el archivo: + + (void)webViewDidFinishLoad:(UIWebView*)theWebView + { + // only valid if ___PROJECTNAME__-Info.plist specifies a protocol to handle + /* + if (self.invokeString) { + // this is passed before the deviceready event is fired, so you can access it in js when you receive deviceready + NSLog(@"DEPRECATED: window.invokeString - use the window.handleOpenURL(url) function instead, which is always called when the app is launched through a custom scheme url."); + NSString* jsString = [NSString stringWithFormat:@"var invokeString = \"%@\";", self.invokeString]; + [theWebView stringByEvaluatingJavaScriptFromString:jsString]; + } + */ + // Black base color for background matches the native apps + theWebView.backgroundColor = [UIColor blackColor]; + + return [super webViewDidFinishLoad:theWebView]; + } + + +* Editar el archivo *Classes/AppViewDelegate.m*, comentar la siguiente lÃnea insertando una doble barra como se muestra abajo, a continuación, escriba el **comando + s** para guardar el archivo: + + //self.viewController.invokeString = invokeString; + + +* Pulsar **comando + b** para reconstruir el proyecto y eliminar las advertencias. + +<!-- Does this fix only last until the next "cordova prepare"? --> + +**Faltan encabezados**: errores de compilación relativos a cabeceras de faltantes el resultado de problemas con la ubicación de construir y puede estar fijados mediante Xcode preferencias: + +1. Seleccione **Xcode â preferencias â ubicaciones de**. + +2. En la sección de **Datos derivados**, pulse el botón **avanzado** y seleccione **único** como la **Ubicación de construir** como se muestra aquÃ: + + ![][11] + + [11]: {{ site.baseurl }}/static/img/guide/platforms/ios/xcode_build_location.png + +Esta es la configuración predeterminada para una instalación nueva de Xcode, pero se puede ajustar diferentemente después de una actualización de una versión anterior de Xcode. + +Para más información, consulte la documentación de Apple: + +* [IOS de empezar a desarrollar aplicaciones hoy][12] proporciona un rápido [Resumen](../../overview/index.html) de pasos para el desarrollo de iOS Apps. + +* [Miembro del centro Página][13] proporciona enlaces a varios iOS recursos técnicos incluyendo recursos técnicos, el portal provisioning, guÃas de distribución y foros de la comunidad. + +* [GuÃa de herramientas de flujo de trabajo para iOS][14] + +* [GuÃa del usuario de Xcode][15] + +* [Videos de sesiones][16] de la Apple World Wide Developer Conference 2012 (WWDC2012) + +* El [comando select-xcode][17], que ayuda a especificar la versión correcta de Xcode si más de uno está instalado. + + [12]: http://developer.apple.com/library/ios/#referencelibrary/GettingStarted/RoadMapiOS/index.html#//apple_ref/doc/uid/TP40011343 + [13]: https://developer.apple.com/membercenter/index.action + [14]: http://developer.apple.com/library/ios/#documentation/Xcode/Conceptual/ios_development_workflow/00-About_the_iOS_Application_Development_Workflow/introduction.html#//apple_ref/doc/uid/TP40007959 + [15]: http://developer.apple.com/library/ios/#documentation/ToolsLanguages/Conceptual/Xcode4UserGuide/000-About_Xcode/about.html#//apple_ref/doc/uid/TP40010215 + [16]: https://developer.apple.com/videos/wwdc/2012/ + [17]: http://developer.apple.com/library/mac/#documentation/Darwin/Reference/ManPages/man1/xcode-select.1.html + +(Mac ® OS X ®, Apple ®, Xcode, App Storeâ , iPad ®, iPhone ®, iPod ® y Finder ® son marcas registradas de Apple Inc.) http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/f061b980/www/docs/es/dev/guide/platforms/ios/plugin.md ---------------------------------------------------------------------- diff --git a/www/docs/es/dev/guide/platforms/ios/plugin.md b/www/docs/es/dev/guide/platforms/ios/plugin.md new file mode 100644 index 0000000..786a898 --- /dev/null +++ b/www/docs/es/dev/guide/platforms/ios/plugin.md @@ -0,0 +1,184 @@ +--- +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: iOS Plugins +--- + +# iOS Plugins + +Esta sección proporciona información detallada de cómo implementar el código del plugin nativo en la plataforma iOS. Antes de leer esto, vea aplicación Plugins para tener una visión general de la estructura del plugin y su interfaz común de JavaScript. Esta sección sigue demostrando el plugin *Eco* muestra que comunica desde la webview Cordova a la plataforma nativa y de regreso. + +Un plugin de iOS se implementa como una clase de Objective-C que se extiende la `CDVPlugin` clase. Para JavaScript `exec` del método `service` parámetro para asignar a un Objective-C, clase cada plugin debe estar registrado como un `<feature>` tag en del directorio la aplicación llamado `config.xml` archivo. + +## Asignación de clase plugin + +La porción de JavaScript de un plugin utiliza el `cordova.exec` método de la siguiente manera: + + exec(<successFunction>, <failFunction>, <service>, <action>, [<args>]); + + +Esto mariscales una solicitud de la `UIWebView` al lado nativo iOS, efectivamente llamando el `action` método de la `service` clase, con los argumentos pasados en la `args` matriz. + +Especificar el plugin como un `<feature>` etiqueta de proyecto de la aplicación Cordova-iOS `config.xml` archivo, usando el `plugin.xml` archivo para inyectar este marcado automáticamente, como se describe en aplicación Plugins: + + <feature name="LocalStorage"> + <param name="ios-package" value="CDVLocalStorage" /> + </feature> + + +De la caracterÃstica `name` atributo debe coincidir con lo que se especifica como el JavaScript `exec` llamada `service` parámetro. El `value` atributo debe coincidir con el nombre de clase de Objective-C del plugin. El `<param>` del elemento `name` siempre debe ser `ios-package` . Si usted no sigue estas pautas, el plugin puede compilar, pero Córdoba todavÃa no puede ser capaz de acceder a él. + +## Vida e inicialización de Plugin + +Para la vida de cada uno se crea una instancia de un objeto plugin `UIWebView` . Plugins normalmente se instancian cuando primero hace referencia a una llamada desde JavaScript. De lo contrario puede instanciarse mediante el establecimiento de un `param` llamado `onload` a `true` en el `config.xml` archivo: + + <feature name="Echo"> + <param name="ios-package" value="Echo" /> + <param name="onload" value="true" /> + </feature> + + +No hay *ningún* señalado a inicializador de plugins. Por el contrario, debe usar plugins el `pluginInitialize` método para su lógica de arranque. + +Actividad de fondo plugins con solicitudes de larga duración, tales como medios de reproducción, los oyentes o que mantener el estado interno debe implementar el `onReset` método para limpiar esas actividades. El método ejecuta cuando el `UIWebView` se desplaza a una nueva página o actualizaciones, que vuelve a cargar el JavaScript. + +## Escribir un iOS Cordova Plugin + +¿Una llamada JavaScript dispara una solicitud plugin nativo al lado, y el iOS correspondiente plugin Objective-C se asigna correctamente en el `config.xml` archivo, pero lo que le gusta el final iOS Objective-C plugin mirada de clase? Lo que es enviado al plugin de JavaScript `exec` función se pasa a la clase correspondiente plugin `action` método. Esta firma cuenta con un método de plugin: + + - (void)myMethod:(CDVInvokedUrlCommand*)command + { + CDVPluginResult* pluginResult = nil; + NSString* myarg = [command.arguments objectAtIndex:0]; + + if (myarg != nil) { + pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK]; + } else { + pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR messageAsString:@"Arg was null"]; + } + [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId]; + } + + +Para más detalles, ver `[CDVInvokedUrlCommand.h](https://github.com/apache/cordova-ios/blob/master/CordovaLib/Classes/CDVInvokedUrlCommand.h)` , `[CDVPluginResult.h](https://github.com/apache/cordova-ios/blob/master/CordovaLib/Classes/CDVPluginResult.h)` , y`[CDVCommandDelegate.h](https://github.com/apache/cordova-ios/blob/master/CordovaLib/Classes/CDVCommandDelegate.h)`. + +## iOS tipos de mensaje CDVPluginResult + +Puede utilizar `CDVPluginResult` para devolver una variedad de resultado tipos de vuelta a las devoluciones de llamadas de JavaScript, usando métodos de la clase que siguen este patrón: + + + (CDVPluginResult*)resultWithStatus:(CDVCommandStatus)statusOrdinal messageAs... + + +Puede crear `String`, `Int`, `Double`, `Bool`, `Array`, `Dictionary`, `ArrayBuffer` y `Multipart` tipos. Puede también dejar de lado ningún argumento para enviar un estatus, o devolver un error, o incluso optar por no enviar ningún resultado del plugin, en cuyo caso se despide ni devolución de llamada. + +Tenga en cuenta lo siguiente para valores complejos de retorno: + +* `messageAsArrayBuffer`Espera `NSData*` y se convierte en un `ArrayBuffer` en la devolución de llamada JavaScript. Asimismo, cualquier `ArrayBuffer` el JavaScript envÃa a un plugin se convierte en`NSData*`. + +* `messageAsMultipart`Espera un `NSArray*` que contengan cualquiera de las otras apoyado tipos y envÃa la matriz completa como el `arguments` a la devolución de llamada JavaScript. De esta manera, todos los argumentos son serializa o deserializa según sea necesario, asà que es seguro volver `NSData*` como varias partes, pero no como `Array` /`Dictionary`. + +## Eco iOS ejemplo Plugin + +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="ios"> + <config-file target="config.xml" parent="/*"> + <feature name="Echo"> + <param name="ios-package" value="Echo" /> + </feature> + </config-file> + </platform> + + +Entonces nos gustarÃa añadir lo siguiente `Echo.h` y `Echo.m` los archivos en el `Plugins` carpeta dentro del directorio de la aplicación de Cordova-iOS: + + /********* Echo.h Cordova Plugin Header *******/ + + #import <Cordova/CDV.h> + + @interface Echo : CDVPlugin + + - (void)echo:(CDVInvokedUrlCommand*)command; + + @end + + /********* Echo.m Cordova Plugin Implementation *******/ + + #import "Echo.h" + #import <Cordova/CDV.h> + + @implementation Echo + + - (void)echo:(CDVInvokedUrlCommand*)command + { + CDVPluginResult* pluginResult = nil; + NSString* echo = [command.arguments objectAtIndex:0]; + + if (echo != nil && [echo length] > 0) { + pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsString:echo]; + } else { + pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR]; + } + + [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId]; + } + + @end + + +Las importaciones necesarias en la parte superior del archivo amplÃa la clase de `CDVPlugin` . En este caso, el plugin sólo es compatible con un solo `echo` acción. Obtiene la cadena Eco llamando el `objectAtIndex` método de conseguir el primer parámetro de la `arguments` matriz, que corresponde a los argumentos pasaron en el JavaScript `exec()` función. + +Comprueba el parámetro para asegurarse de que no es `nil` o una cadena vacÃa, devolviendo un `PluginResult` con un `ERROR` estado si es asÃ. Si el parámetro pasa la cuenta, devuelve un `PluginResult` con un `OK` estado, generando asà en el original `echo` cadena. Por último, envÃa el resultado a `self.commandDelegate` , que ejecuta el `exec` callbacks de éxito o fracaso del método en el lado de JavaScript. Si se llama a la devolución de llamada de éxito, pasa en la `echo` parámetro. + +## iOS integración + +El `CDVPlugin` clase cuenta con otros métodos que puede invalidar su plugin. Por ejemplo, usted puede capturar el `[pause](../../../cordova/events/events.pause.html)` , `[resume](../../../cordova/events/events.resume.html)` , poner fin a la aplicación y `handleOpenURL` eventos. Vea la clase [CDVPlugin.h][1] y [CDVPlugin.m][2] para la dirección. + + [1]: https://github.com/apache/cordova-ios/blob/master/CordovaLib/Classes/CDVPlugin.h + [2]: https://github.com/apache/cordova-ios/blob/master/CordovaLib/Classes/CDVPlugin.m + +## Threading + +Plugin métodos normalmente se ejecutan en el mismo subproceso como la interfaz principal. Si tu plugin requiere una gran cantidad de procesamiento o requiere una llamada de bloquea, debe utilizar un subproceso de fondo. Por ejemplo: + + - (void)myPluginMethod:(CDVInvokedUrlCommand*)command + { + // Check command.arguments here. + [self.commandDelegate runInBackground:^{ + NSString* payload = nil; + // Some blocking logic... + CDVPluginResult* pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsString:payload]; + // The sendPluginResult method is thread-safe. + [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId]; + }]; + } + + +## Depuración de iOS Plugins + +Para depurar en el lado de Objective-C, necesitas a depurador incorporado de Xcode. Para JavaScript, en iOS 5.0 o superior puede utilizar [Weinre, un proyecto de Cordova Apache][3] o [iWebInspector, una utilidad de terceros][4]. Para iOS 8, puede adjuntar a la aplicación ejecuta dentro del iOS Simulator 8 Safari 8.0. + + [3]: https://github.com/apache/cordova-weinre + [4]: http://www.iwebinspector.com/ + +## Errores comunes + +* No te olvides de agregar asignación de su plugin para `config.xml` . Si se olvida, se registra un error en la consola de Xcode. + +* No olvide agregar los hosts que conectarse en la lista blanca, como se describe en la guÃa de lista blanca de dominio. Si se olvida, se registra un error en la consola de Xcode. \ No newline at end of file --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
