|
1.Autorun22 overview |
| Autorun22 is an application providing the conventional autorun functionality - i.e.,
being placed on an installation CD it starts working once a user inserts the CD
into a drive.
|
| Autorun22 is a "generic" autorun application, which can be easily adopted to
the purposes of every installation.
|
| That is achieved by a kind of separation the proper autorun functions (visualization,
interaction with MS Windows shell, etc.) and the functionality specific for the
user's application.
|
| The first part of the functionality performed by the execuatable AR22.EXE,
the second part is described by the installation html page.
|
| For your conveniense, the installation package includes a sample installation page index.html.
|
|
2.Installation HTML page |
| The installation html page is any web page created with your favorite HTML editor,
it may contain any graphics and text you want (i.e. you may utilize your company web site
artworks or create something entirely new or even use index.html as a source...),
only 3 of its elements are really required by Autorun22:
|
| the page title is used (naturally) as an autorun window caption,
|
| the "shell" function and the "size" table are described below.
|
|
3.The "Shell" function |
| The shell function is a javascript (or VB-script) function defined in a following way
using javascript syntax:
|
| Default function name is 'T22Shell'. This function can be empty.
|
| function T22Shell( verb , object )
|
| { |
| ... |
| // if the installation page contains animations or other objects relaying on |
| // the web browser internal timers, |
| // we recommend adding the follow line at the end of the function body |
| // document.reload(); |
| } |
| The function name may be different, but the number of parameters must be 2, and all
arguments of every function call must evaluate to strings.
|
| You may include any javascript code into the shell function body - there are no restrictions.
|
| The verb parameter stays for any applicable MS Windows shell verb:
|
| "open", "explore", "print", etc.
|
| It may be left empty ("") - in this case the default MS Windows shell verb is assumed, depending on
the object value.
|
| The object parameter usually indicates the MS Windows shell object to perform a verb action
on it - that may be absolute URL, full file or folder path, or the installation page URI , corresponding
to a file system object.
|
| To run a particular shell command use regular HTML hyperlink in a following way: |
| <A href = "javascript:T22Shell(verb_value , object_value)">...</A> |
| Note : don't forget to enclose string function arguments into single quotes to comply with
the javascript syntax.
|
| Autorun22 passes both verb and source parameters to the MS Windows shell
(if the object is an installation page URI, Autorun22 translates it to the corresponding file system path,
see 5. for more information)
|
| The reserved verb value of "close" is used by Autorun22 to close the application.
|
|
4.The "Size" table |
| The "Size" table is an installation page element used by Autorun22 to identify the size and position
of the autorun window.
|
| The Size table may be any valid HTML table, Autorun22 displays in its window only the contents
of the Size table, so we recommend to enclose all visible HTML elements of the installation page
to the Size table.
|
| An example may be found in the index.html:
|
| <TABLE name="T22Frame" id="T22Frame" border="0" cellspacing="1" width=75%>
....
</TABLE>
|
| Default table name and id is 'T22Frame'.
|
| The name and id of the table may be arbitrary, but we recommend keeping name identical to id . |
|
5.The installation page URIs |
| Sometimes (actually, almost always) it is convenient not to define an absolute installation file path
in the installation page source, but to write this page relatively either to the Autorun22 executable
file (which is usually placed in the root directory of a CD) or to the installation page itself.
|
| To enable that, Autorun22 supports a following convention:
|
| 1. Every object value in a call to the Shell function which is not empty, is not a fully qualified URL and
is not a full file system path or network file path is treated as an Installation Page URI.
|
| 2. Each absolute Installation Page URI is interpreted assuming the AR22.EXE path being a root, i.e.
if the AR22.EXE path is G:\Ar22.exe
|
| and a URI looks like "/Install/MyApp.exe",
|
| then the resulting file path is G:\Install\MyApp.exe
|
| 3. Each relative Installation Page URI is interpreted in relation to the installation html page, i.e.
if the URI looks like "Documents/Chapter1/Index.html" and
the installation page path is G:\Install\Install.htm,
then the resulting file path isis G:\Install\Documents\Chapter1\Index.html
|
|
6.Autorun22 command line options |
| Autorun22 executable command line normally looks in a following way:
|
|
|
| ar22.exe <Installation page URI> [-t <"Size" table id>] [-f <"Shell" function name>] [-xsize <xxx>] [-ysize <yyy>]
|
|
|
| where
|
| Part |
Description |
| <Installation page URI> |
A path to the Installation HTML page in a form of absolute installation page URI. I.e. if the installation html page MyInstall.htm is placed into the Install\HTML folder on the installation CD, and ar22.exe is in the CD root directory, this parameter must be Install/HTML/MyInstall.htm.
This parameter is required |
| <"Size" table id> |
A "Size" table id used in the installation HTML page.
This parameter may be omitted if the default T22Frame table name is used. |
| <"Shell" function name> |
A "Shell" function name used in the installation HTML page.
This parameter may be omitted if the default T22Shell function name is used. |
| <xxx> |
(Optional) horizontal size of the autorun window in pixels.
If this parameter is omitted, the window is sized to fit the "Size" table.
If the xxx value is not sufficient, the horizontal scroll bar will apear in the autorun window |
| <yyy> |
(Optional) vertical size of the autorun window in pixels.
If this parameter is omitted, the window is sized to fit the "Size" table.
If the yyy value is not sufficient, the vertical scroll bar will apear in the autorun window |
|
| Example:
ar22.exe index.html -t ar22frame -f ar22shell
|
|
|
|
|
|
7.Autorun22 distribution and trial vesion restrictions |
| If you are still in your trial period (30 days) you may use ar22.exe only on the computer it was originally
installed |
| When you purchasing and registering, Autorun22 enables full functionality (and unrestricted copying)
instantly, there is no need to re-install it.
|
| To distribute Autorun22 with your installation CD:
|
| 1. Copy Ar22.exe to the CD image;
|
| 2. Create the installation html page (you may use index.html supplied with the installation package
as a template) and save it to the CD image including the accompanying graphics;
|
| 3. Create the autorun.inf file (you may use one supplied with the installation package
as a template) and save it to the root of the CD image;
|
|
8.Example autorun.inf |
| Example autorun.inf :
|
| [autorun]
|
| open= ar22.exe index.html -t ar22frame -f ar22shell
|