eUpdator Component Reference

TeUpdator

Properties

ApplicationName : string
Lanugage : TLanguages
ProductKey : string
UpdateFile : string
Version : string
VersionFromResource : boolean

Methods

Cancel
Create(AOwner: TComponent)
Destroy
Execute

TLanguages

INI file Entries

eUpdator Information Files

Legal


Top

ApplicationName property

property ApplicationName: string;

Name of your application. This is the name that is displayed inside the eUpdator Application.


Top

Language property

property Language: TLanguages;

Choice of language to display all messages in.


Top

ProductKey property

property ProductKey: string;

ProductKey is a unique identifier for your Application. This will be the name of the keys that eUpdator uses to identify this application. Make sure you use an identifier that cannot be mixed up with another product. For example you could use your company name in combination with the application name as a product key.

You should never change this key in an upgrade of your application since eUpdator will treat it as a separate application.


Top

UpdateFile property

property UpdateFile: string;

UpdateFile is the complete URL path to the eUpdator info file. The update file can be located on a http, ftp server or a path on your intranet network.

FTP source:
ftp://www.elysian.nu/eUpdator/download/product.inf

HTTP source:
http://www.elysian.nu/eUpdator/download/product.inf

Network path:
file://SERVER1/storage/product.inf
or
\\SERVER1\storage\product.inf
or
\\10.10.1.1\storage\product.inf
( ip addresses does not work on Win 9x )


Top

Version  property

property Version: string;

String containing the current version of your application. This property is not applicable if VersionFromResource has been set to true.


Top

VersionFromResource property

property VersionFromResource: boolean;

Setting VersionFromResource to true instructs the eUpdator component to retrieve version information from the resource. Remember to enable version resource in the project options.


Top

Cancel method

procedure Cancel;

Cancels the current task You should never need to call this method. All tasks are automatically canceled when the eUpdator component is destroyed.


Top

Create method

constructor Create(AOwner: TComponent);

Creates a new instance of the eUpdator component.


Top

Destroy method

destructor Destroy;

Cancels all tasks and then destroys the instance of the eUpdator component.


Top

Execute method

property Execute;

Calling execute from your application will start the eUpdator component. eUpdator searches for the update file and checks if there is a new version available. If there is an update available the eUpdator Application will be launched and the update will be collected. If the eUpdator Application is not installed the first thing the eUpdator component does is to download and install it from the internet.


Top

TLanguages

type TLanguages = ( lgEnglish, lgSwedish );

There are currently two different languages supported by the eUpdator system. We are planning to support more languages in the future, i.e. Spanish, French and German. If you want to support us by translating the software, please contact info@elysian.nu.


Top

INI-files Entries

Earlier versions of the eUpdator registered itself in registry. Due to problems with different rights to the system, we gave up that idea. Using the registry was unnecessary cumbersome. 

On execution the eUpdator component automatically registers itself in the eUpdator.ini file located in the Windows directory. This enables the eUpdator Application to find and make updates. A section with the same name as you have specified in the productKey property will be added in the eUpdator.ini file:

Following values are registered under your <ProductKey> section:

Application    Application property
Language Language property
Path Path of your application
ProductKey ProductKey property
UpdateFile UpdateFile property
Version Version property
 
Top

eUpdator Information Files 

eUpdator uses information files to determine if there is a new version available. Information files are built like a INI-file with sections for each productKey you want the file to support. First you add a section named '[<ProductKey>]' to the file. Following the section is the version information and source where to find the update. The two values are separated by the <TAB> character and may be put inside quotation marks. Source may be located on an ftp, http server or your local network and must be specified as a complete URL. Here is an example of the eUpdator.inf file used on the Elysian Homepage.

[Elysian eUpdator]
"1.0.2.130" "http://www.elysian.nu/eupdator/download/eUpdator.exe"
 

Top

Legal (short version)

The eUpdator Application and eUpdator Client Components are free to use and is provided by Elysian Development "as is". The eUpdator Client Components may be freely distributed. In distributed software using the eUpdator System the eUpdator Application must be downloaded from the internet on every computer. It may not be included in any installation or on any installation media. In short, you may NOT distribute the eUpdator Application without written permission from Elysian Development.

Legal (long version)

PLEASE READ THIS DOCUMENT CAREFULLY. YOU HAVE AGREED TO THE TERMS OF THIS AGREEMENT BEFORE USING THE EUPDATOR COMPONENT IN YOUR APPLICATION.

This is a legal agreement between you and Elysian Development ('Elysian'). This Agreement states the terms and condition upon which Elysian offers to license the use of all parts of the eUpdator system, eUpdator Application, eUpdator Component together with all accompanying items including, but not limited to, the executable programs, libraries and documentation (collectively, the "eUpdator System").

License

1. Grant of License. The Software is licensed, not sold, to you for use only under the terms of this Agreement. This License Agreement is your proof of license to exercise the rights granted herein and must be retained by you. As between you and Elysian, Elysian retains all title to and ownership of the eUpdator System and reserves all rights not expressly granted to you. Elysian grants to you the right to use all or a portion of this system provided that
(a) the eUpdator System is not distributed for profit;
(b) the eUpdator Application is not distributed prior to written permission from Elysian;
(c) the eUpdator System may NOT be modified;
(d) all copyright notices are maintained on the eUpdator System; and
(e) the licensee/end-user agrees to be bound by the terms of this Agreement.

2. Copyright.
The eUpdator System is owned by Elysian, and is protected by Swedish copyright laws and international treaty provisions. You may not remove the copyright notice from any copy of the eUpdator System.

3. Merger or Integration.
You may not merge any of the Development files, eUpdator Component Library into, or integrate with, any other Development Libraries.

4. Decompiling, Disassembling, or Reverse Engineering.
You acknowledge that the eUpdator System contains trade secrets and other proprietary information of Elysian. Except to the extent expressly permitted by this Agreement or by the laws of the jurisdiction where you are located, you may not decompile, disassemble or otherwise reverse engineer the eUpdator System, or engage in any other activities to obtain underlying information that is not visible to the user in connection with normal use of the eUpdator System.
In particular, you agree not for any purpose to transmit the eUpdator System or display the object code on any computer screen or to make any hardcopy memory dumps of the object code. If you believe you require information related to the interoperability of the eUpdator System with other programs, and you agree to request such information from Elysian. Upon receiving such a request, Elysian shall determine whether you require such information for a legitimate purpose and, if so, Elysian will provide such information to you within a reasonable time and on reasonable conditions.
In any event, you will notify Elysian of any information derived from reverse engineering or such other activities, and the result thereof will constitute the confidential information of Elysian that may be use only in connection with the eUpdator System.

Termination
The license granted to you is effective until terminated. You may terminate it at any time by destroying the eUpdator System (including any portions or copies thereof) currently in your possession or control. The license will also terminate automatically without any notice from Elysian if you fail to comply with any term or condition of this Agreement. You agree upon any such termination to destroy the eUpdator System (including any portions or copies thereof). Upon termination, Elysian may also enforce any and all rights provided by law. The provisions of this Agreement that protect the proprietary rights of Elysian will continue in force after termination.

NO WARRANTY
ANY USE BY YOU OF THE EUPDATOR SYSTEM IS AT YOUR OWN RISK. THE EUPDATOR SYSTEM IS PROVIDED FOR USE "AS IS" WITHOUT WARRANTY OF ANY KIND. TO THE MAXIMUM EXTENT PERMITTED BY LAW, ELYSIAN DISCLAIMS ALL WARRANTIES OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, WITHOUT LIMITATION, IMPLIED WARRANTIES OR CONDITIONS OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. ELYSIAN IS NOT OBLIGATED TO PROVIDE ANY UPDATES OR UPGRADES TO THE EUPDATOR SYSTEM

NO LIABILITY FOR DAMAGES, INCLUDING WITHOUT LIMITATION CONSEQUENTIAL DAMAGES
In no event shall Elysian be liable for any damages whatsoever (including, without limitation, incidental, direct, indirect, special or consequential damages, damages for loss of business profits, business interruption, loss of business information, or other pecuniary loss) arising out of the use of inability to use the eUpdator System, even if Elysian have been advised of the possibility of such damages. Because some countries do not allow the exclusion or limitation of liability for consequential or incidental damages, the above limitation may not apply to you.

LOGGING/ADVERTISEMENT
eUpdator reserve the right to advertise in the free eUpdator Application. We also reserve the right to log every time you make an update using the eUpdator Application. Information that will be sent to servers at Elysian includes time of update and name of the updated application. Logging is used only in the development of eUpdator by Elysian and may be removed in future versions.

INDEMNIFICATION BY YOU
If you distribute the eUpdator System in violation of this Agreement, you hereby indemnify, hold harmless and defend Elysian from and against any and all claims or lawsuits, including attorney's fees and costs that arise result from or are connected with the use of distribution of the eUpdator System in violation of this Agreement.

CONTRACTOR/MANUFACTURER
The Contractor/Manufacturer for the eUpdator System is:
Elysian Development
Ramskogsv. 221
S-136 68 HANINGE
SWEDEN
info@elysian.nu