For the best stability and reliability, it is recommended that you periodically check for the latest Crosslight updates. You can obtain Crosslight updates through a number of channels depending on the quality bands.
This page explains the definitions of quality band for each Crosslight maintenance release, how to obtain the updates, and how to apply the updates to your projects.
Maintenance Release Quality Bands
Maintenance release, also known as hotfix or updates release, is typically made available regularly to our customers on monthly basis. However, customers with premium support are entitled to access the development builds earlier than the regular official release date. These development builds, often called nightly builds, are particularly important when you encounter issues that are critical to your development progress. You can then apply the builds to your projects and report back to us if the builds addressed your issues.
It is important to understand the quality of the maintenance release before deciding to apply the new builds. Crosslight introduces three quality bands such as explained in the following table.
|BETA||Indicates that the maintenance release is in beta stage. More fixes and updates may be added during this stage.|
|RELEASE CANDIDATE||Indicates that the maintenance release is reaching maturity and is ready to be released shortly. This phase also represents a feature-locking condition, which means no additional fixes or updates will be made to this build.|
|STABLE||Indicates that the maintenance release is now stable and officially available to all customers.|
Depending on the release quality bands, you can obtain updates through different channels such as explained below.
The fastest and easiest way to update Crosslight in your solution is by updating the Crosslight packages from NuGet which is introduced since Crosslight 5.0. For more information how to update Crosslight packages with NuGet, and how to install pre-release version, see Updating Crosslight NuGet Packages.
Intersoft Git Server
You can find nightly builds for maintenance release right from Intersoft Git Server. All builds with quality bands in BETA and RELEASE CANDIDATE will be made available in the Git server as well. You can find these builds in the crosslight/updates repo.
It is recommended that you used SourceTree as your Git client which allows you to automatically receive notifications when new updates are made available to the updates repo. Alternatively, you can simply browse the available updates from the Git web interface, then download the updates that you are interested in.
Intersoft Update Manager
If you are interested only in stable updates, then you can use Intersoft Update Manager to obtain latest Crosslight updates. Only stable maintenance releases will be made available to Update Manager.
To launch Update Manager in Windows, please locate it in the Mobile Studio folder under the Intersoft Solutions program group. Alternatively, it might be faster to simply search with the "Update Manager" keyword in Windows 8's search box.
Intersoft Crosslight Installer
In addition to Update Manager, you can also choose to re-download the complete Crosslight setup and reinstall it in your local development machine. You can always download the latest Crosslight installer here, or sign-in to your account.
Downloading the latest Crosslight Installer is necessary when the release types are:
- Service Pack Release – includes cumulative updates and may contain more comprehensive features instead of just assemblies update.
- Major Release – includes major new features and enhancements which typically contain improved tooling support, project templates and other new release materials.
Applying Updates to Your Projects
Applying Crosslight updates to your projects is easy and straightforward. You can simply copy the downloaded updates to the Intersoft.Crosslight package folder in your project, see the following screenshot.
If you are obtaining updates from Intersoft Update Manager or Crosslight Installer, you can get the latest assemblies from the Crosslight installation folder which is located in:
- Mac – /Library/Application Support/Intersoft Solutions/bin
- Windows – [Program Files]\Intersoft Solutions\Crosslight\bin
Once you applied the latest updates to your projects, you can open the solution in either Visual Studio or Xamarin Studio, then simply rebuild your Crosslight project solution and run your app.
Congratulations! You have successfully run your projects with the latest Crosslight updates.