Windows Phone Silverlight から UWP への移植のトラブルシューティング

前のトピックは プロジェクトの移植についてでした。

この移植ガイドの最後まで読むことは強くお勧めしますが、プロジェクトのビルドと実行のステージに進みたいと思っているのも理解しています。 そのためには、重要でないコードをコメントアウトまたはスタブ化することで一時的に進捗を得て、後でその負債を返済するために戻ることができます。 このトピックにあるトラブルシューティングの症状と解決策の表は、この段階で役立つ場合がありますが、次に進むいくつかのトピックを読むことの代わりにはなりません。 後のトピックを進める際は、いつでもテーブルを参照できます。

問題を追跡する

XAML 解析例外は、特に、例外内に意味のあるエラー メッセージがない場合に診断が困難な場合があります。 デバッガーが初回例外をキャッチするように構成されていることを確認します (早い段階で解析例外をキャッチします)。 デバッガーで例外変数を調べて、HRESULT またはメッセージに有用な情報があるかどうかを判断できる場合があります。 また、XAML パーサーによるエラー メッセージの出力については、Visual Studio の出力ウィンドウを確認してください。

アプリが終了し、XAML マークアップの解析中にハンドルされない例外がスローされたことがわかっている場合、それは不足しているリソースへの参照が原因である可能性があります (つまり、Windows Phone Silverlight アプリには存在するが、Windows 10 アプリには存在しないキーを持つ一部のシステム TextBlock スタイル キーなど)。 UserControl、カスタム コントロール、またはカスタム レイアウト パネル内で発生する例外である可能性も考えられます。

最後の手段はバイナリ分割です。 ページからマークアップの約半分を削除し、アプリを再実行します。 その後、エラーが削除した半分の内側にあるか (いずれの場合も復元する必要があります)、または削除しなかった半分 かどうかがわかります。 エラーを含む部分を半分に分割してプロセスを繰り返し、問題が特定できるまで続けます。

ターゲットプラットフォームバージョン

このセクションは、Visual Studio で Windows 10 プロジェクトを開いた際に「Visual Studio の更新が必要です」というメッセージが表示された場合の対処方法を説明します。 1 つ以上のプロジェクトには、インストールされていないか、Visual Studio の今後の更新プログラムの一部として含まれている、プラットフォーム SDK <バージョンの> が必要です。

• まず、インストールした Windows 10 用 SDK のバージョン番号を確認します。 C:\Program Files (x86)\Windows Kits\10\Include\<versionfoldername> に移動し、<versionfoldername>を書き留めます。これはクワッド表記の "Major.Minor.Build.Revision" になります。
• プロジェクト ファイルを開いて編集し、TargetPlatformVersion 要素と TargetPlatformMinVersion 要素を見つけます。 次のように編集し、versionfoldername <> をディスク上で見つかったクワッド表記バージョン番号に置き換えます。

   <TargetPlatformVersion><versionfoldername></TargetPlatformVersion>
   <TargetPlatformMinVersion><versionfoldername></TargetPlatformMinVersion>

トラブルシューティング：症状と改善策

表の救済情報は、自分自身のブロックを解除するのに十分な情報を提供することを目的としています。 これらの各問題の詳細については、後のトピックを参照してください。

次のトピックは XAML と UIの移植です。