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.

iOS Platform Guide

Esta guía le muestra cómo configurar el entorno de desarrollo SDK para desplegar aplicaciones Cordova para dispositivos iOS como el iPhone y iPad. Vea el siguiente para obtener más información específica de la plataforma:

  • iOS configuración
  • Actualizar iOS
  • iOS WebViews
  • iOS Plugins
  • iOS herramientas de línea de comandos

Las herramientas de línea de comandos anteriores se refieren a las versiones anteriores Cordova 3.0. Ver la interfaz de línea de comandos para obtener información sobre la interfaz actual.

Requisitos y apoyo

Apple ® herramientas necesarias para crear aplicaciones de iOS ejecutar sólo en el sistema operativo OS X Macs basados en Intel. Xcode ® 6.0 (la versión mínima requerida) se ejecuta en OS X versión 10.9 (Mavericks) o mayor e incluye el iOS 8 SDK (Software Development Kit). Presentar aplicaciones para el Apple App Store℠ requiere las últimas versiones de las herramientas de Apple.

Muchas de las características de Cordova usando el emulador de iOS instalado con el iOS SDK y Xcode puede probar, pero necesitas un dispositivo real para completamente todas las características de la aplicación dispositivo de prueba antes de presentar a la App Store. El dispositivo debe tener por lo menos iOS 6.x instalado, la versión de iOS mínimo apoyado desde Cordova 3.0. Dispositivos de apoyo incluyen todos iPad ® modelos, iPhone ® 3GS y arriba y iPod ® Touch de 3ª generación o posterior. Para instalar aplicaciones en un dispositivo, también debe ser un miembro de Apple iOS Developer Program, que cuesta $99 por año. Esta guía le muestra cómo implementar aplicaciones para el emulador de iOS, para lo cual no debes registrarte con el programa de desarrolladores.

Las herramientas ios-sim y ios-deploy - le permiten lanzar aplicaciones iOS en el simulador de iOS y dispositivo iOS desde la línea de comandos.

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 .

Instalar implementar herramientas

Ejecutar desde la terminal de línea de comandos:

    $ npm install -g ios-sim
    $ npm install -g ios-deploy

Crear un nuevo proyecto

La utilidad cordova para configurar un nuevo proyecto, tal como se describe en la Cordova del interfaz de comandos. Por ejemplo, en un directorio del código fuente:

    $ cordova create hello com.example.hello "HelloWorld"
    $ cd hello
    $ cordova platform add ios
    $ cordova prepare              # or "cordova build"

Desplegar la aplicación

Para desplegar la aplicación en un dispositivo iOS conectado:

    $ cordova run ios --device

Para desplegar la aplicación en un emulador de iOS por defecto:

    $ cordova emulate ios

Puede usar cordova run ios --list para ver todos los destinos disponibles y cordova run ios --target=target_name para ejecutar la aplicación en un dispositivo específico o un emulador (por ejemplo, cordova run ios --target="iPhone-6").

También puede utilizar cordova run --help para ver opciones adicionales para construir y correr.

Abrir un proyecto en el SDK

Una vez que la plataforma ios es añadido a su proyecto, puede abrir desde dentro de Xcode. Haga doble clic para abrir el archivo hello/platforms/ios/hello.xcodeproj . La pantalla debe verse así:

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 últimas versiones de iPhone y iPad. Las versiones más antiguas pueden estar disponibles en el Xcode → preferencias → descargas → componentes panel.

Desplegar en el dispositivo

Para obtener más información acerca de varios requisitos para implementar en un dispositivo, consulte la sección 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

Descarte las advertencias: cuando una aplicación es modificada o sustituida por otra API interfaz de programación (API), que está marcado como obsoleto. La API todavía funciona en el corto plazo, pero eventualmente se retira. Algunas de estas interfaces obsoletas se reflejan en Apache Cordova y Xcode emite advertencias sobre ellos cuando construir y desplegar una aplicación.

ADVERTENCIA de Xcode sobre el método invokeString refiere a una funcionalidad que lanza una app desde una dirección URL personalizada. Mientras que el mecanismo para cargar desde una dirección URL personalizada ha cambiado, este código todavía está presente para proporcionar la funcionalidad al revés para aplicaciones creadas con versiones anteriores de Córdoba. La aplicación muestra no utiliza esta funcionalidad, así que estas advertencias pueden ser ignoradas. Para evitar que aparezcan estas advertencias, quitar el código que hace referencia a la invokeString obsoleta API:

  • Editar el archivo Classes/MainViewController.m, rodean el siguiente bloque de código con / * y * / comentarios como se muestra a continuación, escriba el Comando-s para guardar el archivo:

    (void)webViewDidFinishLoad:(UIWebView*)theWebView
{
// only valid if ___PROJECTNAME__-Info.plist specifies a protocol to handle
/*
if (self.invokeString) {
  // this is passed before the deviceready event is fired, so you can access it in js when you receive deviceready
  NSLog(@"DEPRECATED: window.invokeString - use the window.handleOpenURL(url) function instead, which is always called when the app is launched through a custom scheme url.");
  NSString* jsString = [NSString stringWithFormat:@"var invokeString = \"%@\";", self.invokeString];
  [theWebView stringByEvaluatingJavaScriptFromString:jsString];
}
*/
// Black base color for background matches the native apps
theWebView.backgroundColor = [UIColor blackColor];

return [super webViewDidFinishLoad:theWebView];
}

  • Editar el archivo Classes/AppViewDelegate.m, comentar la siguiente línea insertando una doble barra como se muestra abajo, a continuación, escriba el comando + s para guardar el archivo:

    //self.viewController.invokeString = invokeString;

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

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