2015年10月9日金曜日

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


0 件のコメント:

コメントを投稿