Pre loader

SciChart Android Licensing v3.x

In order to license SciChart Android v3 and unlock all its features, there is a simple procedure which must be followed. Without this you won’t be able to compile and debug applications built with SciChart Android. Licenses are unique to all SciChart products, so licenses for another products cannot be used for SciChart Android Charts and vice versa.

Please be aware before starting usage of the SciChart software constitutes acceptance of the licensing terms & conditions. SciChart is licensed per-developer with a royalty-free redistribution rights for your applications. A helpful licensing FAQ can be found here.

If you wish to purchase a paid SciChart license, you can do so at the store.scichart.com. Likewise, you can download the library at our scichart.com/downloads page.

In SciChart Android v3, trial licenses can be fetched with the cross platform licensing wizard. Trial licenses and technical support are tied to a SciChart account, so if you don’t have one, then head over to scichart.com/login and create an account now.

Download the licensing wizard from here and install on your Windows or Mac desktop.

Once installed, and you have logged in with scichart.com account, you can start a trial in your chosen platform as follows:

Apply the trial to your application by viewing the KeyCode on the Licensing Wizard.

The KeyCode must be placed in your application once before any SciChartSurface is shown or instantiated, for example MainActivity (see below).

Applying the Trial License in Your App

The KeyCode must be set in your app once, and once only before any SciChartSurface instance is shown. Do this by calling the static SciChartSurface.SetRuntimeLicenseKey() method in MainActivity or Application.onCreate.

Code samples below:

Java

public class YourApp extends Application {

    @Override
    public void onCreate() {
        super.onCreate();
        sInstance = this;

        // Set your license code here to license the SciChart Android Examples app
        // You can get a trial license key from https://www.scichart.com/licensing-scichart-android/
        // Purchased license keys can be viewed at https://www.scichart.com/profile
        //

        try {
            com.scichart.charting.visuals.SciChartSurface.setRuntimeLicenseKey("YOUR_KEYCODE");
        } catch (Exception e) {
            Log.e("SciChart", "Error when setting the license", e);
        }
    }
}
Kotlin
// The main activity for the application
class MainActivity : AppCompatActivity() {

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)

        // Set your license code here to license the SciChart Android Examples app
        // You can get a trial license key from https://www.scichart.com/licensing-scichart-android/
        // Purchased license keys can be viewed at https://www.scichart.com/profile
        //

        try {
            com.scichart.charting.visuals.SciChartSurface.setRuntimeLicenseKey("YOUR_KEYCODE")
        } catch (e: Exception) {
            Log.e("SciChart", "Error when setting the license", e)
        }
    }
}
Xamarin.Android
public class MainActivity : ListActivity
{
    protected override void OnCreate(Bundle bundle)
    {
        base.OnCreate(bundle);
    SciChart.Charting.Visuals.SciChartSurface.SetRuntimeLicenseKey(@"YOUR_KEYCODE");
 
           // .. 
    }
}

If you have purchased SciChart Android v3, you should have received a confirmation e-mail with a Developer Serial key and Runtime key. You can also view purchased license keys and serials in your Profile Page. If you don’t have one, please contact SciChart Sales.

SciChart Licensing Email Examplef
SciChart Licensing Email Example

To activate the license so that you can receive Technical Support, download the cross platform licensing wizard and install on your Windows or Mac desktop.

Once installed, and you have logged in with scichart.com account, you can activate the developer serial you received when you purchased.

After activation you will see your license status on the wizard homepage. You can click ‘Runtime key’ to show the runtime license key that you must include in your app.

The KeyCode must be placed in your application once before any SciChartSurface is shown or instantiated, for example MainActivity or Application.onCreate (see below).

Applying the Runtime License in Your App

The KeyCode must be set in your app once, and once only before any SciChartSurface instance is shown. Do this by calling the static SciChartSurface.SetRuntimeLicenseKey() method in MainActivity.

Code samples below:

Java

public class YourApp extends Application {

    @Override
    public void onCreate() {
        super.onCreate();
        sInstance = this;

        // Set your license code here to license the SciChart Android Examples app
        // You can get a trial license key from https://www.scichart.com/licensing-scichart-android/
        // Purchased license keys can be viewed at https://www.scichart.com/profile
        //

        try {
            com.scichart.charting.visuals.SciChartSurface.setRuntimeLicenseKey("YOUR_KEYCODE");
        } catch (Exception e) {
            Log.e("SciChart", "Error when setting the license", e);
        }
    }
}
Kotlin
// The main activity for the application
class MainActivity : AppCompatActivity() {

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)

        // Set your license code here to license the SciChart Android Examples app
        // You can get a trial license key from https://www.scichart.com/licensing-scichart-android/
        // Purchased license keys can be viewed at https://www.scichart.com/profile
        //

        try {
            com.scichart.charting.visuals.SciChartSurface.setRuntimeLicenseKey("YOUR_KEYCODE")
        } catch (e: Exception) {
            Log.e("SciChart", "Error when setting the license", e)
        }
    }
}
Xamarin.Android
public class MainActivity : ListActivity
{
    protected override void OnCreate(Bundle bundle)
    {
        base.OnCreate(bundle);
    SciChart.Charting.Visuals.SciChartSurface.SetRuntimeLicenseKey(@"YOUR_KEYCODE");
 
           // .. 
    }
}

If you are a SciChart Android Source-Code customer, you can now access the source code via our Github repository. To get access, please follow the steps below:

#1 Activate your SciChart License

You need to activate your SciChart License following the steps above ‘Activating a Paid License’.

#2 Link your account to Github

Now enter your Github Username in the box directly below. If you do not have a Github account, head over to www.github.com and register.

Note: You will need to be logged in to scichart to use the profile page. Please log in at or create an account at www.scichart.com/login if you haven’t already
#3 Respond to Invitation

You will receive an email with an invitation to join the SciChart Android Github repository! Accept the invitation to get access!

If you cannot manage to get your application working with the license applied, please check out our licensing troubleshooting steps below or contact us and we will do our best to help.

Locating License Keys

Your serial key and developer runtime key is found in your License Certificate email and also online at www.scichart.com/profile. If you do not have either, please contact-us!

SciChart Licensing Email Examplef

Trial Expired Problems

Sometimes people report that after distributing their application, the Trial Watermark still appears, or, end users see Trial Expired.

Follow the steps below to debug this.

  1. Check support expiry date: if your support subscription has expired, then you cannot use the latest versions of SciChart. You can check your support subscription at the profile page or in the cross platform licensing wizard. Contact sales to renew your license, as generous discounts are available if you renew promptly!
  2. Check the Runtime License Key is set: Follow the steps above to set your Trial or Paid Runtime License key. Without this, the app will not work!
  3. Ensure Runtime Key is set once, and once only: The SciChartSurface.SetRuntimeLicenseKey method must be called once and once only before any SciChartSurface is instantiated. The best place to do this is in MainActivity.