Visual Studio Team Servicesの継続的な統合UWPアプリケーション

VSTSを使用すると、さまざまな環境でソフトウェアの展開とテストを自動化できます。 継続的インテグレーションの本質は、プロジェクトの頻繁な自動アセンブリを実行して、インテグレーションの問題を迅速に特定して解決することです。 特に、CIを使用すると、アプリケーションの回帰テストを自動化できます。



VSTSの機能の概要として、単純なUWPアプリケーションの単体テストとの継続的統合を公開および構成することを提案します。



簡単なUWPアプリケーションプロジェクトを作成して、1つのメソッドを作成します。

public double CalcSquere(string t) { double res = Convert.ToDouble(t); res = res * res; return res; }
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

ソリューションで、単体テスト（Unit Test App）を含むプロジェクトを追加します。 慣例によりテストプロジェクトに名前を付け、最後にテストを追加することをお勧めします。 したがって、VSTSおよびTFSでテスト実行を構成する方が簡単です。 メインプロジェクトへのリンクを追加します。







UnitTest.csの名前をMainPageTests.csに変更します。 ファイルにそのような名前が付けられている場合、このクラスが正確にテストしているものを理解しやすくなります。



メソッドを追加します。

  [TestMethod] public void CalcSquere_5_Result25() { Windows.ApplicationModel.Core.CoreApplication.MainView.CoreWindow.Dispatcher.RunAsync(CoreDispatcherPriority.Normal, () => { SimpleApp.MainPage mp = new SimpleApp.MainPage(); double expected = mp.CalcSquere("5"); Assert.AreEqual(expected, 25, "Wrong"); }).AsTask().Wait(); }
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

メソッドコードはUIスレッドから起動されます。 名前空間を追加することを忘れないでください

 using Windows.UI.Core;
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

プロジェクトを作成するときにバージョン管理システムを追加しなかった場合は、ここで追加する必要があります。







gitignoreリストから両方のプロジェクトの証明書を削除する必要があります（そうしないと、VSTSビルドは失敗します）。



VSTSで公開しています。 チームエクスプローラーウィンドウに移動し、[同期]をクリックします



公開後、ビルド定義を作成できます。 ただし、その前に、ビルドエージェントを構成する必要があります。 実際、単体テストを実行するには、カスタムエージェントを作成する必要があります。



デフォルトでは、3つのエージェントプールがあります。

デフォルトプールは 、リモートサーバーにインストールされているエージェントに使用されます。

ホストプールは 、VSTSおよびTFSサーバーにデフォルトでインストールされるエージェントに使用されます。

ホストされたLinuxプールを使用すると、エージェントを設定しなくてもLinuxマシンを操作できます。 vsts-agent-dockerコンテナドッカー内のUbuntu Linuxホストで動作します。



以下の表は、カスタムエージェントが必要であることを示す可能なシナリオを示しています。

スクリプト	カスタムエージェント	ホストされたビルドエージェント
UWPアセンブリの主な機能（.NETネイティブを含む）	X	X
サイドローディング用のパッケージの作成	X	X
Windowsストア用のパッケージを作成する	X	X
サードパーティの証明書を使用する	X
Windows SDKのカスタムバージョン用にビルドする	X
単体テストの実行	X
インクリメンタルビルドを使用する	X

ビルドエージェントを作成するには、パーソナルトークンを作成する必要があります。 プロファイルアイコンをクリックして、[セキュリティ]に移動します。







追加をクリックします。 エージェントプールのみを選択します（読み取り、管理）







トークンの作成（下）をクリックし、値をコピーしてコンピューターに保存します







このメッセージは、トークンの値を今すぐ​​保存しないと、それを取得できないことを警告しています。 エージェントに行く







エージェントが作成された後、エージェントがこのウィンドウに表示されますが、現時点では空です。



[エージェントのダウンロード]をクリックします。







vsts-agent-win7-x64-2.110.0.zipアーカイブをダウンロードします。 C：\ agentフォルダーに解凍します（名前と場所は正確に同じである必要はありません）



開発している同じマシンにエージェントをインストールする必要はありません。 任意のマシンにインストールできます。 理論的には、Azure仮想マシンにインストールできます。 前提条件-64ビットバージョンのWindowsをインストールする必要があります。 ほとんどのシナリオでは、NuGetと共にマシンにVisual Studioをインストールする必要があります。



PowerShellを起動して、C：\ agentディレクトリに移動します。 設定可能。 バッチファイル。\ Config.cmdを実行し、リクエストに応答します。 サーバーのURLを入力し、認証の種類を選択します。 VSTSの場合、利用可能なオプションはPAT（Personal Access Token）のみです。 これは、少し前に作成したまさにそのトークンです。 次に、プールとエージェント名を選択します。 私の場合、これらの値はデフォルトで残されていました。







構成の最後のステップは、エージェントをサービスとして開始するかどうかの質問です。 テストが必要な場合、エージェントは手動で開始されます。 サービスとしてインストールする必要はありません。



注： 。\ Config removeを使用してエージェントを削除できます。この場合、PATトークンを入力する必要があります。



設定の詳細はこちら： Windowsでのエージェントの展開



ビルドを作成しましょう







ユニバーサルプラットフォームのテンプレートを選択する







そして、Continous統合を構成します（反対側のボックスをチェックします）。 エージェントプールのデフォルトの選択







その結果、次のウィンドウが表示されます。







アプリケーションのビルドの結果として取得されたファイルのコピーを作成する予定がない場合、アーティファクトの公開手順（Artifact：ドロップ）をスキップするか削除して、時間を節約することもできます（このコピーは、たとえば、クライアントに転送したり、リリースに送信したり、手動でテストしたりできます）。



ビルドを高速化するために（テストに合格することだけを確認する必要がある場合）、ソリューションのビルドステップで1つのプラットフォーム（x64）を指定できます。 これはCIに推奨されます。

この場合、ビルド設定のMSBuild Arguments行を変更します。 AppxBundleをNeverに設定します。

/ p：AppxBundlePlatforms = "$（BuildPlatform）" / p：AppxPackageDir = "$（Build.ArtifactStagingDirectory）\ AppxPackages \\" / p：AppxBundle = Never / p：UapAppxPackageBuildMode = StoreUpload

この行の$（Build.ArtifactStagingDirectory）は、成果物フォルダーへのパスを示す変数です。 私のマシンにエージェントがエージェントフォルダーのCドライブにインストールされており、その構成中に_workという名前の作業フォルダーを選択した場合、このフォルダーへのパスは次のとおりです。



C：\エージェント\ _work \ 1 \ a

ここで1はプロジェクト番号です



すべての変数のリストは、次のページにあります。 ビルド変数を使用する



基本設定：







バンドル（さまざまなプロセッサアーキテクチャ用のアプリケーションパッケージを含むファイル）を生成する場合は、プロジェクト設定を変更する必要があります。 または、.csprojプロジェクトファイルを開き、次の変更を行います。

プロジェクトファイルでは、最初の要素の最後にあるテスト単位

 <PropertyGroup>
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

追加：

 <AppxBundle>Never</AppxBundle>
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

そして、アプリケーションプロジェクトファイルに以下を追加します。

 <AppxBundle>Always</AppxBundle>
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

これらの変更後、AppxBundleパラメーターは、その値と共にMSBuild Arguments行から安全に削除できます（または、値をAuto-/ pに設定します：AppxBundle = Auto）

このオプションはCDに適しています。



テストしたい（そして私たちの場合はそうです）という要望があるので、ステップを追加する必要があります







タスク選択ウィンドウで、Visual Studio Testを追加します。 テストアセンブリへのパスを指定する

私の場合、これは次のとおりです。



$（Build.ArtifactStagingDirectory）\ AppxPackages \ SimpleAppTests_1.0.0.0_x64_Test \ SimpleAppTests_1.0.0.0_x64.appx



他の可能なテスト設定は、次のリンクで説明されています： Visual Studio Test



単体テストの場合、エージェントをインタラクティブに（つまり、スクリプト。\ Run.cmdを使用して）起動する必要があります。



さらに、アプリケーション証明書（メインアプリケーションと単体テストアプリケーションの両方）がローカルマシンリポジトリ（Trusted People）にインストールされている必要があります（* .pfxファイルをダブルクリックするだけでインストールできます）。 エージェントがインストールされているのと同じマシンに証明書をインストールする必要があります。



テストを実行するときに、エラーが発生する場合があります。



...（0x5B4）操作がタイムアウトしました。 30秒以内にWindowsアプリパッケージをインストールできません。



この場合、起動に割り当てられる時間を人為的に増やすことができます。 これは、 .runsettingsファイルを作成することにより行われます。 この場合のファイルの最小コンテンツは次のとおりです。

 <?xml version="1.0" encoding="utf-8"?> <RunSettings> <!-- Configurations that affect the Test Framework --> <RunConfiguration> <!-- [x86] | x64 - You can also change it from menu Test, Test Settings, Default Processor Architecture --> <TargetPlatform>x64</TargetPlatform> </RunConfiguration> <!-- Adapter Specific sections --> <!-- MSTest adapter --> <MSStoreTest> <AppxInstallTimeout>240000</AppxInstallTimeout> </MSStoreTest> </RunSettings>
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

ここで、テストするアーキテクチャのパッケージを選択し、アプリケーションのインストールの制限時間を240秒に設定します。



通常、ファイルはアプリケーションのルートディレクトリに作成され、VSTSビルド設定で指定されます。







テストの正常な構築と実行の結果は以下に表示されます。







テストの詳細ウィンドウ：







このウィンドウから、新しいバグを作成したり、開発タスクとの関連付けをテストしたりできます。



発行価格：小規模な開発チームのほとんどの機能は無料です（クレジットカードをアカウントにリンクする必要はありません）。 プライベートリポジトリで無制限、タスク作成。 さらに、プライベートパイプラインが提供され（ 同時パイプライン ）、1つのビルドと1つのリリースを同時に実行できます。 複数のビルドを同時に実行できますが、それらは次々に順番に実行されます。 さらに、ホストされたエージェントを1か月あたり240分間無料で使用できます（各ビルドまたはリリースは30分以上続くことはできません）。

大規模な開発チームの価格については、Visual Studio Team Servicesの使用料金をご覧ください。



公式マニュアル： UWPアプリケーションの自動アセンブリのセットアップ