HoloLens Unity Build

This extension helps you to automated the build process of Unity app targeting the Microsoft HoloLens so you can setup a continous integration and with help of other extensions evencontinous delivery via the Windows Store. This extension is not compatible with a hosted build server since it need have Unity installed.

#Requirements This task wont run on a hosted build agent. You need to setup your own build server.

Required software:

• The right unity version for your project
• Right visual studio (2015 / 2017)
• other software your projects depends on. we use lot of blender.

In your project:

• HoloToolkit

Recommended VSTS extensions:

• Windows Store Automation (https://marketplace.visualstudio.com/items?itemName=davesmits.windows-store-automation) helps to bump the version number.

#Configure your build

The build needs 6 steps of which one is optional. A walkthrough:

if you want a appxupload that is ready to upload to the windows store don't forget to set the right values for your project in Unity player settings. Think about the app name, publisher name and the certificate.

1. Get Sources

My recommendation is to get the sources and always make sure the repository get cleaned. If not doing artifacts of the previous build can have impact of the success of the build. To do this go the get sources section. Turn on "advanced settings" and turn on clean and select "All build directories" in the dropdown menu.

2. Unity Build Task

Add the unity build task, as provided in this extension to your build definition. For the Unity Project Folder you select the folder that contains your Unity project.

3. Update Appx Version (optional)

This task comes from another extension I build. You can get it here: https://marketplace.visualstudio.com/items?itemName=davesmits.windows-store-automation

This extension helps to automated the process of publishing new version of your app to Windows Dev Center.

This specific task helps to update the version number of the app. After adding this task configure the two parameters.

1. Manifest File Select the manifest file that needs to get updated. You can't use the file selector as it is generated by the previous task but it will look something like: **\WindowsStoreApp**\package.appxmanifest

2. Build ID This gets the new version number. You can use a format with 4 digits and then will fully replace the version number or just the build id: $(Build.BuildId)

4 Nuget restore

Select for which solution the nuget packages have to be restored. This is for the solution that is generated in step 2. Path will likely be: **\WindowsStoreApp***.sln

5 Visual Studio Build

Now we going to build the generated solution. For the solution select the generated SLN file. Values you probally want to fill in:

Solution: **\WindowsStoreApp***.sln MSBuild Arguments: /p:UapAppxPackageBuildMode=StoreUpload /p:AppxBundlePlatforms="$(BuildPlatform)" /p:AppxPackageDir="$(Build.BinariesDirectory)\AppxPackages\" /p:AppxBundle=Always Platform: x86 Configurtion: Master

6 Publish Artifacts

Publish the generated assets. Path to publish: $(Build.BinariesDirectory)\AppxPackages\