...

Related Jira Issues

Introduction

Unity will utilize FN’s Azure DevOps solution to manage the building and packaging of both the FN SDK and the Unity example project. The following defines how Unity will make use of Azure’s built in build and pipeline tools to conduct proper CI/CD methods.

...

• A static code analysis task will be written to automate detection of any vulnerabilities or poorly written code

• An automated testing task will be written to run any unit tests written for the SDK

• A build task will be written to produce a dll artifact

• A publish task will be written to copy the resulting dll artifact library artifacts of the build task to a specified sharepoint location

Unity Project

The following tasks will be defined in the yaml file:

• A static code analysis task will be written to automate detection of any vulnerabilities or poorly written codeAn automated testing task will be written to run any unit tests written for the Unity project

• A batch script task will be written to build the example Unity scene

  • A container using a Unity build license will be utilized throughout the course of the project to allow for remotely building the Unity project.
    NOTE: This container will only be valid during the course of development. FN will need to work with Unity to obtain their own Unity build license if they wish to continue building the Unity project post project delivery

• A publish task will be written to copy the resulting exe appx file of the example Unity scene utilizing the FN SDK to a specified sharepoint location

  • Scripts will also be provided to assist with sideloading the UWP application

Schedules

General

• A build will be generated on the development branch on a nightly basis to ensure integrity of core, working branch

• A build will be generated on the master branch on a bi-weekly basis to ensure the integrity of the delivery branch and support the production of artifacts for delivery at the end of each sprint

• An additional yaml file will be created to enable building feature branches on a more frequent basis.

Batch Files

• A batch file will be written to build the example Unity scene utilizing the FN SDK

Static Analysis

• FN will provide a SonarQube instance for static analysis of SDK code, including bug and vulnerability detection, and “code smell” checks.

• SonarQube will be integrated into the AzureDevOps pipeline using the SonarScanner plugin.

• SonarQube Scans will be performed as part of every build job.

• Acceptance Criteria for development tasks will include requiring a “passed” status for the SonarQube Quality Gate.

Artifacts

SDK Artifacts

The following artifacts will be generated upon a successful build of the FN SDK

• A dll Release builds of any libraries built by Unity in support of the FN SDK

• Dlls Builds of any dependencies of any libraries built by Unity in support of the FN SDK

...

The following artifacts will be generated upon a successful build of the Unity project

• An exe built UWP app of the Example scene utilizing the FN SDK for the Windows 10 OS platform

  • Any required dlls libraries will also be generated as artifacts for the Unity project

• An exe A built Android application of the Example scene utilizing the FN SDK for the Android 10 OS platform

  • Any required dlls libraries will also be generated as artifacts for the Unity project

...

1. A unique identifier to assist in differentiating builds from each other

2. An indication of the branch the artifact was generated from

3. An indication of the date the artifact was generated

4. An indication of the release version/milestone tied to the artifact

Retention Policy

• Artifacts from builds in the development branch will be retained for a minimum of 2 weeks before being deleted

• Artifacts from the main branch will be retained for the length of the project

Internal Repo Maintenance [Resource]

• An internal, Unity facing git vcs repo will be created to mirror the Azure repo

• Unity developers will connect their local git repo to both the Azure DevOps repo and the internal git vcs repo

• Any changes made to the root development branch will be reflected both in Azure and the internal git vcs repoAny changes made to the main master branch will be reflected both in Azure and the internal git vcs repo