http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/f061b980/www/docs/es/dev/guide/platforms/ios/upgrading.md ---------------------------------------------------------------------- diff --git a/www/docs/es/dev/guide/platforms/ios/upgrading.md b/www/docs/es/dev/guide/platforms/ios/upgrading.md new file mode 100644 index 0000000..ec734d7 --- /dev/null +++ b/www/docs/es/dev/guide/platforms/ios/upgrading.md @@ -0,0 +1,796 @@ +--- +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 iOS +--- + +# Actualizar iOS + +Esta guÃa le muestra cómo modificar los proyectos iOS 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. + +**Nota**: se requiere Xcode 5. En la actualidad, para presentar a la App Store de Apple, utilice la última versión de iOS SDK, el cual es iOS 7 enviada y esto se incluye sólo con Xcode 5. + +## Proyectos de modernización 3.3.0 a 3.4.0 + +Para proyectos no-CLI, ejecute: + + bin/update path/to/project + + +Para los proyectos de CLI: + +1. Actualización de la `cordova` versión CLI. Vea la interfaz de lÃnea de comandos. + +2. Ejecutar`cordova platform update ios` + +## Proyectos de actualización 3.2.0 a 3.3.0 + +Para proyectos no-CLI, ejecute: + + bin/update path/to/project + + +Para los proyectos de CLI: + +1. Actualización de la `cordova` versión CLI. Vea la interfaz de lÃnea de comandos. + +2. Ejecutar`cordova platform update ios` + +## Proyectos de modernización 3.1.0 a 3.2.0 + +Para proyectos no-CLI, ejecute: + + bin/update path/to/project + + +Para los proyectos de CLI: + +1. Actualización de la `cordova` versión CLI. Vea la interfaz de lÃnea de comandos. + +2. Ejecutar`cordova platform update ios` + +## Proyectos de modernización 3.0.0 a 3.1.0 + +Para proyectos no-CLI, ejecute: + + bin/update path/to/project + + +Para los proyectos de CLI: + +1. Actualización de la `cordova` versión CLI. Vea la interfaz de lÃnea de comandos. + +2. Ejecutar`cordova platform update ios` + +iOS 7 temas: + +1. Eliminar `width=device-width, height=device-height` de la `index.html` del archivo `viewport` `meta` etiqueta. (Véase [el fallo correspondiente][1].) + +2. Actualiza tus plugins de núcleo los medios de comunicación, medios de comunicación-captura y splashscreen por iOS 7 apoyo. + + [1]: https://issues.apache.org/jira/browse/CB-4323 + +Xcode 5 temas: + +1. Actualiza la configuración de proyecto si Xcode 5 incita a hacerlo (en el navegador de temas). + +2. Actualizar su **compilador para C / C + + / Objective-C** establecer, bajo la ficha **Configuración de construir** , sección **Construir opciones** . Elige **por defecto del compilador (Apple LLVM 5.0)**. + +## 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 ios`. + +3. Copiar el contenido del proyecto `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.), lo que seguro para agregar los archivos nuevos a la `.xcodeproj` proyecto. El proyecto de iOS se construye dentro de la `platforms\ios` Directorio. + +5. Copia tus `config.xml` en el `www` Directorio y eliminar cualquier plugin definiciones. Modificar la configuración aquà en lugar del directorio de la 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.9.0 magnetohidrodinámica a 3.0.0 + +1. Descargue y extraiga la fuente Cordova 3.0.0 a una ubicación de directorio permanente en tu disco duro, por ejemplo a`~/Documents/Cordova-3.0.0`. + +2. Deja de Xcode si se está ejecutando. + +3. Usar Terminal.app, desplácese hasta el directorio donde pusiste la fuente descargada anteriormente. + +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 del `www/cordova.js` (tenga en cuenta que ya no tiene un sufijo de versión, la versión en el archivo en el encabezado) 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. Borrar tu `CordovaLib` Directorio y copiar el `CordovaLib` directorio desde el nuevo proyecto en el directorio raÃz de su proyecto. + +**Nota**: a partir de Cordova 3.0.0, plugins no están preinstaladas, y tienes que usar el `plugman` utilidad de lÃnea de comandos para instalarlos tú mismo. Consulte Utilización de Plugman para gestionar Plugins. + +## Proyectos de modernización 2.8.0 a 2.9.0 magnetohidrodinámica + +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`~/Documents/Cordova-2.9.0`. + +2. Deja de Xcode si se está ejecutando. + +3. Usar Terminal.app, desplácese hasta el directorio donde pusiste la fuente descargada anteriormente. + +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 del `www/cordova.js` (tenga en cuenta que ya no tiene un sufijo de versión, la versión en el archivo en el encabezado) 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. Borrar tu `CordovaLib` Directorio y copiar el `CordovaLib` directorio desde el nuevo proyecto en el directorio raÃz de su proyecto. + +## Proyectos de modernización 2.7.0 a 2.8.0 + +1. Descargue y extraiga la fuente Cordova 2.8.0 a una ubicación de directorio permanente en tu disco duro, por ejemplo a`~/Documents/Cordova-2.8.0`. + +2. Deja de Xcode si se está ejecutando. + +3. Usar Terminal.app, desplácese hasta el directorio donde pusiste la fuente descargada anteriormente. + +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 del `www/cordova.js` (tenga en cuenta que ya no tiene un sufijo de versión, la versión en el archivo en el encabezado) archivo del nuevo proyecto en tu `www` Directorio y eliminar su `www/cordova-2.7.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.js` archivo. + +7. Actualizar `<plugin>` clave en la `config.xml` de archivos a `<feature>` etiquetas. Tenga en cuenta que existe `<plugin>` etiquetas todavÃa funcionan, pero son desaprobadas. Usted puede copiar esta información en el `config.xml` archivo para un nuevo proyecto. Por ejemplo: + + <plugins> + <plugin name="LocalStorage" value="CDVLocalStorage" /> + <!-- other plugins --> + </plugins> + + <!-- change to: (note that a <feature> tag is on the same level as <plugins> --> + <feature name="LocalStorage"> + <param name="ios-package" value="CDVLocalStorage" /> + </feature> + <!-- other <feature> tags --> + + +8. Eliminar la `CordovaLib` Directorio y copiar el `CordovaLib` directorio desde el nuevo proyecto en el directorio raÃz de su proyecto. + +9. Agregar estos dos marcos para su proyecto: + + ImageIO openAL + + +10. Actualizar el destino de su proyecto **Construir ajustes**. Bajo **Vinculación â otros Linker Flags**, editar **"- Obj - C"** para ser **"-ObjC"**. + +11. Actualizar el destino de su proyecto **Construir ajustes**. Bajo **Vinculación â otros Linker Flags**, cambio **"-all_load"** para ser `-force\_load ${BUILT\_PRODUCTS\_DIR}/libCordova.a` . Sólo necesitas hacer esto si tienes el problema definido en [este tema.][2]. + + [2]: https://issues.apache.org/jira/browse/CB-3458 + +## 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`~/Documents/Cordova-2.7.0`. + +2. Deja de Xcode si se está ejecutando. + +3. Usar Terminal.app, desplácese hasta el directorio donde pusiste la fuente descargada anteriormente. + +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-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. Actualizar (o reemplazar, si nunca has cambiado el archivo) su `AppDelegate.m` archivo según el uno en el nuevo proyecto (véase [este diff][3]). + +8. En su `config.xml` de archivo, [elimine esta lÃnea][4]. + +9. Borrar tu `CordovaLib` Directorio y copiar el `CordovaLib` directorio desde el nuevo proyecto en el directorio raÃz de su proyecto. + + [3]: https://git-wip-us.apache.org/repos/asf?p=cordova-ios.git;a=blobdiff;f=bin/templates/project/__TESTING__/Classes/AppDelegate.m;h=5c05ac80e056753c0e8736f887ba9f28d5b0774c;hp=623ad8ec3c46f656ea18c6c3a190d650dd64e479;hb=c6e71147386d4ad94b07428952d1aae0a9cbf3f5;hpb=c017fda8af00375a453cf27cfc488647972e9a23 + [4]: https://git-wip-us.apache.org/repos/asf?p=cordova-ios.git;a=blobdiff;f=bin/templates/project/__TESTING__/config.xml;h=537705d76a5ef6bc5e57a8ebfcab78c02bb4110b;hp=8889726d9a8f8c530fe1371c56d858c34552992a;hb=064239b7b5fa9a867144cf1ee8b2fb798ce1f988;hpb=c9f233250d4b800f3412eeded811daaafb17b2cc + +## Proyectos de modernización 2.5.0 a 2.6.0 + +1. Descargue y extraiga la fuente Cordova 2.6.0 a una ubicación de directorio permanente en tu disco duro, por ejemplo a`~/Documents/Cordova-2.6.0`. + +2. Deja de Xcode si se está ejecutando. + +3. Usar Terminal.app, desplácese hasta el directorio donde pusiste la fuente descargada anteriormente. + +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 del proyecto `www/cordova-2.6.0.js` de archivos a tu `www` Directorio y eliminar su `www/cordova-2.5.0.js` archivo. + +6. Actualizar la referencia de script Cordova en su `www/index.html` archivo (junto con otros archivos que hacen referencia a la secuencia de comandos) para referirse a la nueva `cordova-2.6.0.js` archivo. + +7. Actualizar (o reemplazar, si nunca has cambiado el archivo) su `AppDelegate.m` archivo según el uno en el nuevo proyecto (véase [este diff][5]). + +8. En su `config.xml` de archivo, [añadir esta nueva lÃnea][6]. + +9. En su `config.xml` de archivo, [añadir esta nueva lÃnea][7]. + +10. En su `config.xml` de archivos, [UIWebViewBounce se ha cambiado a DisallowOverscroll, y los valores predeterminados son diferentes][8]. + +11. En su `config.xml` archivo, el `EnableLocation` preferencia ha quedado obsoleto. + +12. Borrar tu `CordovaLib` Directorio y copiar el `CordovaLib` directorio desde el nuevo proyecto en el directorio raÃz de su proyecto. + + [5]: https://git-wip-us.apache.org/repos/asf?p=cordova-ios.git;a=blobdiff;f=bin/templates/project/__TESTING__/Classes/AppDelegate.m;h=124a56bb4f361e95616f44d6d6f5a96ffa439b60;hp=318f79326176be8f16ebc93bad85dd745f4205b6;hb=a28c7712810a63396e9f32fa4eb94fe3f8b93985;hpb=36acdf55e4cab52802d73764c8a4b5b42cf18ef9 + [6]: https://git-wip-us.apache.org/repos/asf?p=cordova-ios.git;a=blobdiff;f=bin/templates/project/__TESTING__/config.xml;h=1555b5e81de326a07efe0bccaa5f5e2326b07a9a;hp=0652d60f8d35ac13c825c572dca6ed01fea4a540;hb=95f16a6dc252db0299b8e2bb53797995b1e39aa1;hpb=a2de90b8f5f5f68bd9520bcbbb9afa3ac409b96d + [7]: https://git-wip-us.apache.org/repos/asf?p=cordova-ios.git;a=blobdiff;f=bin/templates/project/__TESTING__/config.xml;h=d307827b7e67301171a913417fb10003d43ce39d;hp=04260aa9786d6d74ab20a07c86d7e8b34e31968c;hb=97b89edfae3527828c0ca6bb2f6d58d9ded95188;hpb=942d33c8e7174a5766029ea1232ba2e0df745c3f + [8]: https://git-wip-us.apache.org/repos/asf?p=cordova-ios.git;a=blobdiff;f=bin/templates/project/__TESTING__/config.xml;h=8889726d9a8f8c530fe1371c56d858c34552992a;hp=d307827b7e67301171a913417fb10003d43ce39d;hb=57982de638a4dce6ae130a26662591741b065f00;hpb=ec411f18309d577b4debefd9a2f085ba719701d5 + +## Proyectos de modernización 2.4.0 a 2.5.0 + +1. Descargue y extraiga la fuente Cordova 2.5.0 a una ubicación de directorio permanente en tu disco duro, por ejemplo a`~/Documents/Cordova-2.5.0`. + +2. Deja de Xcode si se está ejecutando. + +3. Usar Terminal.app, desplácese hasta el directorio donde pusiste la fuente descargada anteriormente. + +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-2.5.0.js` archivo del nuevo proyecto en tu `www` Directorio y eliminar su `www/cordova-2.4.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.5.0.js` archivo. + +7. Actualizar (o reemplazar, si nunca has cambiado el archivo) su `AppDelegate.m` archivo según el uno en el nuevo proyecto (véase [este diff][9]). + +8. En su `config.xml` de archivo, [añadir estas nuevas lÃneas][10]. + +9. En su `config.xml` de archivo, [editar el elemento raÃz, cambiarlo de cordova al widget][11]. + +10. En su `config.xml` de archivo, [quitar la preferencia OpenAllWhitelistURLsInWebView][12]. + +11. Borrar tu `cordova` Directorio y copiar el `cordova` directorio desde el nuevo proyecto en el directorio raÃz de su proyecto. En 2.5.0, esto ha actualizado secuencias de comandos. + +12. Borrar tu `CordovaLib` Directorio y copiar el `CordovaLib` directorio desde el nuevo proyecto en el directorio raÃz de su proyecto. + + [9]: https://git-wip-us.apache.org/repos/asf?p=cordova-ios.git;a=blobdiff;f=bin/templates/project/__TESTING__/Classes/AppDelegate.m;h=318f79326176be8f16ebc93bad85dd745f4205b6;hp=6dc7bfc84f0ecede4cc43d2a3256ef7c5383b9fe;hb=4001ae13fcb1fcbe73168327630fbc0ce44703d0;hpb=299a324e8c30065fc4511c1fe59c6515d4842f09 + [10]: https://git-wip-us.apache.org/repos/asf?p=cordova-ios.git;a=blobdiff;f=bin/templates/project/__TESTING__/config.xml;h=903944c4b1e58575295c820e154be2f5f09e6314;hp=721c734120b13004a4a543ee25f4287e541f34be;hb=ae467249b4a256bd31ee89aea7a06f4f2316b8ac;hpb=9e39f7ef8096fb15b38121ab0e245a3a958d9cbb + [11]: https://git-wip-us.apache.org/repos/asf?p=cordova-ios.git;a=blobdiff;f=bin/templates/project/__TESTING__/config.xml;h=64e71636f5dd79fa0978a97b9ff5aa3860a493f5;hp=d8579352dfb21c14e5748e09b2cf3f4396450163;hb=0e711f8d09377a7ac10ff6be4ec17d22cdbee88d;hpb=57c3c082ed9be41c0588d0d63a1d2bfcd2ed878c + [12]: https://git-wip-us.apache.org/repos/asf?p=cordova-ios.git;a=blobdiff;f=bin/templates/project/__TESTING__/config.xml;h=721c734120b13004a4a543ee25f4287e541f34be;hp=7d67508b70914aa921a16e79f79c00512502a8b6;hb=187bf21b308551bfb4b98b1a5e11edf04f699791;hpb=03b8854bdf039bcefbe0212db937abd81ac675e4 + +## Proyectos de modernización 2.3.0 a 2.4.0 + +1. Descargue y extraiga la fuente Cordova 2.4.0 a una ubicación de directorio permanente en tu disco duro, por ejemplo a`~/Documents/Cordova-2.4.0`. + +2. Deja de Xcode si se está ejecutando. + +3. Usar Terminal.app, desplácese hasta el directorio donde pusiste la fuente descargada anteriormente. + +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-2.4.0.js` archivo del nuevo proyecto en tu `www` Directorio y eliminar su `www/cordova-2.3.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.4.0.js` archivo. + +7. Actualizar (o reemplazar, si nunca has cambiado los archivos) su `MainViewController.m` archivo según el uno en el nuevo proyecto (véase [este diff][13]). + +8. Actualizar (o reemplazar, si nunca has cambiado el archivo) su `AppDelegate.m` archivo según el uno en el nuevo proyecto (véase [este diff][14]). + +9. En su `config.xml` de archivo, [añadir esta nueva lÃnea][15]. + +10. Borrar tu `cordova` Directorio y copiar el `cordova` directorio desde el nuevo proyecto en el directorio raÃz de su proyecto. En 2.4.0, esto ha solucionado secuencias de comandos. + +11. Borrar tu `CordovaLib` Directorio y copiar el `CordovaLib` directorio desde el nuevo proyecto en el directorio raÃz de su proyecto. + +12. Agregar a AssetsLibrary.framework como un recurso a su proyecto. (Consulte [la documentación de Apple][16] para obtener instrucciones sobre cómo hacerlo.). + + [13]: https://git-wip-us.apache.org/repos/asf?p=cordova-ios.git;a=blobdiff;f=bin/templates/project/__TESTING__/Classes/MainViewController.m;h=5f9eeac15c2437cd02a6eb5835b48374e9b94100;hp=89da1082d06ba5e5d0dffc5b2e75a3a06d5c2aa6;hb=b4a2e4ae0445ba7aec788090dce9b822d67edfd8;hpb=a484850f4610e73c7b20cd429a7794ba829ec997 + [14]: https://git-wip-us.apache.org/repos/asf?p=cordova-ios.git;a=blobdiff;f=bin/templates/project/__TESTING__/Classes/AppDelegate.m;h=6dc7bfc84f0ecede4cc43d2a3256ef7c5383b9fe;hp=1ca3dafeb354c4442b7e149da4f281675aa6b740;hb=6749c17640c5fed8a7d3a0b9cca204b89a855baa;hpb=deabeeb6fcb35bac9360b053c8bf902b45e6de4d + [15]: https://git-wip-us.apache.org/repos/asf?p=cordova-ios.git;a=blobdiff;f=bin/templates/project/__TESTING__/config.xml;h=7d67508b70914aa921a16e79f79c00512502a8b6;hp=337d38da6f40c7432b0bce05aa3281d797eec40a;hb=6749c17640c5fed8a7d3a0b9cca204b89a855baa;hpb=deabeeb6fcb35bac9360b053c8bf902b45e6de4d + [16]: https://developer.apple.com/library/ios/#recipes/xcode_help-project_editor/Articles/AddingaLibrarytoaTarget.html + +## Proyectos de modernización 2.2.0 a 2.3.0 + +1. Descargue y extraiga la fuente Cordova 2.3.0 a una ubicación de directorio permanente en tu disco duro, por ejemplo a`~/Documents/Cordova-2.3.0`. + +2. Deja de Xcode si se está ejecutando. + +3. Usar Terminal.app, desplácese hasta el directorio donde pusiste la fuente descargada anteriormente. + +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-2.3.0.js` archivo del nuevo proyecto en tu `www` Directorio y eliminar su `www/cordova-2.2.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.3.0.js` archivo. + +7. Actualizar (o reemplazar, si nunca has cambiado el archivo) su `MainViewController.m` según el uno en el nuevo proyecto. + +8. Borrar tu `cordova` Directorio y copiar el `cordova` directorio desde el nuevo proyecto en el directorio raÃz de su proyecto. En 2.3.0, esto tiene nuevos scripts. + +9. Borrar tu `CordovaLib` Directorio y copiar el `CordovaLib` directorio desde el nuevo proyecto en el directorio raÃz de su proyecto. + +10. Convertir tu `Cordova.plist` de archivos a `config.xml` , ejecutando el script `bin/cordova\_plist\_to\_config\_xml` en el archivo de proyecto. + +11. Añadir el plugin InAppBrowser para su `config.xml` , añadiendo esta etiqueta bajo `<cordova><plugins>` : + + <plugin name="InAppBrowser" value="CDVInAppBrowser" /> + + +12. Nota que los plugins Objective-C son ya *no* clasificarlas. A la lista blanca sus conexiones con la lista blanca de la aplicación, es necesario establecer la `User-Agent` cabecera de la conexión con el mismo agente de usuario como la principal Cordova WebView. Esto puedes acceder a la `userAgent` propiedad del modelo-vista-controlador principal. El modelo-vista-controlador principal ( `CDVViewController` ) también tiene un `URLisAllowed` método para comprobar si una URL pasa la lista blanca. + +13. Cambios de dispositivo API: + + * Para iOS, device.platform se utiliza para `iPhone` , `iPad` o `iPod Touch` ; ahora devuelve (correctamente)`iOS`. + * Para iOS, device.name (ahora en desuso para todas las plataformas) se utiliza para devolver el nombre del dispositivo del usuario (por ejemplo ' iPhone 5â² de Shazron); Ahora devuelve utilizado para devolver lo que device.platform: `iPhone` , `iPad` o`iPod Touch`. + * Para todas las plataformas, hay una nueva propiedad llamada device.model; Esto devuelve el modelo de dispositivo especÃfico, por ejemplo `iPad2,5` (para otras plataformas, devuelve lo que device.name utilizada para devolver). + +## Proyectos de modernización 2.1.0 a 2.2.0 + +1. Descargue y extraiga la fuente Cordova 2.2.0 a una ubicación de directorio permanente en tu disco duro, por ejemplo a`~/Documents/Cordova-2.2.0`. + +2. Deja de Xcode si se está ejecutando. + +3. Usar Terminal.app, desplácese hasta el directorio donde pusiste la fuente descargada anteriormente. + +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-2.2.0.js` archivo del nuevo proyecto en tu `www` Directorio y eliminar su `www/cordova-2.1.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.2.0.js` archivo. + +7. Actualizar (o reemplazar, si nunca has cambiado el archivo) su `MainViewController.m` según el uno en el nuevo proyecto: + + * Actualizado â viewWillAppear + +8. Copia del `cordova` del proyecto nuevo directorio en el directorio raÃz de su proyecto. En 2.2.0, esto tiene un guión 'emular' actualizado. + +9. A continuación, actualizar su `CordovaLib` el proyecto de referencia. A partir de Cordova 2.1.0, no estamos utilizando la variable CORDOVALIB Xcode ya al hacer referencia a donde `CordovaLib` reside, la referencia es ahora una referencia absoluta. + + 1. Lanzamiento Terminal.app + 2. Ir a la ubicación donde instaló Cordova (véase paso 1), en el `bin` subdirectorio + 3. Ejecute el script siguiente donde el primer parámetro es la ruta de su proyecto `.xcodeproj` archivo: + + `update_cordova_subproject path/to/your/project/xcodeproj` + +**Nota**: en 2.2.0, el `bin/create` copia de la escritura de la `CordovaLib` proyecto secundario en su proyecto. Para tener el mismo tipo de configuración, sólo tienes que copiar en el derecho `CordovaLib` en el directorio del proyecto y actualizar el `CordovaLib` sub-Project ubicación (en relación con el proyecto) en el Inspector de archivo Xcode. + +## Proyectos de modernización 2.0.0 a 2.1.0 + +Con Cordova 2.1.0, `CordovaLib` ha sido actualizado para utilizar el **Conteo automático de referencia (ARC)**. Usted no necesita actualizar a **ARC** a usar CordovaLib, pero si desea actualizar su proyecto para utilizar **ARC**, utilice el Asistente para migración de Xcode desde el menú: **Editar â Refactor â convertir en Objective-C arco...**, anular la selección de libCordova.a, luego ejecute el Asistente para completar. + +1. Descargue y extraiga la fuente Cordova 2.1.0 a una ubicación de directorio permanente en tu disco duro, por ejemplo a`~/Documents/Cordova-2.1.0`. + +2. Deja de Xcode si se está ejecutando. + +3. Usar Terminal.app, desplácese hasta el directorio donde pusiste la fuente descargada anteriormente. + +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-2.1.0.js` archivo del nuevo proyecto en tu `www` Directorio y eliminar su `www/cordova-2.0.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.1.0.js` archivo. + +7. Actualizar (o reemplazar, si nunca has cambiado el archivo) su `AppDelegate.m` según el uno en el nuevo proyecto: + + * Editado â aplicación: didFinishLaunchingWithOptions: + * Añadido â aplicación: supportedInterfaceOrientationsForWindow: + +8. Actualizar (o reemplazar, si nunca has cambiado el archivo) su `MainViewController.m` según el uno en el nuevo proyecto: + + * Añadido â viewWillAppear + +9. Copia del `cordova` del proyecto nuevo directorio en el directorio raÃz de su proyecto. En 2.1.0, esto tiene los scripts actualizados para apoyar caminos con espacios. + +10. Retire el `VERSION` Referencia de su proyecto de archivo (*no* el uno en`CordovaLib`). + +11. A continuación, actualizar su `CordovaLib` el proyecto de referencia. A partir de Cordova 2.1.0, no estamos utilizando la variable CORDOVALIB Xcode ya al hacer referencia a donde `CordovaLib` reside, la referencia es ahora una referencia absoluta. + + 1. Lanzamiento Terminal.app + 2. Ir a la ubicación donde instaló Cordova (véase paso 1), en el `bin` subdirectorio + 3. Ejecute el script siguiente donde el primer parámetro es la ruta de su proyecto `.xcodeproj` archivo: + + `update_cordova_subproject ruta/a/tu/proyecto/xcodeproj` + +## Proyectos de modernización 1.9.0 a 2.0.0 + +1. Instale Cordova 2.0.0. + +2. Crear un nuevo proyecto, como se describe en iOS herramientas de lÃnea de comandos. Necesitas los activos de este nuevo proyecto. + +3. Copia el `www/cordova-2.0.0.js` archivo del nuevo proyecto en tu `www` Directorio y eliminar su `www/cordova-1.9.0.js` archivo. + +4. 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.0.0.js` archivo. + +5. Copia del `cordova` del proyecto nuevo directorio en el directorio raÃz del proyecto (si quieres las herramientas de lÃnea de comandos de proyecto). + +6. Añadir una nueva entrada en `Plugins` en el `Cordova.plist` archivo, en el grupo de **Archivos auxiliares** . La clave es `Device` y el valor es`CDVDevice`. + +7. Quitar`Cordova.framework`. + +8. Quitar `verify.sh` del grupo de **Archivos auxiliares** . + +9. Seleccione el icono del proyecto en el navegador de proyectos, seleccione el proyecto **objetivo**, luego seleccione la ficha **Configuración de construir** . + +10. Buscar **Preprocessor Macros**, luego retire todo **CORDOVA_FRAMEWORK = 1** valores. + +11. Localice el `CordovaLib` directorio que se instaló en tu disco duro en de su carpeta de inicio `Documents` subdirectorio. + +12. Localizar el `CordovaLib.xcodeproj` de los archivos en el `CordovaLib` Directorio, a continuación, arrastrar y soltar el archivo en su proyecto. Debe aparecer como un subproyecto. + +13. Construya su proyecto, deberÃas conseguir algunos errores relativos a `#import` directivas. + +14. Para el `#import` errores, cambiar de cualquier base de cotización de las importaciones en este estilo: + + #import "CDV.h" + + + a este estilo basado en soportes: + + #import < Cordova/CDV.h > + + + y eliminar cualquier `#ifdef` contenedores de cualquier Cordova las importaciones, ya no son necesarios (ahora se unifican las importaciones) + +15. Construya su proyecto de nuevo, y no debe tener ninguna `#import` errores. + +16. Seleccione el **icono de proyecto** en el navegador de proyectos, seleccione su proyecto **objetivo**, luego seleccione la ficha **Fases construir** . + +17. Ampliar la fase **Objetivo dependencias** , luego el botón select el **+** . + +18. Seleccione el `CordovaLib` blanco, a continuación, seleccione el botón **Agregar** . + +19. Ampliar la primera fase **Binario de enlace con las bibliotecas** (ya deberÃa contener un montón de Marcos), a continuación, seleccione el **+** botón. + +20. Seleccione el `libCordova.a` biblioteca estática, luego seleccione el botón **Agregar** . + +21. Eliminar la fase **Run Script** . + +22. Seleccione el **icono de proyecto** en el navegador de proyectos, seleccione el proyecto **objetivo**, luego seleccione la ficha **Configuración de construir** . + +23. Buscar **Otras banderas Linker**y agregue los valores **-force_load** y **- Obj-C**. + +24. Ampliar la `CordovaLib` subproyectos. + +25. Localice el `VERSION` archivo, arrastrarlo a su proyecto principal (queremos crear un enlace a él, no una copia). + +26. Seleccione el botón **Crear grupo para cualquier añadidas carpetas** y seleccione el botón **terminar** . + +27. Seleccione el `VERSION` archivo que sólo se haya arrastrado en un paso anterior. + +28. Tipo de la combinación de teclas **Command-Option-1** para mostrar el **Inspector de archivo** (o menuitem **ve utilidades â â Mostrar archivo Inspector**). + +29. Elegir **comparado con CORDOVALIB** en el **Archivo Inspector** para el menú desplegable para **Ubicación**. + +30. Establecer la preferencia de Xcode **Xcode preferencias â ubicaciones â los datos derivados â avanzado...** a **Unique**, asà que pueden encontrarse las cabeceras unificadas. + +31. Seleccione el **icono de proyecto** en el navegador de proyectos, selecciona tu **destino**y seleccione la ficha **Configuración de construir** . + +32. Búsqueda de **rutas de búsqueda encabezado**. Para ese ajuste, anexar estos tres valores, incluyendo las comillas: + + "$(TARGET_BUILD_DIR) / usr/local/lib/incluyen" "$(OBJROOT) / UninstalledProducts/include" "$(BUILT_PRODUCTS_DIR)" + + +33. Búsqueda de **otras banderas del vinculador**. Para ese ajuste, anexar este valor: + + -weak_framework CoreFoundation + + +34. Construya su proyecto, debe compilar y vincular con **ningún problema**. + +35. Seleccione su proyecto en el **esquema de** menú desplegable y seleccione **iPhone 5.1 simulador**. + +36. Seleccione el botón **Ejecutar** . + +**Nota**: Si su proyecto no está funcionando como se esperaba en el simulador, por favor, tome nota de los errores en el registro de la consola en Xcode en busca de pistas. + +## 1.8.x proyectos de mejora a 1.9.0 + +1. Instale Cordova 1.9.0. + +2. Crear un nuevo proyecto. Usted necesitará algunos de los activos de este nuevo proyecto. + +3. Copia el `www/cordova-1.9.0.js` archivo del nuevo proyecto en tu `www` Directorio y eliminar su `www/cordova-1.8.x.js` archivo. + +4. 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-1.9.0.js` archivo. + +**Nota**: 1.9.0 es compatible con el nuevo `BackupWebStorage` booleana `Cordova.plist` ajuste. Está habilitada de forma predeterminada, asà lo han decidido `false` para desactivarlo, especialmente en iOS 6. Ver [notas de la versión: Safari y sección UIKit][17] + + [17]: https://developer.apple.com/library/prerelease/ios/#releasenotes/General/RN-iOSSDK-6_0/_index.html + +## 1.7.0 actualización proyectos para 1.8.x + +1. Instale Cordova 1.8.0. + +2. Crear un nuevo proyecto. Usted necesitará algunos de los activos de este nuevo proyecto. + +3. Copia el `www/cordova-1.8.0.js` archivo del nuevo proyecto en tu `www` Directorio y eliminar su `www/cordova-1.7.x.js` archivo. + +4. 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-1.8.0.js` archivo. + +Si piensas sobre el uso de la API de captura, necesitará los nuevo **iPad pantalla retina -** activos: + +1. Copia el `Resources/Capture.bundle` tema del nuevo proyecto en el directorio de tu proyecto, escribiendo sobre su existente `Resources/Capture.bundle` artÃculo. + +2. En su proyecto, seleccione el `Capture.bundle` del artÃculo en el navegador de tu proyecto en Xcode, escriba la clave de **borrar** , luego seleccione **Eliminar referencia** en el cuadro de diálogo resultante. + +3. Arrastre el nuevo `Capture.bundle` del paso 1 arriba en tu navegador de proyecto en Xcode, seleccione el botón **Crear grupo para cualquier añadidas carpetas** . + +## 1.6. x proyectos de mejora a 1.7.0 + +1. Instale Cordova 1.7.0. + +2. Crear un nuevo proyecto. Usted necesitará algunos de los activos de este nuevo proyecto. + +3. Copia el `www/cordova-1.7.0.js` archivo del nuevo proyecto en tu `www` Directorio y eliminar su `www/cordova-1.6.0.js` archivo. + +4. 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-1.7.0.js` archivo. + +## Proyectos de actualización 1.5.0 a 1.6. x + +1. Instale Cordova 1.6.1. + +2. Hacer un backup de `AppDelegate.m` , `AppDelegate.h` , `MainViewController.m` , `MainViewController.h` , y `Cordova.plist` en su proyecto. + +3. Crear un nuevo proyecto. Usted necesitará algunos de los activos de este nuevo proyecto. + +4. Copie estos archivos desde el nuevo proyecto en su directorio de proyecto 1.5.0-based en el disco, reemplazando los viejos archivos (copia de seguridad de sus archivos primero desde el paso 2 anterior): + + AppDelegate.h + AppDelegate.m + MainViewController.h + MainViewController.m + Cordova.plist + + +5. Añadir todos los nuevos `MainViewController` y `AppDelegate` los archivos a su proyecto Xcode. + +6. Copia el `www/cordova-1.6.1.js` archivo del nuevo proyecto en tu `www` Directorio y eliminar su `www/cordova-1.5.0.js` archivo. + +7. 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-1.6.1.js` archivo. + +8. Añadir nuevo `Cordova.plist` archivo a su proyecto. Esto es necesario porque los nombres de servicio núcleo plugin deben cambiar para que coincida con la de Android y BlackBerry, para un unificado (archivo de Cordova JavaScript`cordova-js`). + +9. Integrar cualquier configuración, **Plugins** y **ExternalHosts** de las entradas que tenÃa en su **respaldo de Cordova.plist** en la nueva`Cordova.plist`. + +10. Integrar cualquier código de proyectos especÃficos que tienes en tu respaldo de `AppDelegate.h` y `AppDelegate.m` en el nuevo `AppDelegate` archivos. Cualquier `UIWebViewDelegate` o `CDVCommandDelegate` el código `AppDelegate.m` debe ir a `MainViewController.m` ahora (vea las secciones de salida comentó en ese archivo). + +11. Integrar cualquier código de proyectos especÃficos que tienes en tu respaldo de `MainViewController.h` y `MainViewController.m` en los archivos del MainViewController nuevo. + +12. Haga clic en el icono del proyecto en el navegador de proyectos, seleccione el **proyecto**y seleccione la ficha **Configuración de construir** . + +13. Entrar en **compilador para C / C + + / Objective-C** en el campo de búsqueda. + +14. Seleccione el valor de **Apple LLVM Compiler 3.1** . + +## Inicio Proyectos de mejora a 1.5.0 + +1. Instale Cordova 1.5.0. + +2. Crear un proyecto nuevo y ejecutarlo una vez. Usted necesitará algunos de los activos de este nuevo proyecto. + +3. Copia el `www/cordova-1.5.0.js` archivo del nuevo proyecto en tu `www` Directorio y eliminar su `www/phonegap-1.4.x.js` archivo. + +4. 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 Córdoba `cordova-1.5.0.js` archivo. + +5. Encontrar `PhoneGap.framework` en tu navegador de proyectos, selecciónelo. + +6. Escriba la clave de **borrar** y eliminar la `PhoneGap.framework` referencia en el navegador de proyectos. + +7. Tipo de la combinación de teclas **Comando + Opción-A** , que debe bajar una hoja para añadir archivos a tu proyecto (la hoja **Agregar archivos...** ). Asegúrese de que selecciona el botón de radio **creado grupos para cualquier añadidos carpetas** . + +8. Tipo de la combinación de teclas **Shift-comando-G** , que deberÃa bajar otra hoja para que vayas a una carpeta (el **ir a la carpeta:** hoja). + +9. Introduzca `/Users/Shared/Cordova/Frameworks/Cordova.framework` en el **vaya a la carpeta:** de la hoja y luego presione el botón **ir** . + +10. Pulse el botón **añadir** en la hoja de **Agregar archivos...** . + +11. Seleccione `Cordova.framework` en el navegador de proyectos. + +12. Tipo de la combinación de teclas **Command-Option-1** para mostrar el **Inspector File**. + +13. Seleccione **Ruta absoluta** en el **Inspector de archivo** de la lista desplegable de **localización**. + +14. Tipo de la combinación de teclas **Comando + Opción-A** , que debe bajar una hoja para añadir archivos a tu proyecto (la hoja **Agregar archivos...** ). Asegúrese de que selecciona el botón de radio **creado grupos para cualquier añadidos carpetas** . + +15. Tipo de la combinación de teclas **Shift-comando-G** , que deberÃa bajar otra hoja para que vayas a una carpeta (el **ir a la carpeta:** hoja). + +16. Introduzca `~/Documents/CordovaLib/Classes/deprecated` en el **vaya a la carpeta:** de la hoja y luego presione el botón **ir** . + +17. Pulse el botón **añadir** en la hoja de **Agregar archivos...** . + +18. En su `AppDelegate.h` , `AppDelegate.m` , y `MainViewController.h` archivos, reemplace el conjunto `#ifdef PHONEGAP_FRAMEWORK` bloque con: + + #import "CDVDeprecated.h" + + +19. Haga clic en el **icono de proyecto** en el navegador de proyectos, seleccione su **destino**y seleccione la ficha **Configuración de construir** . + +20. Buscar **rutas de búsqueda de marco**. + +21. Reemplace el valor existente con`/Users/Shared/Cordova/Frameworks`. + +22. Búsqueda de **preprocesador Macros**. + +23. El primer valor (combinado), reemplazar el valor con **CORDOVA_FRAMEWORK = YES**. + +24. Seleccione la ficha **Fases de construcción** . + +25. Ampliar **Ejecutar Script**. + +26. Reemplace cualquier ocurrencias de **PhoneGap** con **Cordova**. + +27. Encuentra tu `PhoneGap.plist` los archivos en el navegador de proyectos y haga clic en el nombre del archivo una vez para entrar en modo de edición de nombre. + +28. Cambiar el nombre de `PhoneGap.plist` a`Cordova.plist`. + +29. Haga clic en `Cordova.plist` y elija **abrir como â código fuente**. + +30. Pulse **Comando + opción +-F**, elija **reemplazar** desde el menú desplegable en la parte superior izquierda de la ventana de código fuente. + +31. Entrar en `com.phonegap` para la cadena de búsqueda, y `org.apache.cordova` para la cadena de reemplazo, luego presione el botón **Reemplazar todos** . + +32. Introduzca **PG** para la cadena de búsqueda y **CDV** para la cadena de reemplazo, luego presione el botón **Reemplazar todos** . + +33. Pulse **Comando + B** para construir. TodavÃa tienes deprecations que usted puede deshacerse de en el futuro (ver `CDVDeprecated.h` . Por ejemplo, reemplazar las clases en el código que utilizan PG * a la CDV). + +## Proyectos de modernización 1.4.0 a 1.4.1 + +1. Instale Cordova 1.4.1. + +2. Realizar una copia de seguridad`MainViewController.m`. + +3. Crear un nuevo proyecto. Usted necesitará algunos de los activos de este nuevo proyecto. + +4. Copia el `MainViewController.m` archivo del nuevo proyecto en su directorio de proyecto 1.4.0-based en el disco, reemplazando el archivo viejo (copia de seguridad archivos primero del paso 2 anterior). + +5. Añadir el `MainViewController.m` archivo a su proyecto Xcode. + +6. Integrar cualquier código de proyectos especÃficos que tienes en tu respaldo de `MainViewController.m` en el archivo de nuevo. + +7. Actualización de la `phonegap-1.4.0.js` archivo es opcional, no ha cambiado nada en JavaScript entre 1.4.0 y 1.4.1. + +## Proyectos de modernización 1.3.0 a 1.4.0 + +1. Instale Cordova 1.4.0. + +2. Hacer un backup de `AppDelegate.m` y `AppDelegate.h` en su proyecto. + +3. Crear un nuevo proyecto. Usted necesitará algunos de los activos de este nuevo proyecto. + +4. Copie estos archivos desde el nuevo proyecto en su directorio de proyecto 1.3.0-based en el disco, reemplazando los viejos archivos (copia de seguridad de sus archivos primero desde el paso 2 anterior): + + AppDelegate.h + AppDelegate.m + MainViewController.h + MainViewController.m + MainViewController.xib + + +5. Añadir todos los `MainViewController` los archivos a su proyecto Xcode. + +6. Copia el `www/phonegap-1.4.0.js` archivo del nuevo proyecto en tu `www` Directorio y eliminar su `www/phonegap-1.3.0.js` archivo. + +7. 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 `phonegap-1.4.0.js` archivo. + +8. Añadir una nueva entrada en `Plugins` en el `PhoneGap.plist` archivo. La clave es `com.phonegap.battery` y el valor es`PGBattery`. + +9. Integrar cualquier código de proyectos especÃficos que tienes en tu respaldo de `AppDelegate.h` y `AppDelegate.m` en los archivos del AppDelegate nuevo. + +## Proyectos de actualización 1.2.0 a 1.3.0 + +1. Instale Cordova 1.3.0. + +2. Hacer un backup de `AppDelegate.m` y `AppDelegate.h` en su proyecto. + +3. Crear un nuevo proyecto. Usted necesitará algunos de los activos de este nuevo proyecto. + +4. Copie estos archivos desde el nuevo proyecto en su directorio de proyecto 1.2.0-based en el disco, reemplazando los viejos archivos (copia de seguridad de sus archivos primero desde el paso 2 anterior): + + AppDelegate.h + AppDelegate.m + MainViewController.h + MainViewController.m + MainViewController.xib + + +5. Añadir todos los `MainViewController` los archivos a su proyecto Xcode. + +6. Copia el `www/phonegap-1.3.0.js` archivo del nuevo proyecto en tu `www` Directorio y eliminar su `www/phonegap-1.2.0.js` archivo. + +7. 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 `phonegap-1.3.0.js` archivo. + +8. Añadir una nueva entrada en `Plugins` en el `PhoneGap.plist` archivo. La clave es `com.phonegap.battery` y el valor es`PGBattery`. + +9. Integrar cualquier código de proyectos especÃficos que tienes en tu respaldo de `AppDelegate.h` y `AppDelegate.m` en los archivos del AppDelegate nuevo. + +## Proyectos de modernización 1.1.0 a 1.2.0 + +1. Instale Cordova 1.2.0. + +2. Hacer un backup de `AppDelegate.m` y `AppDelegate.h` en su proyecto. + +3. Crear un nuevo proyecto. Usted necesitará algunos de los activos de este nuevo proyecto. + +4. Copie estos archivos desde el nuevo proyecto en su directorio de proyecto 1.1.0-based en el disco, reemplazando los viejos archivos (copia de seguridad de sus archivos primero desde el paso 2 anterior): + + AppDelegate.h + AppDelegate.m + MainViewController.h + MainViewController.m + MainViewController.xib + + +5. Añadir todos los `MainViewController` los archivos a su proyecto Xcode. + +6. Copia el `www/phonegap-1.2.0.js` archivo del nuevo proyecto en tu `www` Directorio y eliminar su `www/phonegap-1.1.0.js` archivo. + +7. 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 `phonegap-1.2.0.js` archivo. + +8. Añadir una nueva entrada en `Plugins` en el `PhoneGap.plist` archivo. La clave es `com.phonegap.battery` y el valor es`PGBattery`. + +9. Integrar cualquier código de proyectos especÃficos que tienes en tu respaldo de `AppDelegate.h` y `AppDelegate.m` en los archivos del AppDelegate nuevo. + +## Proyectos de modernización 1.0.0 a 1.1.0 + +1. Instale Cordova 1.1.0. + +2. Hacer un backup de `AppDelegate.m` y `AppDelegate.h` en su proyecto. + +3. Crear un nuevo proyecto. Usted necesitará algunos de los activos de este nuevo proyecto. + +4. Copie estos archivos desde el nuevo proyecto en su directorio de proyecto 1.0.0-based en el disco, reemplazando los viejos archivos (copia de seguridad de sus archivos primero desde el paso 2 anterior): + + AppDelegate.h + AppDelegate.m + MainViewController.h + MainViewController.m + MainViewController.xib + + +5. Añadir todos los `MainViewController` los archivos a su proyecto Xcode. + +6. Copia el `www/phonegap-1.1.0.js` archivo del nuevo proyecto en tu `www` Directorio y eliminar su `www/phonegap-1.0.0.js` archivo. + +7. 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 `phonegap-1.1.0.js` archivo. + +8. Añadir una nueva entrada en `Plugins` en el `PhoneGap.plist` archivo. La clave es `com.phonegap.battery` y el valor es`PGBattery`. + +9. Integrar cualquier código de proyectos especÃficos que tienes en tu respaldo de `AppDelegate.h` y `AppDelegate.m` en los archivos del AppDelegate nuevo. + +## Proyectos de modernización 0.9.6 a 1.0.0 + +1. Instale Cordova 1.0.0. + +2. Hacer un backup de `AppDelegate.m` y `AppDelegate.h` en su proyecto. + +3. Crear un nuevo proyecto. Usted necesitará algunos de los activos de este nuevo proyecto. + +4. Copie estos archivos desde el nuevo proyecto en su directorio de proyecto 0.9.6-based en el disco, reemplazando los viejos archivos (copia de seguridad de sus archivos primero desde el paso 2 anterior): + + AppDelegate.h + AppDelegate.m + MainViewController.h + MainViewController.m + MainViewController.xib + + +5. Añadir todos los `MainViewController` los archivos a su proyecto Xcode. + +6. Copia el `www/phonegap-1.0.0.js` archivo del nuevo proyecto en tu `www` Directorio y eliminar su `www/phonegap-0.9.6.js` archivo. + +7. 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 `phonegap-1.0.0.js` archivo. + +8. Añadir una nueva entrada en `Plugins` en el `PhoneGap.plist` archivo. La clave es `com.phonegap.battery` y el valor es`PGBattery`. + +9. Integrar cualquier código de proyectos especÃficos que tienes en tu respaldo de `AppDelegate.h` y `AppDelegate.m` en los archivos del AppDelegate nuevo. \ 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/webview.md ---------------------------------------------------------------------- diff --git a/www/docs/es/dev/guide/platforms/ios/webview.md b/www/docs/es/dev/guide/platforms/ios/webview.md new file mode 100644 index 0000000..62364b2 --- /dev/null +++ b/www/docs/es/dev/guide/platforms/ios/webview.md @@ -0,0 +1,152 @@ +--- +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 WebViews +--- + +# iOS WebViews + +Esta guÃa le muestra cómo incrustar un componente WebView Cordova habilitado dentro de una aplicación iOS más grande. Para más detalles sobre cómo estos componentes pueden comunicarse entre sÃ, vea aplicación Plugins. + +Apoyo WebViews iOS comenzó con Córdoba versión 1.4, usando un `Cleaver` para que sirve la plantilla de Xcode como una implementación de referencia del componente. Cordova 2.0 y versiones posteriores sólo admiten la implementación basada en el subproyecto Cleaver. + +Estas instrucciones requieren menos Cordova 3.x y Xcode 6.0, junto con un `config.xml` el archivo de un proyecto de iOS recién creado. Puede utilizar el procedimiento en la interfaz de lÃnea de comandos para crear un nuevo proyecto, y luego obtener el `config.xml` archivo de dentro del subdirectorio dentro de la aplicación llamado`platforms/ios`. + +Para seguir estas instrucciones, asegúrate de que tienes la última distribución de Córdoba. Descargar desde [cordova.apache.org][1] y descomprimir el paquete de iOS. + + [1]: http://cordova.apache.org + +## Cleaver agregando al proyecto Xcode (subproyecto CordovaLib) + +1. Deja de Xcode si se está ejecutando. + +2. Abra una terminal y desplácese hasta el directorio fuente para iOS Cordova. + +3. Copia el `config.xml` archivo descrito anteriormente en el directorio del proyecto. + +4. Abra Xcode y utilizar el buscador para copiar el `config.xml` archivo en la ventana de su **Navegador de proyectos** . + +5. Elija **crear grupos para cualquier añadidos carpetas** y pulse **Finalizar**. + +6. Utilice el buscador para copiar el `CordovaLib/CordovaLib.xcodeproj` archivo de Xcode **Navegador de proyectos** + +7. Seleccione `CordovaLib.xcodeproj` en el **navegador de proyectos**. + +8. Tipo de la combinación de teclas **Command-Option-1** para mostrar el **Inspector File**. + +9. Elegir **relativo al grupo** en el **Inspector de archivo** del menú desplegable para **Ubicación**. + +10. Seleccione el **icono de proyecto** en el **Navegador de proyectos**, seleccione el **destino**y seleccione la ficha **Configuración de construir** . + +11. Agregar `-force_load` y `-Obj-C` para el valor de **Otras banderas del vinculador** . + +12. Haga clic en el **icono de proyecto** en el navegador de proyectos, seleccione el **destino**y seleccione la ficha **Fases construir** . + +13. Ampliar **los binarios de enlace con las bibliotecas**. + +14. Seleccione el **+** botón y agregue los siguientes **Marcos**. Opcionalmente en el **Navegador de proyectos**, moverlos en el grupo de **Marcos** : + + AssetsLibrary.framework + CoreLocation.framework + CoreGraphics.framework + MobileCoreServices.framework + + +15. Ampliar **Las dependencias de destino**, el cuadro superior con esa etiqueta si hay más de una caja. + +16. Seleccione el **+** botón y agregar el `CordovaLib` construir el producto. + +17. Ampliar **Los binarios de enlace con las bibliotecas**, el cuadro superior con esa etiqueta si hay más de una caja. + +18. Seleccione el **+** botón y añadir `libCordova.a`. + +19. Fijar la **Xcode preferencias â ubicaciones â derivada datos â avanzado...** a **único**. + +20. Seleccione el **icono de proyecto** en el navegador de proyectos, selecciona tu **destino**y seleccione la ficha **Configuración de construir** . + +21. Búsqueda de **rutas de búsqueda encabezado**. Para esa configuración, agregar estos tres valores abajo, incluyendo las comillas: + + "$(TARGET_BUILD_DIR)/usr/local/lib/include" + "$(OBJROOT)/UninstalledProducts/include" + "$(BUILT_PRODUCTS_DIR)" + + + A partir de Cordova 2.1.0, `CordovaLib` ha sido actualizado para utilizar el **Conteo automático de referencia (ARC)**. No necesitas actualizar a **ARC** para utilizar `CordovaLib` , pero si desea actualizar su proyecto para utilizar **ARC**, debe usar el Asistente para migración de Xcode de la **Editar â Refactor â convertir en Objective-C arco...** menú, **anular la selección de libCordova.a**, luego ejecute el Asistente para completar. + +## Usando CDVViewController + +1. Agregue el siguiente encabezado: + + #import <Cordova/CDVViewController.h> + + +2. Instanciar un nuevo `CDVViewController` y consérvelo en algún sitio, por ejemplo, a una propiedad de clase: + + CDVViewController* viewController = [CDVViewController new]; + + +3. Opcionalmente, establezca el `wwwFolderName` propiedad, cuyo valor predeterminado es `www` : + + viewController.wwwFolderName = @"myfolder"; + + +4. Opcionalmente, configurar la página de inicio el `config.xml` del archivo `<content>` de la etiqueta, ya sea un archivo local: + + <content src="index.html" /> + + + .. .o un sitio remoto: + + <content src="http://apache.org"; /> + + +5. Opcionalmente, establezca el `useSplashScreen` propiedad, cuyo valor predeterminado es `NO` : + + viewController.useSplashScreen = YES; + + +6. Establecer el **marco de la vista**. Siempre definir esto como la última propiedad: + + viewController.view.frame = CGRectMake(0, 0, 320, 480); + + +7. Agregar la cuchilla a la vista: + + [myView addSubview:viewController.view]; + + +## Adición de HTML, CSS y JavaScript activos + +1. Crear un nuevo directorio dentro del proyecto, `www` por ejemplo. + +2. Coloque el HTML, CSS y JavaScript activos en este directorio. + +3. Utilice el buscador para copiar el directorio en la ventana del **Navegador de proyecto** de Xcode. + +4. Seleccione **crear carpeta referencias para cualquier añadidas carpetas**. + +5. Establecer la adecuada `wwwFolderName` y `startPage` las propiedades para el directorio creado inicialmente, o utilizar los valores predeterminados (especificados en la sección anterior) al crear instancias de la`CDVViewController`. + + /* + if you created a folder called 'myfolder' and + you want the file 'mypage.html' in it to be + the startPage + */ + viewController.wwwFolderName = @"myfolder"; + viewController.startPage = @"mypage.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/tizen/index.md ---------------------------------------------------------------------- diff --git a/www/docs/es/dev/guide/platforms/tizen/index.md b/www/docs/es/dev/guide/platforms/tizen/index.md new file mode 100644 index 0000000..848eab6 --- /dev/null +++ b/www/docs/es/dev/guide/platforms/tizen/index.md @@ -0,0 +1,118 @@ +--- +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 Tizen +--- + +# GuÃa de la plataforma Tizen + +Esta guÃa describe cómo configurar el entorno de desarrollo SDK para desplegar aplicaciones Cordova para dispositivos que ejecutan el sistema operativo de Tizen. + +## Requisitos y apoyo + +El SDK de Tizen requiere 10.04/10.10/11.04/11.10 Linux Ubuntu (32 bits) o Windows XP SP3/7 (32 bits). + +Los desarrolladores deben usar la utilidad de `cordova` en conjunción con el SDK de Tizen. Ver la interfaz de lÃnea de comandos para obtener información como instalarlo, agregar proyectos, entonces construir e implementar un proyecto. + +## Instalar el SDK + +Descargar el SDK de Tizen de [tizen.org][1]. + + [1]: https://developer.tizen.org/sdk + +<!-- + +- (optional) Install Tizen Cordova template projects: copy the + `/templates` directory content into the Tizen Eclipse IDE web + templates directory (e.g.: + `/home/my_username/tizen-sdk/IDE/Templates/web`). + +- __Method #2: Use Tizen Eclipse IDE Cordova Tizen project templates__ + - Launch Tizen Eclipse IDE + - Select __File → New → Tizen Web Project__ + - Select __User Template__ and __User defined__ items + - Select one of the Tizen Cordova template (e.g.: __CordovaBasicTemplate__) + - Fill the __Project name__ and its target __Location__ + +  + + - Click __Finish__ + +  + + - Your project should now appear in the __Project Explorer__ view + +--> + +## Abrir un proyecto en el SDK + +1. Lanzar el Tizen Eclipse IDE. + +2. Seleccione **archivo â Import â proyecto Tizen Web**: + + ![][2] + +3. Pulse **siguiente**. + +4. Asegúrese de **que seleccionar el directorio raÃz** está activada. + +5. Asegúrese de **que copiar proyectos en el área de trabajo** está marcada. + +6. Pulse en **Browse** y seleccione el directorio del proyecto Cordova Tizen `samples` (por ejemplo `/ cordova-basic`): + + ![][3] + +7. Pulse **Finish**. Su proyecto debe ahora ser importado y aparecen en la vista **Project Explorer**: + + ![][4] + + [2]: {{ site.baseurl }}/static/img/guide/platforms/tizen/import_project.png + [3]: {{ site.baseurl }}/static/img/guide/platforms/tizen/import_widget.png + [4]: {{ site.baseurl }}/static/img/guide/platforms/tizen/project_explorer.png + +Para reconstruir el proyecto, haga clic en la vista **Project Explorer** y seleccione **Build Project**: + +![][5] + + [5]: {{ site.baseurl }}/static/img/guide/platforms/tizen/build_project.png + +Debe generar un archivo de paquete de widget como *hello.wgt* en el directorio de raÃz del proyecto. + +## Desplegar en emulador + +Haga clic derecho en el proyecto en la vista **Project Explorer** y seleccione **Run As â Tizen Web Simulator Application**: + +![][6] + + [6]: {{ site.baseurl }}/static/img/guide/platforms/tizen/runas_web_sim_app.png + +## Desplegar en el dispositivo + +* Asegúrese de que el dispositivo de destino correctamente es lanzado, conectado y configurado. Su configuración de **fecha y hora** debe configurarse correctamente. + +* Utilice la vista **Connection Explorer** para seleccionar el objetivo del despliegue de aplicaciones: **Window â Show View â Connection Explorer**. + + ![][7] + +* Haga clic derecho en el proyecto en la vista **Project Explorer** y seleccione **Ejecutar como â Tizen Web Application**: + + ![][8] + + [7]: {{ site.baseurl }}/static/img/guide/platforms/tizen/connection_explorer.png + [8]: {{ site.baseurl }}/static/img/guide/platforms/tizen/runas_web_app.png http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/f061b980/www/docs/es/dev/guide/platforms/ubuntu/index.md ---------------------------------------------------------------------- diff --git a/www/docs/es/dev/guide/platforms/ubuntu/index.md b/www/docs/es/dev/guide/platforms/ubuntu/index.md new file mode 100644 index 0000000..2de6164 --- /dev/null +++ b/www/docs/es/dev/guide/platforms/ubuntu/index.md @@ -0,0 +1,97 @@ +--- +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 de Ubuntu +--- + +# GuÃa de la plataforma de Ubuntu + +## Versión inicial + +Bienvenido a la versión inicial del soporte para plataformas Ubuntu en Córdoba. Con este lanzamiento, el foco está desarrollando un sistema Ubuntu y utilizando el flujo de trabajo multiplataforma discutida en la descripción. Esto incluye la adición de la plataforma de Ubuntu a tu proyecto, añadiendo estándar Cordova plugins y construcción y ejecuta aplicaciones para la plataforma de Ubuntu. + +### SDK de Ubuntu + +También podrÃas instalar el entorno de desarrollo de Ubuntu QtCreator. Consulte [developer.ubuntu.com][1] para obtener más información. (El QtCreator SDK no es necesario añadir soporte de plataforma de Ubuntu a tu app Cordova). + + [1]: http://developer.ubuntu.com + +### Plataformas Ubuntu Runtime + +Ubuntu es conocida por su entorno de escritorio (para ordenadores portátiles, PCs y tal). Toque de Ubuntu se extiende el sistema operativo Ubuntu en teléfonos y tabletas. Ubuntu runtime plataformas tienen diferentes arquitecturas de CPU (x 86, armhf, etc..). Código de la aplicación y el plugin debe compilarse correctamente. Soporte para esta área amplia está evolucionando rápidamente en Ubuntu. + +### Información más reciente + +Para la información más reciente sobre la ayuda de la aplicación Cordova plataformas Ubuntu runtime, consulte [wiki.ubuntu.com/Cordova][2]. + + [2]: http://wiki.ubuntu.com/Cordova + +## Requisitos de plataforma de desarrollo + +Para esta versión inicial, la plataforma de desarrollo debe ser un escritorio de Ubuntu. Ubuntu 13.10 (alias 'picantes') o posterior es necesario para disfrutar de todo el conjunto de capacidades de apoyadas. + +Usted puede instalar Cordova en sistemas no-Ubuntu (usando npm), pero importantes capacidades se proporcionan únicamente a través de paquetes debian Ubuntu en este momento. + +## Instalación de Cordova + +Agregar el Ubuntu Cordova [Archivo Paquete Personal][3] a tu sistema Ubuntu: + + [3]: https://launchpad.net/~cordova-ubuntu/+archive/ppa + + $ sudo add-apt-repository ppa:cordova-ubuntu/ppa + $ sudo apt-get update + + +Instalar paquete cordova-cli (y sus dependencias): + + $ sudo apt-get install cordova-cli + + +## Proyecto de flujo de trabajo + +### Crear un proyecto + +Crea una aplicación en un `hello` directorio cuyo nombre es `HelloWorld` : + + $ cordova create hello com.example.hello HelloWorld + + +### Entrar en el directorio del proyecto + + $ cd hello + + +### Añadir la plataforma Ubuntu + + $ cordova platform add ubuntu + + +### Construir para Ubuntu + + $ cordova build ubuntu + + +### Ejecute la aplicación + + $ cordova run ubuntu + + +### Añadir el Plugin de cámara + + $ cordova plugin add cordova-plugin-camera \ No newline at end of file http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/f061b980/www/docs/es/dev/guide/platforms/win8/index.md ---------------------------------------------------------------------- diff --git a/www/docs/es/dev/guide/platforms/win8/index.md b/www/docs/es/dev/guide/platforms/win8/index.md new file mode 100644 index 0000000..caac193 --- /dev/null +++ b/www/docs/es/dev/guide/platforms/win8/index.md @@ -0,0 +1,234 @@ +--- +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 Windows +--- + +# GuÃa de la plataforma Windows + +Esta guÃa muestra cómo configurar el entorno de desarrollo SDK para construir y desplegar aplicaciones de Córdoba para Windows 8, Windows 8.1, Windows Phone 8.1 y Windows 10 plataforma de aplicación Universal. Muestra cómo utilizar herramientas shell para generar y construir aplicaciones o plataformas Cordova CLI discute en la interfaz de lÃnea de comandos. (Véase la introducción para una comparación de las opciones de desarrollo.) Esta sección también muestra cómo modificar Cordova aplicaciones dentro de Visual Studio. Independientemente de qué enfoque tomar, es necesario instalar el SDK de Visual Studio, como se describe a continuación. + +Consulte actualización de Windows 8 para obtener información sobre cómo actualizar los proyectos existentes de Windows 8 Cordova. + +Ventana teléfono 8 (wp8) permanece como una plataforma independiente, consulte Windows Phone 8 Platform Guide para obtener más detalles. + +Cordova WebViews corriendo en Windows dependen de Internet Explorer 10 (Windows 8.0) y Internet Explorer 11 (8.1 de Windows y Windows Phone 8.1) como su motor de renderizado, asà como en la práctica puede utilizar a potente depurador de IE para probar cualquier contenido web que no invoca Cordova APIs. El Blog de desarrolladores de Windows Phone proporciona una [guÃa útil][1] sobre cómo Soporte IE junto con navegadores WebKit comparables. + + [1]: http://blogs.windows.com/windows_phone/b/wpdev/archive/2012/11/15/adapting-your-webkit-optimized-site-for-internet-explorer-10.aspx + +## Requisitos y apoyo + +Para desarrollar aplicaciones para la plataforma Windows necesitas: + +* Una máquina Windows 8.1, 32 o 64 bits (ediciones *Home*, *Pro* o *empresa* ) con mÃnimo 4 GB de RAM. + +* Windows 8.0, 8.1 o 10, 32 o 64 bits *Home*, *Pro*o *Enterprise* Edition, junto con [Visual Studio 2012 Express][2] o Visual Studio 2013. Visual Studio 2015 no es capaz de construir aplicaciones Windows 8.0. + + [2]: http://www.visualstudio.com/downloads + +Para desarrollar aplicaciones para Windows 8.0 y 8.1 (incluyendo Windows Phone 8.1): + +* 8.1 de Windows o Windows 10, 32 o 64-bit *Home*, *Pro*o *Enterprise* Edition, junto con [Visual Studio 2013 Express][2] o superior. Una versión de evaluación de Windows 8.1 Enterprise está disponible desde la [Microsoft Developer Network][3]. + +* Para los emuladores de Windows Phone, edición profesional de Windows 8.1 (x 64) o superior y un procesador que soporte [cliente de Hyper-V y segundo nivel de dirección de traducción (listón)][4]. Una versión de evaluación de Windows 8.1 Enterprise está disponible desde [Microsoft Developer Network][3]. + +* [Visual Studio 2013 para Windows][5] (Expreso o superior). + + [3]: http://msdn.microsoft.com/en-US/evalcenter/jj554510 + [4]: https://msdn.microsoft.com/en-us/library/windows/apps/ff626524(v=vs.105).aspx#hyperv + [5]: http://www.visualstudio.com/downloads/download-visual-studio-vs#d-express-windows-8 + +Para desarrollar aplicaciones para Windows 10: + +* 8.1 de Windows o Windows 10 técnico vista previa 2, 32 - o 64-bit, junto con [Visual Studio 2015 RC][6] o superior. + + [6]: http://www.visualstudio.com/preview + +Compatibilidad de la aplicación se determina por el sistema operativo que la aplicación. Aplicaciones son compatibles hacia adelante pero no el compatible, asà que no se puede ejecutar una aplicación a Windows 8.1 en 8.0, pero se puede ejecutar una aplicación construida para 8.0 en 8.1. + +Siga las instrucciones en [windowsstore.com][7] para enviar la aplicación para Windows Store. + + [7]: http://www.windowsstore.com/ + +Para desarrollar aplicaciones de Córdoba para Windows, puede utilizar un PC con Windows, pero también puede desarrollar en un Mac, ya sea ejecutando un entorno de máquina virtual o usando Boot Camp a la partición de arranque dual un Windows 8.1. Consulte estos recursos para configurar el entorno de desarrollo requiere de Windows en un Mac: + +* [VMWare Fusion][8] + +* [Parallels Desktop][9] + +* [Boot Camp][10] + + [8]: http://msdn.microsoft.com/en-US/library/windows/apps/jj945426 + [9]: http://msdn.microsoft.com/en-US/library/windows/apps/jj945424 + [10]: http://msdn.microsoft.com/en-US/library/windows/apps/jj945423 + +## Uso de herramientas de Shell Cordova + +Si desea utilizar herramientas de Cordova centrado en Windows shell en conjunción con el SDK, tienes dos opciones básicas: + +* Acceder a ellos localmente de proyecto código generado por el CLI. Están disponibles en el `platforms/windows/` directorio después de agregar la plataforma `windows` como se describe a continuación. + +* Descargarlas desde una distribución independiente en [cordova.apache.org][11]. La distribución de Córdoba contiene archivos separados para cada plataforma. No olvide ampliar el archivo apropiado, `cordova-windows` en este caso, dentro de un directorio vacÃo. Las utilidades del lote correspondiente están disponibles en el directorio `package/bin` . (Si es necesario para instrucciones más detalladas, consulte el archivo **README** ). + + [11]: https://www.apache.org/dist/cordova/platforms/ + +Estas herramientas de shell le permiten crear, construir y ejecutar aplicaciones de Windows. 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. + +## Instalar el SDK + +Instalar cualquier edición de [Visual Studio][2] que empareja la versión requisitos enumerados anteriormente. + +![][12] + + [12]: {{ site.baseurl }}/static/img/guide/platforms/win8/win8_installSDK.png + +Para Windows, el instalador de Visual Studio tiene una opción para instalar las herramientas para construir aplicaciones Windows Universal. Debe asegurarse de que esta opción está seleccionada durante la instalación para instalar el SDK requiere. + +## Crear un nuevo proyecto + +En este punto, para crear un nuevo proyecto puede elegir entre la plataforma CLI herramienta descrita en la interfaz de lÃnea de comandos, o el conjunto de herramientas de shell de especÃficas de Windows. El enfoque CLI abajo genera una aplicación llamada *HelloWorld* dentro de un nuevo directorio de proyecto `hello` : + + > cordova create hello com.example.hello HelloWorld + > cd hello + > cordova platform add windows + + +Aquà es el enfoque de shell-herramienta de bajo nivel correspondiente: + + C:\path\to\cordova-windows\package\bin\create.bat C:\path\to\new\hello com.example.hello HelloWorld + + +Este proyecto apunta a Windows 8.1 como el destino por defecto OS. Puedes elegir destino 8.0 o 10.0 (véase "Versión de Windows de configurar destino") para todas las versiones o destino especÃfico de una versión especial durante cada generación. + +## Construir el proyecto + +Si está usando la CLI en desarrollo, el directorio del proyecto de nivel superior `www` directorio contiene los archivos de origen. Ejecutar cualquiera de estas dentro del directorio del proyecto para la reconstrucción de la aplicación: + + > cordova build + > cordova build windows # do not rebuild other platforms + > cordova build windows --debug # generates debugging information + > cordova build windows --release # signs the apps for release + + +Aquà es el enfoque de shell-herramienta de bajo nivel correspondiente: + + C:\path\to\project\cordova\build.bat --debug + C:\path\to\project\cordova\build.bat --release + + +El `clean` comando ayuda a eliminar directorios en preparación para la siguiente `build` : + + C:\path\to\project\cordova\clean.bat + + +## Configurar la versión de Windows blanco + +Por defecto `crear` comando produce dos paquetes: Windows 8.0 y 8.1 de Windows Phone. Para actualizar el paquete de Windows a la versión 8.1 que debe añadirse la siguiente configuración al archivo de configuración (`config.xml`). + + <preference name="windows-target-version" value="8.1" /> + + +Una vez que se agrega este comando `build` ajuste comenzará a producir paquetes Windows 8.1 y 8.1 de Windows Phone. + +### El parámetro --appx + +Usted puede decidir que usted quiere construir una versión particular de su aplicación a un determinado sistema operativo (por ejemplo, puede selecionar destino Windows 10 que quieres construir para Windows Phone 8.1). Para ello, puede utilizar el parámetro `--appx` : + + > cordova build windows -- --appx=8.1-phone + + +El sistema ignorará el sistema de preferencia en archivo config.xml de la versión de Windows de destino y estrictamente construir un paquete para Windows Phone 8.1. + +Los valores válidos para la bandera `--appx` son `8.1-win`, `8.1-phone`y `uap` (para Windows 10 aplicaciones Universal). Estas opciones también se aplican al comando `Ejecutar de Córdoba` . + +### Consideraciones para la versión de Windows de destino + +Windows 10 apoya un nuevo modo "Remote" para Córdoba aplicaciones (y HTML en general). Este modo permite aplicaciones mucho más libertad con respecto al uso de la manipulación del DOM y patrones comunes de la web como el uso de secuencias de comandos en lÃnea, pero no asà reduciendo el conjunto de capacidades de su aplicación puede usar cuando envÃa a la tienda pública de Windows. Para obtener más información acerca de Windows 10 y modo remoto, mirar la documentación de [Córdoba para Windows 10][13] . + + [13]: win10-support.md.html + +Cuando utiliza el modo remoto, los desarrolladores se anima a aplicar una polÃtica de contenido de seguridad (CSP) para su aplicación para evitar ataques de inyección de secuencia de comandos. + +## Desplegar la aplicación + +Para desplegar el paquete de Windows: + + > cordova run windows -- --win # explicitly specify Windows as deployment target + > cordova run windows # `run` uses Windows package by default + + +Para desplegar el paquete de Windows Phone: + + > cordova run windows -- --phone # deploy app to Windows Phone 8.1 emulator + > cordova run windows --device -- --phone # deploy app to connected device + + +Puede utilizar **cordova run windows --list** para ver todos los destinos disponibles y **cordova run windows --target=target_name \-- -|-phone** para ejecutar la aplicación en un dispositivo especÃfico o emulador (por ejemplo, `cordova run windows --target="Emulator 8.1 720P 4.7 inch" -- --phone`). + +También puede utilizar **cordova run --help** adicional construir y ejecutar opciones. + +## Abra el proyecto en el SDK y desplegar la aplicación + +Una vez que construyes una aplicación Cordova como se describe anteriormente, usted puede abrir con Visual Studio. Los distintos comandos de `build` generan un archivo de Visual Studio solución (*.sln*). Abra el archivo en el explorador de archivos para modificar el proyecto dentro de Visual Studio: + +![][14] + + [14]: {{ site.baseurl }}/static/img/guide/platforms/win8/win8_sdk_openSLN.png + +El componente de `CordovaApp` muestra dentro de la solución, y su directorio `www` contiene el código fuente basada en web, incluyendo la página `index.html` : + +![][15] + + [15]: {{ site.baseurl }}/static/img/guide/platforms/win8/win8_sdk.png + +Los controles debajo de menú principal de Visual Studio le permite probar o implementar la aplicación: + +![][16] + + [16]: {{ site.baseurl }}/static/img/guide/platforms/win8/win8_sdk_deploy.png + +Con la **Máquina Local** seleccionado, pulsaremos la flecha verde para instalar la aplicación en el mismo equipo que ejecuta Visual Studio. Una vez lo haces, la aplicación aparece en los listados de la aplicación de Windows 8: + +![][17] + + [17]: {{ site.baseurl }}/static/img/guide/platforms/win8/win8_sdk_runApp.png + +Cada vez que reconstruir la aplicación, se actualiza la versión disponible en la interfaz. + +Una vez disponible en la lista aplicación, manteniendo presionada la tecla **CTRL** mientras selecciona la aplicación le permite a prender a la pantalla principal: + +![][18] + + [18]: {{ site.baseurl }}/static/img/guide/platforms/win8/win8_sdk_runHome.png + +Tenga en cuenta que si usted abre la aplicación dentro de un entorno de máquina virtual, puede que necesite hacer clic en las esquinas o a lo largo de los lados de las ventanas para cambiar de aplicaciones o acceder a funciones adicionales: + +![][19] + + [19]: {{ site.baseurl }}/static/img/guide/platforms/win8/win8_sdk_run.png + +Alternativamente, elija la opción de despliegue de **simulador** para ver la aplicación como si estuviera ejecutando en un dispositivo tablet: + +![][20] + + [20]: {{ site.baseurl }}/static/img/guide/platforms/win8/win8_sdk_sim.png + +A diferencia de la implementación de escritorio, esta opción le permite simular la orientación de la tableta, ubicación, y variar su configuración de red. + +**Nota**: Consulte el [Resumen](../../overview/index.html) de consejos sobre cómo utilizar herramientas de lÃnea de comandos de Cordova o el SDK en su flujo de trabajo. El CLI Cordova se basa en código fuente entre plataformas que rutinariamente sobrescribe los archivos especÃficos para cada plataforma utilizados el SDK de. Si desea utilizar el SDK para modificar el proyecto, utilizar las herramientas de nivel inferior shell como una alternativa a la CLI. http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/f061b980/www/docs/es/dev/guide/platforms/win8/packaging.md ---------------------------------------------------------------------- diff --git a/www/docs/es/dev/guide/platforms/win8/packaging.md b/www/docs/es/dev/guide/platforms/win8/packaging.md new file mode 100644 index 0000000..2bd120c --- /dev/null +++ b/www/docs/es/dev/guide/platforms/win8/packaging.md @@ -0,0 +1,117 @@ +--- +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: Empaquetado de Windows +--- + +# Empaquetado de Windows + +Usted puede aprender más sobre firma y empaquetado de aplicaciones de la tienda de Windows en [MSDN](https://msdn.microsoft.com/en-us/library/hh446593(v=vs.85).aspx). + +Para poder correctamente y firmar Windows aplicaciones allà son pocas cosas necesarias: + + * Un certificado de firma + * Datos de identidad que empareja el certificado de firma suministrado + +En proyecto de Windows, datos de identidad se mantienen en un archivo llamado package.appxmanifest. Este archivo se rellena automáticamente cada vez que se construye una aplicación de Córdoba. Identidad tiene 3 campos importantes. + + * Name + * Publisher + * Version + +*Nombre* y la *versión* se pueden establecer desde **config.xml**. *Editor* puede ser proporcionado como un parámetro de compilación o pueden configurarse en el archivo **build.json** . + + + +Un certificado de firma puede proporcionar cualquier CLI o a través del archivo build.json. El certificado relacionado con CLI banderas son: + + * `--packageCertificateKeyFile` : una vez creado un paquete certificado de firma, este parámetro puede utilizarse para asociar el certificado de la aplicación. Este indicador toma una ruta de archivo como argumento. Por ejemplo. `> cordova build -- --packageCertificateKeyFile="platforms\windows\CordovaApp_TemporaryKey.pfx"` + * `-packageThumbprint` : huella digital del paquete se utiliza para validar la autenticidad del archivo clave del paquete certificado. Al crear un archivo de clave de certificado, este valor será proporcionado al usuario final. Por ejemplo. `> cordova build -- --packageCertificateKeyFile="platforms\windows\CordovaApp_TemporaryKey.pfx" --packageThumbprint="ABCABCABCABC123123123123"` + +Alternativamente, estos valores podrÃan especificarse utilizando un archivo de configuración de build (build.json) mediante CLI (--buildConfig). Un archivo de configuración de compilación de muestra: + + { + "windows": { + "debug": { + "packageCertificateKeyFile": "platforms\\windows\\CordovaApp_TemporaryKey.pfx" + }, + "release": { + "packageCertificateKeyFile": "c:\\path-to-key\\keycert.pfx", + "packageThumbprint": "ABCABCABCABC123123123123", + "publisherId": "CN=FakeCorp.com, L=Redmond, S=Washington, C=US" + } + } + } + + +También hay soporte para mezclar y combinar los argumentos de lÃnea de comandos y parámetros en el archivo build.json. Valores de los argumentos de lÃnea de comandos tendrá prioridad. + +# Cómo crear un certificado de clave y signo Cordova windows aplicaciones + +Firma se requiere para distribuir e instalar aplicaciones de Windows Store. Este proceso es manejado normalmente por Visual Studio al implementar un paquete de liberación. Para hacer tmhis sin Visual Studio necesitamos crear nuestros propios certificados. + +Para la creación de certificados debemos utilizar [makecert.exe](https://msdn.microsoft.com/en-us/library/ff548309(v=vs.85).aspx) util. Esta herramienta viene con el SDK de Windows y puede encontrarse en `%ProgramFiles(x86) %\Windows Kits\8.1\bin\x64` o `%ProgramFiles(x86) %\Windows Kits\8.1\bin\x86`. + +Lo primero que debemos hacer es crear una clave de root para firmar nuestra aplicación. + +`makecert.exe -n "CN=FakeCorp.com" -r -eku "1.3.6.1.5.5.7.3.3,1.3.6.1.4.1.311.10.3.13" -e "01/01/2020" âh 0 -sv FakeCorp.com.pvk FakeCorp.com.cer` + +Para entender qué makecert hace, aquà está una breve explicación de lo que hacen los parámetros: + + * -n "CN=FakeCorp.com": este es el nombre [X.509](http://en.wikipedia.org/wiki/X.509) certificado sujeto. En este ejemplo es **C**Common**N**ame=FakeCorp.com. + * -r: crea un [certificado auto firmado](http://en.wikipedia.org/wiki/Self-signed_certificate). + * -eku #EKU_VAL #: separado por comas mejorado uso clave OID. + * 1.3.6.1.5.5.7.3.3 indica que el certificado es válido para firma de código. Siempre especificar este valor para limitar el uso del certificado. + * 1.3.6.1.4.1.311.10.3.13 indica que el certificado de la respeta firma de toda la vida. Normalmente, si una firma es tiempo estampado, como el certificado era válido en el punto de la hora estampada, la firma sigue siendo válida incluso si el certificado caduca. Este EKU obliga la firma vencimiento independientemente de si la firma es tiempo de estampado. + * -e "01/01/2020": establece la fecha de expiración del certificado. + * -h 0: altura máxima del árbol debajo de este certificado se establece en 0 para impedir que el certificado se utiliza como una autoridad de certificación (CA) que pueden emitir otros certificados. + * sv - FakeCorp.com.pvk: salida PVK archivo. Windows utiliza PVK archivos para almacenar las claves privadas de firma de código. + * FakeCorp.com.cer: Archivo de certificado de salida. Archivo CER se utiliza para almacenar el certificado X.509. + +Después de ejecutar makecert por primera vez, introduzca la clave privada en la pantalla que aparece: + + + +Una vez creado el archivo cer y pvk, necesitamos crear un archivo pfx de estos certificados. Un archivo pfx (formato de intercambio de Personal) contiene una variedad de información criptográfica, como certificados, certificados de autoridad raÃz, cadenas de certificados y claves privadas. Para paquete de los certs, utilizaremos la herramienta llamada [pvk2pfx](https://msdn.microsoft.com/en-us/library/ff550672(v=vs.85).aspx). Esta herramienta viene con el SDK de Windows y puede encontrarse en `%ProgramFiles(x86)%\Windows Kits\8.1\bin\x64` o`%ProgramFiles(x86)%\Windows Kits\8.1\bin\x86`. + +`pvk2pfx -pvk FakeCorp.com.pvk -pi pvkPassword -spc FakeCorp.com.cer -pfx FakeCorp.com.pfx -po pfxPassword` + +Donde: + + * PVK: nombre del archivo de entrada pvk + * PI: pvk contraseña + * SPC: nombre del archivo de entrada cert + * pfx: nombre del archivo pfx de salida + * po: contraseña pfx; igual pvk contraseña si no dispone de + +Si ofrecemos este archivo pfx archivo de build.json, tenemos el siguiente error: "el archivo de llave puede ser protegido con contraseña. Para corregir esto, intente importar manualmente el certificado en el almacén de certificados personales del usuario actual. ". Para importar tenemos que utilizar [certutil](https://technet.microsoft.com/en-us/library/ee624045(v=ws.10).aspx) desde un sÃmbolo del sistema de administración: + +`certutil -user -p PASSWORD -importPFX FakeCorp.com.pfx` + +Donde: + + * user: especifica "usuario actual" almacén personal + * p: contraseña para el archivo pfx + * importPfx: nombre de archivo pfx + +Una vez instalado, el siguiente paso es agregar packageThumbprint y packageCertificateKeyFile a build.json. Para encontrar la packageThumbprint, buscar el CommonName nos hemos asociado con el certificado: + +`powershell -Command " & {dir -path cert:\LocalMachine\My | where { $_.Subject -like \"*FakeCorp.com*\" }}"` + +Una vez que estos últimos valores son proporcionados. Córdoba con éxito debe paquete y firmar la aplicación. --------------------------------------------------------------------- To unsubscribe, e-mail: commits-unsubscr...@cordova.apache.org For additional commands, e-mail: commits-h...@cordova.apache.org
