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:

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 iOS ejecutar sólo en el sistema operativo OS X de Mac basados en Intel. Xcode ® 4.5 (la versión mínima requerida) se ejecuta en OS X versión 10.7 (Lion) o mayor e incluye el iOS 6 SDK (Software Development Kit). Presentar aplicaciones para el Apple App Store℠ requiere las últimas versiones de las herramientas de Apple.

Usted puede probar muchas de las características de Cordova usando el emulador de iOS instalado con el iOS SDK y Xcode, pero necesita un dispositivo real a 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 5.x instalado, la versión de iOS mínimo apoyado desde Cordova 2.3. 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, que cuesta $99 por año. Esta guía le muestra cómo implementar aplicaciones para el emulador de iOS, para lo cual no tienes que registrar con el programa para desarrolladores.

Instalar el SDK

Hay dos maneras de descargar Xcode:

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 preferenciasy 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 .

Abrir un proyecto en el SDK

Uso el cordova utilidad para configurar un nuevo proyecto, como se describe en la Córdoba 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"

Una vez creado, puede abrir desde dentro de Xcode. Haga doble clic para abrir el hello/platforms/ios/hello.xcodeproj archivo. La pantalla debe verse así:

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í:

  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:

    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.

Xcode viene liado con emuladores para las ultimas 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 configuración de desarrollo y distribución de activos de Herramientas de flujo de trabajo guía para iOSde Apple. Brevemente, necesitas hacer lo siguiente antes de implementar:

  1. Únete a la Apple iOS Developer Program.

  2. Crear un Perfil de Provisioning dentro del iOS Provisioning Portal. 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.

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

Deprecation avisos: Cuando una aplicación de interfaz de programación (API) es cambiado o reemplazado por otro API, es 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.

Xcode de la advertencia sobre el invokeString método 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:

  • Edite 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:

    theWebView:(UIWebView*) webViewDidFinishLoad (void) {/ / sólo son válidas si ___PROJECTNAME__-Info.plist especifica un protocolo para manejar / * si (self.invokeString) {/ / se pasa antes de que se desencadena el evento deviceready, así que se puede acceder en js cuando Recibes deviceready NSLog (@"DEPRECATED: window.invokeString - utilice la función window.handleOpenURL(url), que siempre se llama cuando la aplicación se ejecuta a través de una url de esquema personalizado.");
  NSString * jsString = [NSString stringWithFormat:@"var invokeString = \" % @\ ";", self.invokeString];
  [theWebView stringByEvaluatingJavaScriptFromString:jsString];
} * / / / Base color negro para fondo coincide con las aplicaciones nativas theWebView.backgroundColor = [UIColor blackColor];

retorno [super webViewDidFinishLoad: theWebView];
}

  • Edite 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;

  • Pulse comando + b para reconstruir el proyecto y eliminar las advertencias.

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í:

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:

(Mac ® OS X ®, Apple ®, Xcode, App Store℠, iPad ®, iPhone ®, iPod ® y Finder ® son marcas registradas de Apple Inc.)