# Sample testing

These unit tests clone a series of known repositories that contain sample
projects, and build all the relevant projects in those repositories.

It is executed automatically in [Azure DevOps][1] every [Saturday][2] for the listed branches. This includes:

* `main`
* `d16-x` - i.e. one or many active release branches
* `xcodeY` - i.e. the current xcode *beta* feature branch
* `mono-202z-zz` - i.e. the mono integration branches (new one every two months)

where `x`, `Y` and `z` needs to be periodically updated as new branches are created (e.g. `d16-x`) and old ones are merged into `main` (e.g. `xcodeY` and `mono-202z-zz`).

It can also be triggered manually, but have in mind that the commit in
question must already have packages (as GitHub statuses).

It's also possible to use the sample tests from one commit, and then test with
Xamarin.iOS/Xamarin.Mac a completely different commit, by setting the
`PROVISION_FROM_COMMIT` variable to the commit that's to be tested:

![screenshot](images/provision_from_commit.png)

The previous point is still required: the commit to provision from must have
packages.

There are two ways to run these tests locally:

* Launching xharness in server mode and execute the "Sample tests" (they're
  disabled by default).
* Executing `make` in this directory.

[1]: https://dev.azure.com/xamarin/internal/_build?definitionId=23
[2]: https://dev.azure.com/xamarin/internal/_apps/hub/ms.vss-ciworkflow.build-ci-hub?_a=edit-build-definition&id=23&view=Tab_Triggers