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.

Guida alla piattaforma Windows

Questa guida illustra come impostare il vostro ambiente di sviluppo SDK per creare e distribuire applicazioni Cordova per Windows 8, Windows 8.1 e 8.1 di Windows Phone. Viene illustrato come utilizzare strumenti shell per generare e compilare applicazioni o piattaforme Cordova CLI discusso in l‘interfaccia della riga di comando. (Vedi la panoramica per un confronto di queste opzioni di sviluppo). In questa sezione viene illustrato anche come modificare Cordova apps all’interno di Visual Studio. Indipendentemente da quale approccio si prende, è necessario installare Visual Studio SDK, come descritto di seguito.

Per informazioni su come aggiornare progetti esistenti di Windows 8 Cordova, vedere l'aggiornamento di Windows 8.

Finestra telefono 8 (wp8) soggiorni come una piattaforma separata, per dettagli, vedere Guida piattaforma Windows Phone 8.

Cordova WebViews in esecuzione su Windows si basano su Internet Explorer 10 (Windows 8) e Internet Explorer 11 (8.1 di Windows e Windows Phone 8.1) come loro motore di rendering, quindi in pratica è possibile utilizzare il debugger potente di IE per testare qualsiasi contenuto web che non richiama Cordova APIs. Il Windows Phone Developer Blog fornisce consigli utili su come supporto IE insieme paragonabile browser WebKit.

Requisiti e supporto

Hai bisogno di una delle seguenti combinazioni di OS/SDK, da un disco di installazione o da un file di immagine disco ISO .

Per sviluppare applicazioni per Windows 8.0 solo:

Sviluppare applicazioni per tutte le piattaforme (Windows 8.0, 8.1 di Windows e Windows Phone 8.1):

Fare applicazioni compilate sotto Windows 8.1 non eseguire sotto Windows 8.0. Le applicazioni compilate sotto Windows 8.0 sono compatibili con con 8.1.

Seguire le istruzioni a windowsstore.com presentare all'app di Windows Store.

Per sviluppare applicazioni di Cordova per Windows, si può utilizzare un PC con Windows, ma può anche sviluppare su un Mac, eseguendo un ambiente di macchina virtuale o tramite Boot Camp per la partizione di dual-boot un 8.1 di Windows. Consultare queste risorse per impostare l'ambiente di sviluppo richiesto Windows su un Mac:

Utilizzando strumenti di Cordova Shell

Se si desidera utilizzare strumenti shell di Windows-centrata di Cordova in concomitanza con il SDK, hai due opzioni di base:

  • Accedervi localmente dal progetto codice generato da CLI. Essi sono disponibili nelle platforms/windows/cordova directory dopo aver aggiunto la windows piattaforma come descritto di seguito.

  • Download da una distribuzione separata presso cordova.apache.org. La distribuzione di Cordova contiene archivi separati per ciascuna piattaforma. Assicurarsi di espandere l‘archivio appropriato, cordova-windows\windows in questo caso, all’interno di una directory vuota. Il lotto rilevante utilità sono disponibili nel primo livello bin directory. (Se necessario per indicazioni più dettagliate, consultare il file Leggimi .)

Questi strumenti shell consentono di creare, compilare ed eseguire le applicazioni Windows. Per informazioni sull'interfaccia della riga di comando aggiuntiva che attiva il plugin funzionalità su tutte le piattaforme, vedere utilizzando Plugman per gestire i plugin.

Installare il SDK

Installare la Ultimate, Premiumo Professional 2013 edizioni di Visual Studio.

Creare un nuovo progetto

A questo punto, per creare un nuovo progetto può scegliere tra il multipiattaforma CLI strumento descritto in l‘interfaccia della riga di comando, o il set di strumenti di shell di Windows specifici. All’interno di una directory del codice sorgente, questo approccio CLI genera un‘app denominata HelloWorld all’interno di un nuovo hello directory di progetto:

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

Qui è l'approccio di shell-strumento di basso livello corrispondente:

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

Compilare il progetto

Se si utilizza la CLI nello sviluppo, nella directory del progetto di primo livello www directory contiene i file di origine. Eseguire uno di questi all‘interno della directory di progetto per ricostruire l’app:

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

Una volta che si genera il progetto, la sorgente dell'app predefinita è disponibile nella projects\windows\www sottodirectory. Comandi successivi sono disponibili nelle cordova sottodirectory allo stesso livello.

Il build comando pulisce i file di progetto e ricostruisce l'app. Il primo esempio genera informazioni di debug, e la seconda firma le apps per il rilascio:

    C:\path\to\project\cordova\build.bat --debug        
    C:\path\to\project\cordova\build.bat --release

Il clean comando aiuta a scovare le directory in preparazione per la prossima build :

    C:\path\to\project\cordova\clean.bat

Configurare la versione di Windows di destinazione

Per impostazione predefinita build comando produce due pacchetti: Windows 8.0 e 8.1 di Windows Phone. Per aggiornare il pacchetto di Windows alla versione 8.1 è necessario aggiungere la seguente impostazione di configurazione (file di configurazioneconfig.xml).

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

Dopo aver aggiunto questa impostazione build comando inizierà a produrre pacchetti Windows 8.1 e 8.1 di Windows Phone.

Distribuire l'applicazione

Per distribuire il pacchetto di Windows Phone:

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

Per distribuire il pacchetto di Windows:

    > cordova run windows -- --win  # explicitly specify Windows as deployment target
    > cordova run windows # `run` uses Windows package by default

Aprire il progetto in SDK e distribuire l'applicazione

Una volta che si compila una app di Cordova come descritto sopra, è possibile aprirlo con Visual Studio. I vari build comandi generano un file di Visual Studio di soluzione (sln). Aprire il file in Esplora File per modificare il progetto all'interno di Visual Studio:

Il CordovaApp componente viene visualizzato all'interno della soluzione e la sua www directory contiene il codice sorgente basato su web, tra cui la index.html homepage:

I controlli sotto il menu principale di Visual Studio consentono di testare o distribuire l'applicazione:

Con Locale macchina selezionata, premere la freccia verde per installare le app sulla stessa macchina che esegue Visual Studio. Una volta si fa così, l'app compare in elenchi di app di Windows 8:

Ogni volta che si ricostruisce l‘app, viene aggiornata la versione disponibile nell’interfaccia.

Una volta disponibili nei listati di app, tenendo premuto il tasto CTRL mentre si selezionano le app ti permette di aggiungerlo alla schermata principale:

Si noti che se si apre l‘applicazione all’interno di un ambiente di macchina virtuale, potrebbe essere necessario fare clic su negli angoli o lungo i lati delle finestre per avviare applicazioni oppure accedere a funzionalità aggiuntive:

Alternativamente, scegliere l‘opzione di distribuzione del simulatore per visualizzare l’app come se fossero in esecuzione su un dispositivo tablet:

A differenza della distribuzione desktop, questa opzione consente di simulare l'orientamento della tavoletta, posizione e variare le impostazioni di rete.

Nota: consultare la panoramica per consigli su come utilizzare il SDK o strumenti da riga di comando di Cordova nel vostro flusso di lavoro. Cordova CLI si basa sul codice sorgente della multipiattaforma che ordinariamente sovrascrive i file specifici di piattaforma utilizzati dal SDK. Se si desidera utilizzare il SDK per modificare il progetto, utilizzare gli strumenti di basso livello shell come alternativa alla CLI.