Skip to end of metadata
Go to start of metadata

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.

On this page:

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.

BETAIndicates that the maintenance release is in beta stage. More fixes and updates may be added during this stage.
RELEASE CANDIDATEIndicates 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.
STABLEIndicates that the maintenance release is now stable and officially available to all customers.

Obtaining Updates

Depending on the release quality bands, you can obtain updates through different channels such as explained below.

These update releases will work only if you have installed full version of Crosslight. If you have not installed the full version, please download Crosslight Installer here, and install it prior to obtaining the updates.

NuGet

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.

Update Manager for Mac will be made available in the near future.

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.
The quality band and update channels discussed in this page are applicable only for maintenance and service release type. Major release will be made available only to installer, and will never be distributed in either Git or Update Manager.

Applying Updates to Your Projects

This step is not required if your project is configured with Crosslight NuGet packages. When updating your projects with NuGet, either in Xamarin Studio or Visual Studio, NuGet automatically downloads the new packages along with the changed dependencies, and install it to your project. You can simply rebuild your projects and everything is all set. For more information about Crosslight NuGet support, see Introduction to Crosslight NuGet Packages.
Due to the fast-pacing updates and agile methodology that Crosslight team adopted, the Crosslight project solution has been upgraded to use distributed model instead of centralized model since version 2. Distributed model means that the Crosslight references are now scoped per project instead of a global reference. This allows you to build multiple projects with different version of Crosslight. For instance, consider that you have completed and deployed a task app using Crosslight 2.0, then at the same time working on a new service app using Crosslight 2.1. At a time, you might want to prefer updating Crosslight 2.2 on the service app, but leaving the task app with the older version which has been previously tested to work perfectly.

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.