Deployment Instructions

Standard (Royalty-Free) Licensing

The IPWorks components use a property named RuntimeLicense for runtime license checking.

Obtaining the RuntimeLicense value: During installation, the setup will create a file called ipworks.lic in the installation folder. Open this file in any text editor and you should see a long string value. This is your RuntimeLicense value.

Using the RuntimeLicense value: After obtaining the RuntimeLicense value set the RuntimeLicense property of the component in code before calling any methods. For instance:

component.setRuntimeLicense("Runtime License Value");

Trial Licensing

No special file or value is required for trial licensing. Trial licenses only require the use of the component's overloaded constructor that takes a Context object. At runtime the component will display a dialog informing the user a trial license is being used. If a Context object is not passed to the constructor the component will throw a licensing exception at runtime.

For example, if your class extends the Activity class you may simply pass the "this" object to the constructor. For instance:

public class MyClass extends Activity {
...
//Within a method later in the class
component myInstance = new component(this);

If you wish to use the trial version in a background thread (such as when using AsyncTask) you may do so but you must still pass a Context object to the constructor. A simple approach when using AsyncTask would be to create an overloaded constructor for the class extending AsyncTask to pass "this" from the main class that extends Activity, and in turn pass the Context object to the constructor of the component used within the class extending AsyncTask.

License Transfer

If you would like to transfer your license to another system, please complete our license transfer form. This will ensure your installations are not mistaken for license violations.

For additional information about our product activation process, please refer to our product activation FAQ.