This version of the documentation is under development! Click here for the latest released version.

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

このガイドでは、構築および Windows 10 普遍的なアプリケーションプラットフォーム、Windows Phone 8.1 Windows 8.1 Windows 8 の Cordova アプリを展開する SDK の開発環境を設定する方法を示しています。シェルツールを使用して生成し、アプリケーションを構築する方法を示します。またはクロスプラットフォームコルドバ CLI コマンドラインインターフェイスでの議論。 (これら開発オプションの比較の概要」を参照してください)。このセクションでは、Visual Studio 内でコルドバのアプリを変更する方法も示します。、採用するアプローチに関係なくあなたは、次のよう 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 8.0、8.1 または 10、32 または 64 ビットホーム、 Pro、またはVisual Studio 2012 Expressまたは Visual Studio 2013 と共に、エンタープライズ版。 Visual Studio 2015 は Windows 8.0 アプリケーションを構築できません。

アプリの開発 Windows 8.0 および 8.1 (Windows Phone 8.1 を含む)。

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

10 Windows 用アプリの開発。

Windows 8.1 または Windows 10 テクニカルプレビュー 2、32 ビットまたは 64 ビット、 Visual Studio 2015 RCと一緒に以上。

アプリの互換性は、アプリケーションが対象とする OS によって決定されます。アプリは、前方互換がない下位互換、8.0 で Windows 8.1 をターゲットアプリケーションは実行できませんが、8.1 8.0 用に構築されたアプリケーションを実行できます。

Windows ストアにアプリを提出するwindowsstore.comで指示に従います。

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

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

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

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

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

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

Visual Studioの要件が上記のバージョンと一致するの任意のエディションをインストールします。

Windows 10、Visual Studio インストーラーには普遍的な Windows アプリケーションを構築するためのツールをインストールするオプションがあります。このオプションが必要な SDK をインストールするのをインストールするときに選択されているを確認する必要があります。

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

この時点で、新しいプロジェクトを作成する、コマンドラインインターフェイスまたは一連の 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

このプロジェクトは、既定のターゲット OS として Windows 8.1 を対象します。 8.0 や 10.0 は、すべてのビルドの (以下「構成ターゲット Windows 版」を参照してください) をターゲットすることができます。または、ビルドごとに特定特定バージョン対象とします。

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

プロジェクトディレクトリの最上位レベルで開発に 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

cleanコマンドは、次の準備のためにディレクトリを洗い流すのに役立ちます build :

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

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

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

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

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

--appx パラメーター

特定の OS をターゲットアプリケーションの特定のバージョンをビルドすることもできます (たとえば、設定した Windows 10 を対象とするが、Windows Phone 8.1 用に構築する場合)。これを行うには、するには、 --appxパラメーターを使用します。

    > cordova build windows -- --appx=8.1-phone

ビルドシステムでは、設定は、ターゲットの Windows バージョン用の config.xml の設定を無視し、厳密に Windows Phone 8.1 のパッケージを構築します。

8.1-win、 8.1-phone、 uap (Windows 10 ユニバーサルアプリ) のため、 --appxフラグの有効な値。これらのオプションは、cordova runコマンドにも適用されます。

ターゲットの Windows バージョンの考慮事項

Windows 10 コルドバアプリ (と一般的に HTML アプリケーション) の新しい「リモート」モードをサポートしています。このモードにより、アプリの DOM 操作とインラインスクリプトの使用などの一般的な web のパターンを使用する点ではるかに自由が公共の Windows ストアに提出するとき一連の機能を減らすことによってアプリを使用可能性があります。 Windows 10 とリモートモードの詳細については、 Windows 10 コルドバのドキュメントを見てください。

リモートモードを使用している場合、開発者がスクリプト注入攻撃を防ぐために、アプリケーションにコンテンツセキュリティポリシー (CSP) を適用することをお勧めします。

アプリを展開します。

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 の代わりに低レベルのシェル・ツールを使用します。