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.

Windows プラットフォームのガイド

このガイドは、SDK の開発環境構築および Windows 8、Windows 8.1 および Windows Phone 8.1 Cordova アプリを展開するを設定する方法を示します。ツールを使用してどちらかシェルを生成し、アプリケーションを構築する方法を示しています。またはクロスプラットフォームコルドバ CLI コマンドラインインターフェイスでの議論。（これらの開発オプション比較の概要」を参照）。また、Visual Studio 内で Cordova アプリを変更する方法についても説明します。どちらの作成方法に関係なく下記のような Visual Studio SDK をインストールする必要はあります。

既存の Windows 8 コルドバプロジェクトをアップグレードする方法の詳細については、Windows 8 のアップグレードを参照してください。

別のプラットフォームとしてのウィンドウ携帯電話 8 (wp8）滞在詳細については Windows Phone 8 プラットフォームガイド参照してください。

コルドバ web 表示の Windows で実行されているインターネットエクスプローラー 10 (Windows 8.0) と依存インターネットエクスプローラー 11 (Windows 8.1 および Windows Phone 8.1) そのレンダリングエンジンとして、実際の問題としてコルドバ Api の呼び出しは、web コンテンツをテストする IE の強力なデバッガーを使用できるようにします。 Windows Phone 開発者ブログサポート IE と同等の WebKit ブラウザーと一緒にする方法の有益なガイダンスを提供します。

要件、およびサポート

Windows プラットフォーム用のアプリを開発するには、必要があります。

最低 4 GB の RAM と Windows 8.1 では、32 ビットまたは 64 ビットマシン (ホーム、 Pro、またはエンタープライズエディション)。
Windows Phone エミュレーターは、Windows の 8.1 （64）プロフェッショナル・エディションのためまたはクライアント HYPER-V と第 2 レベルアドレス変換 (SLAT)をサポートする、高いとプロセッサ。 Windows 8.1 エンタープライズの評価版はマイクロソフトの開発者ネットワークから利用可能.
Windows 用の visual Studio 2013(エクスプレスまたはより高い)。

Windows 8.1 でコンパイルしたアプリケーションはいないWindows 8.0 の下で実行します。Windows 8.0 でコンパイルしたアプリケーションは転送-互換性のある 8.1 で。

Windows ストアにアプリを提出するwindowsstore.comに記載された手順に従ってください。

Windows の Cordova アプリを開発する Windows を実行して PC を使用する可能性がありますが、仮想マシン環境を実行して、またはを使用してブートキャンプをデュアルブート Windows 8.1 パーティションも mac では、開発可能性があります。 Mac で必要な Windows 開発環境を設定するこれらのリソースを参照してください。

SDK をインストールします。

究極、プレミアム、またはVisual StudioのProfessional 2013 エディションをインストールします。.

コルドバのシェル・ツールを使用してください。

SDK と一緒にコルドバの Windows 中心のシェル・ツールを使用する場合は、2 つの基本的なオプションがあります。

CLI で生成されたプロジェクトコードからローカルアクセスします。利用できる、プラットフォーム/windows/ディレクトリ以下に示すように、 windowsプラットフォームを追加した後。
Cordova.apache.orgで別のディストリビューションからそれらをダウンロードします。コルドバ分布にはプラットフォームごとに別々のアーカイブが含まれています。必ず、空のディレクトリ内でこの場合、適切なアーカイブ、コルドバ windowsを展開してください。関連するバッチユーティリティをパッケージ/binディレクトリで利用できます。 (より詳細な指示が必要な場合は、 READMEファイルを参照して)。

これらのシェルのツールを作成、構築、および Windows アプリケーションを実行することができます。すべてのプラットフォームのプラグイン機能を有効にする追加のコマンドラインインターフェイスについては、管理プラグインを使用して Plugman を参照してください。

新しいプロジェクトを作成します。

この時点で、新しいプロジェクトを作成する、コマンドラインインターフェイスまたは特定の Windows シェルツールのセットで説明するクロスプラットフォーム CLI ツールの間に選択できます。以下の CLI アプローチ新しいハロープロジェクトディレクトリ内にHelloWorldという名前をアプリケーションが生成されます。

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

ここでは、対応する下位レベルシェルツールアプローチ：

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

プロジェクトをビルドします

開発で CLI を使用している場合は、プロジェクトディレクトリの最上位 www ディレクトリにソースファイルが含まれています。アプリを再構築するには、プロジェクトディレクトリ内のこれらのいずれかを実行します。

    > 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

ここでは、対応する下位レベルシェルツールアプローチ：

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

対象の Windows のバージョンを構成します。

既定のビルドによってコマンドは 2 つのパッケージが生成されます: Windows 8.0 と Windows Phone 8.1。コンフィグレーションファイル (config.xmlに次の構成設定を追加する必要がありますバージョン 8.1 への Windows パッケージをアップグレードするには).

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

追加するこの設定ビルドコマンドが Windows 8.1 および Windows Phone 8.1 のパッケージの生産を開始します。

アプリを展開します。

パッケージを展開する Windows:

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

パッケージを展開する Windows Phone:

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

cordova run windows --listすべての利用可能なターゲットを使用とcordova run windows --target=target_name -- -|-phone、特定のデバイスまたはエミュレーターでアプリケーションを実行する (たとえば、cordova run windows --target="Emulator 8.1 720P 4.7 inch" -- --phone).

コルドバの実行 - ヘルプを使用して、追加のビルドを参照してください、オプションを実行することもできます。

SDK でプロジェクトを開き、アプリを展開します。

一度上記のように Cordova アプリをビルドする Visual Studio で開くことができます。さまざまなビルドのコマンドは、Visual Studio のソリューション (.sln) ファイルを生成します。 Visual Studio 内のプロジェクトを変更するファイルエクスプローラーでファイルを開きます。

CordovaAppコンポーネントは、ソリューション内で表示し、そのwwwディレクトリにindex.htmlホームページを含む web ベースのソースコードが含まれています。

Visual Studio のメインメニューの下のコントロールをテストしたり、アプリを展開することができます。

ローカルコンピューターを選択、Visual Studio を実行している同じマシン上のアプリのインストールに緑色の矢印キーを押します。そうと、Windows 8 アプリ一覧にアプリが表示されます。

アプリケーションをリビルドするたびに、インターフェイスのバージョンが更新されます。

一度利用できるアプリの一覧で、メイン画面にピン留めすることができますCTRLキーを押したまま、アプリを選択します。

メモ仮想マシン環境内でアプリケーションを開いた場合、コーナーでまたはアプリを切り替えるか、追加機能にアクセスする windows の側面に沿ってをクリックする必要があります。

代わりに、タブレットデバイスで実行されていたかのようにアプリケーションを表示するシミュレータの展開オプションを選択します。

デスクトップの展開とは異なりこのオプションはタブレットの方向、場所をシミュレートし、そのネットワーク設定を変更することができます。

注: コルドバのコマンドラインツールまたは SDK には、ワークフローで使用する方法についてのアドバイスの概要を参照してください。コルドバ CLI は日常的に SDK で使用されるプラットフォーム固有のファイルを上書きするクロスプラットフォームのソースコードに依存します。 SDK を使用して、プロジェクトを変更する場合は、CLI に代わるものとして、低レベルのシェル・ツールを使用します。