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.

Guía de la plataforma Windows

Esta guía le muestra cómo configurar el entorno de desarrollo SDK para construir y desplegar aplicaciones Cordova para Windows 8, Windows 8.1 y 8.1 de Windows Phone. Muestra cómo utilizar herramientas shell para generar y construir aplicaciones o plataformas Cordova CLI discuten en la interfaz de línea de comandos. (Véase la introducción para una comparación de estas opciones de desarrollo). Esta sección también muestra cómo modificar Cordova apps dentro de Visual Studio. Independientemente de qué enfoque toma, necesitas 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) 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 sobre cómo Soporte IE junto con navegadores WebKit comparables.

Requisitos y apoyo

Necesitas una de las siguientes combinaciones de OS/SDK, ya sea de un disco de instalación o un archivo de imagen de disco ISO .

Para desarrollar aplicaciones para Windows 8.0 solamente:

Para desarrollar aplicaciones para todas las plataformas (Windows 8.0, 8.1 de Windows y Windows Phone 8.1):

Hacer aplicaciones compiladas bajo Windows 8.1 no corre bajo Windows 8.0. Aplicaciones compiladas bajo Windows 8.0 son compatibles hacia adelante con 8.1.

Siga las instrucciones en windowsstore.com para someter la aplicación para Windows Store.

Para desarrollar aplicaciones de Córdoba para Windows, puede utilizar un PC con Windows, pero también puede desarrollar en un Mac, o mediante el uso de Boot Camp a la partición de arranque dual un 8.1 de Windows mediante la ejecución de un entorno de máquina virtual. Consulte estos recursos para configurar el entorno de desarrollo requiere de Windows en un Mac:

Utilizando 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 desde proyecto código generado por el CLI. Están disponibles en el platforms/windows/cordova Directorio después de agregar la windows plataforma como se describe a continuación.

  • Descárguelos desde una distribución independiente en cordova.apache.org. La distribución de Cordova contiene archivos separados para cada plataforma. Asegúrese de expandir el archivo apropiado, cordova-windows\windows en este caso, dentro de un directorio vacío. Las utilidades por lotes correspondientes están disponibles en el nivel superior bin Directorio. (Si es necesario para obtener instrucciones más detalladas, consulte el archivo README ).

Estas herramientas de shell le permiten crear, construir y ejecutar aplicaciones 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 la Ultimate, Premiumo las ediciones de Visual Studio Professional 2013.

Crear un nuevo proyecto

En este punto, para crear un nuevo proyecto puede elegir entre la herramienta de la cruz-plataforma CLI que se describe en la interfaz de línea de comandos, o el conjunto de herramientas específicas de Windows shell. Desde dentro de un directorio del código fuente, este enfoque CLI genera una aplicación denominada HelloWorld dentro de un nuevo hello Directorio del proyecto:

    > cordova create hello com.example.hello HelloWorld
    > cd hello
    > cordova platform add windows
    > cordova build

Este es el enfoque de shell-herramienta de nivel inferior correspondiente:

    C:\path\to\cordova-win\bin\create.bat C:\path\to\new\hello com.example.hello HelloWorld

Construir el proyecto

Si utilizas la CLI en el desarrollo, el directorio del proyecto es de alto nivel www directorio contiene los archivos de origen. Ejecutar cualquiera de éstos dentro del directorio del proyecto para la reconstrucción de la aplicación:

    > cordova build
    > cordova build windows   # do not rebuild other platforms

Una vez que se genera el proyecto, fuente de la aplicación por defecto está disponible en el projects\windows\www subdirectorio. Los comandos están disponibles en el cordova subdirectorio en el mismo nivel.

El build comando limpia archivos de proyecto y reconstruye la aplicación. El primer ejemplo genera información de depuración, y la segunda firma las aplicaciones para el lanzamiento:

    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 build 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 debe agregarse la siguiente configuración (archivo de configuraciónconfig.xml).

    <preference name='windows-target-version' value='8.1' />

Una vez que se agrega este ajuste build comando comenzará a producir paquetes 8.1 de Windows y Windows Phone 8.1.

Desplegar la aplicación

Para desplegar el paquete Windows Phone:

    > cordova run windows -- --phone  # deploy app to Windows Phone 8.1 emulator
    > cordova run windows --device -- --phone  # deploy app to connected device

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

Abra el proyecto en el SDK y desplegar la aplicación

Una vez que construyes una aplicación Cordova como se describió anteriormente, puedes abrirlo con Visual Studio. El vario build comandos de 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:

El CordovaApp componente muestra dentro de la solución y su www directorio contiene el código fuente basada en web, incluyendo el index.html página de Inicio:

Los controles debajo del menú principal de Visual Studio permiten probar o desplegar la aplicación:

Con la Máquina Local seleccionado, pulse la flecha verde para instalar la aplicación en la misma máquina ejecutando Visual Studio. Una vez lo haces, la aplicación aparece en los listados de la aplicación de Windows 8:

Cada vez que reconstruir la aplicación, se actualiza la versión disponible en la interfaz.

Una vez disponibles en los listados de la aplicación, manteniendo presionada la tecla CTRL mientras selecciona la aplicación le permite culpar a la pantalla principal:

Tenga en cuenta que si se abre la aplicación dentro de un entorno de máquina virtual, necesite hacer clic en las esquinas o a lo largo de los lados de las ventanas para cambiar aplicaciones o acceder a funciones adicionales:

Alternativamente, seleccione la opción de despliegue de simulador para ver la aplicación como si se estaban ejecutando en un dispositivo de tableta:

A diferencia de la implementación de escritorio, esta opción permite simular la orientación de la tableta, ubicación, y variar su configuración de red.

Nota: consulte el Resumen de consejos sobre cómo usar herramientas de línea de comandos de Cordova o el SDK en su flujo de trabajo. Cordova CLI se basa en código multiplataforma que rutinariamente sobrescribe los archivos específicos a una plataforma utilizados por el SDK. Si desea utilizar el SDK para modificar el proyecto, utilice las herramientas de shell de nivel inferior como una alternativa a la CLI.