WinAppDeployCmd を使ってUWP App を Win10 Mobile にインストール

開発中のUWP App をWin10 Mobile（以下電話）にインストールするには

• 電話とPCをUSBケーブルで接続し、VisualStudio 2015 のビルド・デバッグメニューから電話に転送・インストール

これが普通の方法です。(*1)

Win10では、新ツール WinAppDeployCmd.exe を使う方法が追加になりました。

• ネットワーク経由でのインストール・アンインストールが可能  USBケーブル要らず！
• VS2015 をインストールする必要が無い(*2)

という特徴があります。

ただ、このTool、Documentが中々分かり辛く、そのまま動かそうとすると大体失敗する（StackOverflow見てても使えてる人あんまり居ない…）ので使い方を解説してやるぜという主旨の記事です。何様。


*1) WP8.1時代には「SDカードからインストール」という方法がありましたがWin10 UWPでは無くなったようです。

*2) Win10 SDK Toolsに同梱されています。VS入れずにこれ入れる事もあまり無いですが…
一応、Program Files(x86)\10\bin\x86 の

WinAppDeployCmd.exe
WinAppDeploy.dll
WinAppDeployCommon.dll
Microsoft.Tools.Connectivity.dll
SirepClient.dll
SirepInterop.dll

だけあれば動くようです。x86以下全部Copyしたほうが安全かも。

1. Win10 Mobile 側の準備

まず、Win10 Mobile 機 のIPアドレスを確認しておきます。

Settings > Network & Wireless > Wi-Fi > (Your Access Point) > IP address

次に、
Settings > For developers > Use developer features  で、Developer mode を選択。

同じページの Device discovery を On にセットし、「Pair」をタップ。

電話はペアリング待ち受け状態になり、ペアリングに使うパスフレーズが表示されます（別にパスワードでは無いのでここで貼っています。ペアリングを試行する度ランダムに生成されます）。

2. 電話とPCをParing

WinAppDeployCmd の実行オプション -pin を指定し、電話とPCをペアリングします。この作業は一度行えばOKで、以降は -pin の指定は必要ありません。

WinAppDeployCmd.exe list -ip <ipaddress> -pin <pin>

上の例で言うと、WinAppDeployCmd.exe list -ip 192.168.1.6 -pin q3g5u5  になります。
下の画面は、list を実行して電話にインストールされているAppの一覧を表示している様子です。
実行が確認できたら、ここで電話の「Pair device」はAbortをタップして閉じてしまって構いません。

WinAppDeployCmd.exe list -ip <ipaddress> -pin <pin>

3. アプリ　パッケージのインストール

WinAppDeployCmd.exe install -file <appx/appxbundle filename> -ip <ipaddress>

UWP Appの場合、大抵はbundle packageになっているはずです。私のアプリ F10 の場合だと、
WinAppDeployCmd.exe install -file F10Client_1.1.49.0_x86_x64_arm.appxbundle -ip 192.168.1.6

になります。
※ ここで使うファイルは.appxupload では無いことに注意 .appx か .appxbundle です。 VS2015でパッケージをビルドすると、<プロジェクトのディレクトリ> / AppxPackages / <今ビルドしたバージョンのフォルダ> 、にappx or appxbundleが出来ます。

以下はAppをインストールしている様子です。

WinAppDeployCmd.exe install -file <appx/appxbundle filename> -ip <ipaddress>

上手くいくと、電話にAppがインストールされます。

最後に、WinAppDeployCmd MSさんの説明ページ

https://blogs.windows.com/buildingapps/2015/07/09/just-released-windows-10-application-deployment-tool/

https://msdn.microsoft.com/en-us/library/mt203806.aspx