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.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 sobre cómo Soporte IE junto con navegadores WebKit comparables.

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.
Para los emuladores de Windows Phone, Professional edition 8.1 Windows (x 64) o superior y un procesador que soporta cliente Hyper-V y segundo nivel de dirección de traducción (listón). Una versión de evaluación de Windows 8.1 Enterprise está disponible desde la Microsoft Developer Network.
2013 Visual Studio para Windows (Expresa o superior).

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

Instalar el SDK

Instalar la Ultimate, Premium o las ediciones de Visual Studio Professional 2013.

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/ directorio después de agregar la plataforma windows 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 en este caso, dentro de un directorio vacío. Las utilidades por lotes correspondientes están disponibles en el directorio package/bin . (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.

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. El enfoque CLI abajo genera una aplicación denominada HelloWorld dentro de un nuevo directorio del proyecto hello :

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

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

    C:\path\to\cordova-windows\package\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
    > cordova build windows   --debug    # generates debugging information
    > cordova build windows   --release  # signs the apps for release

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

    C:\path\to\project\cordova\build.bat --debug        
    C:\path\to\project\cordova\build.bat --release
    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. Actualizar paquete de Windows a la versión 8.1 que debe agregarse 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 ajuste construir comenzará a producir paquetes 8.1 de Windows y Windows Phone 8.1.

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 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 un emulador (por ejemplo, cordova run windows --target = "Emulador 8.1 720 P 4,7 inch" -- --phone).

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

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

El componente 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 :

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.