6.3. Installing Mozilla Applications

Example 6-9. Simple install script

// initialize the installation first
initInstall("My Package Install", "package_name", "1.0", 1);
// add files to the installation
f = getFolder("Program");
setPackageFolder(f);
addFile("package.xpi")
// perform the installation
performInstall( );

Example 6-10. Script that explicitly prefixes the Install object

Install.initInstall("My Package Install", "package_name", "1.0", 1);
f = Install.getFolder("Program");
Install.setPackageFolder(f);
Install.addFile("package.xpi")
Install.performInstall( );

Example 6-11. A more complicated install script

var vi = "10.10.10.10";
var xpiSrc = "adddir1";
initInstall("addFileNoVers1", "adddir_1", vi, 1);
f = getFolder("Program");
setPackageFolder(f);
err = addDirectory(xpiSrc);
logComment("the error = " + err);
if (0 == getLastError( ))
  performInstall( );
else
  cancelInstall( );

Example 6-12. Trigger script on a web page

<a href="#"
   onclick="InstallTrigger.installChrome(
   InstallTrigger.SKIN,
   'http://wildskins/newblue.xpi',
   'newblue/1.0');">
   Install the New Blue theme</a>

Example 6-13. Scriptless install of a JAR

<a href="#"
   onclick="InstallTrigger.installChrome(
   InstallTrigger.SKIN,
   'http://wildskins/newblue.jar',
   'newblue/1.0');">
   Install the New Blue theme</a>

Example 6-14. Getting the operating system in an install script

function getPlatform( )
{
    var platformStr;
    var platformNode;
    if('platform' in Install)
    {
        platformStr = new String(Install.platform);
        if (!platformStr.search(/^Macintosh/))
            platformNode = 'mac';
        else if (!platformStr.search(/^Win/))
            platformNode = 'win';
        else
            platformNode = 'unix';
    }
    else
    {
        var fOSMac  = getFolder("Mac System");
        var fOSWin  = getFolder("Win System");
        logComment("fOSMac: "  + fOSMac);
        logComment("fOSWin: "  + fOSWin);
        if(fOSMac != null)
            platformNode = 'mac';
        else if(fOSWin != null)
            platformNode = 'win';
        else
            platformNode = 'unix';
    }
    return platformNode;
}

Example 6-15. install.log

-------------------------------------------------------------------------------
http://books.mozdev.org/examples/xfly.xpi  --  06/28/2002 19:12:59
-------------------------------------------------------------------------------
     Install xFly (version 0.0.1)
     ------------
     [1/4]    Installing: C:\MOZILLA\BIN\chrome\xfly.jar
     [2/4]    Register Content: jar:resource:/chrome/xfly.jar!/content/
     [3/4]    Register Skin: jar:resource:/chrome/xfly.jar!/skin/
     [4/4]    Register Locale: jar:resource:/chrome/xfly.jar!/locale/en-US/
     Install completed successfully  --  06/28/2002 19:13:03

Example 6-17. Install script callback

function doneFn (name, result)
{
   if (result != 0 && result != 999)
     alert("The install didn't seem to work, you could maybe try " +
           "a manual install instead.\nFailure code was " + result + ".");
   else
     alert("Installation complete, please restart your browser.");
}
function install(packageName, fileName)
{
   var xpi = new Object( );
   xpi[packageName] = fileName;
   InstallTrigger.install(xpi, doneFn);
}
<a href="javascript:install('xFly','xfly.xpi');">install</a>

Example 6-18. Non-Mozilla software installation script

var xpiSrc = "file.txt";
initInstall(
  "Adding A File", 
  "testFile", 
  "1.0.1.7", 
  1);
f = getFolder("Program"); // keyword for the main program
                          // directory on the target platform
                          // (e.g., the "Program Files" dir on win32)
setPackageFolder(f);
addFile(xpiSrc);
if (0 == getLastError( ))
    performInstall( );
else
    cancelInstall( );