InstallBuilder User Guide 24

<component>
   <name>autoupdater</name>
   <description>includes tool to perform updates</description>
   <canBeEdited>0</canBeEdited>
   <selected>1</selected>
   <show>0</show>
   <folderList>
       <folder>
           <name>autoupdaterwin</name>
           <destination>${installdir}</destination>
           <platforms>windows</platforms>
           <distributionFileList>
               <distributionFile origin="autoupdater-windows.exe"/>
           </distributionFileList>
       </folder>
       <folder>
           <name>autoupdaterlinux</name>
           <destination>${installdir}</destination>
           <platforms>linux</platforms>
           <distributionFileList>
               <distributionFile origin="autoupdater-linux.run"/>
           </distributionFileList>
       </folder>
   </folderList>
   <postInstallationActionList>
       <writeFile>
           <path>${installdir}/update.ini</path>
           <text>[Update]
url = ${update_xml_url}
version_id = ${application_version_id}
update_download_location = ${system_temp_directory}
check_for_updates = 1
</text>
       </writeFile>
   </postInstallationActionList>
</component>

$ autoupdater.run --mode unattended

if (system("path/to/autoupdater --mode unattended") == 0){
 printf("Update available. Run autoupdate to apply it.");
}

<autoUpdateInitializationActionList>
  <throwError>
    <text>Another instance is running. This instance will abort</text>
    <ruleList>
      <singleInstanceCheck logic="is_running" />
    </ruleList>
  </throwError>
</autoUpdateInitializationActionList>

  <postUpdateDownloadActionList>
     <!-- Execute some validations here -->
     ...
     <!-- The path to the downloaded update will be stored in
     the ${downloadedFilePath} built-in variable. We calculate the MD5 -->
     <runProgram>
       <program>md5sum</program>
       <programArguments>${downloadedFilePath}</programArguments>
     </runProgram>
     <!-- You can use any action like using httpGet to retrieve a valid
     value for the md5sum or directly send the md5 to the server to validate it it -->
     <throwError>
        <text>It seems the downloaded installer was corrupted</text>
        <ruleList>
          <compareText>
            <text>${program_stdout}</text>
            <logic>does_not_equal</logic>
            <value>${someExpectedValue}</value>
          </compareText>
        </ruleList>
     </throwError>
     ...
     <!-- Launch the installer -->
     <runProgram>
         <program>${downloadedFilePath}</program>
         <programArguments>--prefix /tmp/someDir --enable_component_a 1 --is_update 1 &amp;</programArguments>
     </runProgram>
 </postUpdateDownloadActionList>

autoupdate-linux.run --mode unattended

<?php

/* Define the higher version released*/
$maxVersion=12;

/* Get the current version sent by the autoupdate */
$version=$_GET['versionId'];

/* Check if the requested version is correct */
if (!isset($_GET["versionId"]) || $_GET["versionId"] > $maxVersion) {
  echo "Incorrect version";
  exit();
} else {
  /* Depending on the current version, we decide which update to deliver */

  /* We provide an update pack for versions in the range 1-3 */
  if ($version < 4 ) {
     $file="update-pack-1.xml";

  /* We provide an update pack for versions in the range 4-7 */
  } elseif ($version < 8 ) {
     $file="update-pack-2.xml";

  /* For versions below the max, we deliver the next one */
  } elseif ($version < $maxVersion) {
     $file="update".($version+1).".xml";

  /* For the latest version, we resend it, it will be discarded by the AutoUpdate */
  } else {
     $file="update".$maxVersion.".xml";
  }

  $data=file_get_contents('./versions/'.$file);
  echo $data;
  exit();
}
?>

<project>
   <!-- bundled version -->
   <versionId>100</versionId>
   ...
   <componentList>
      <component>
         <name>autoupdate</name>
         <folderList>
           <folder>
             <name>autoupdate</name>
             <destination>${installdir}/autoupdate</destination>
               <distributionFileList>
                 <distributionFile>
                   <origin>path/to/autoupdate.run</origin>
                 </distributionFile>
               </distributionFileList>
           </folder>
         </folderList>
      </component>
   </componentList>
   ...
   <parameterList>
      <!-- This parameter will be used to enable/disable checking for updates -->
      <booleanParameter name="enableUpdates" ask="0" value="1"/>
   </parameterList>

   <!-- After installing the bundled version, we query our servers for updates -->
   <postInstallationActionList>
     <!-- Write the initial update.ini file -->
     <writeFile>
       <path>${installdir}/autoupdate/update.ini</path>
       <text>[Update]
url = http://www.example.com/versions.php?versionId=${project.versionId}
version_id = ${project.versionId}
update_download_location = ${installdir}/autoupdate/updateInstallers
check_for_updates = 1
</text>
     </writeFile>

     <!-- Keep asking for updates while available -->
     <while>
       <actionList>
         <showProgressDialog>
            <actionList>
              <runProgram progressText="Checking for updates...">
                 <abortOnError>0</abortOnError>
                 <showMessageOnError>0</showMessageOnError>
                 <program>${installdir}/autoupdate/autoupdate.run</program>
                 <programArguments>--mode unattended</programArguments>
              </runProgram>
            </actionList>
         </showProgressDialog>
         <!-- Break the loop if there is no update available (exit code > 0) -->
         <break progressText="No Update Available">
           <ruleList>
             <compareValues>
               <value1>${program_exit_code}</value1>
               <logic>greater</logic>
               <value2>0</value2>
             </compareValues>
           </ruleList>
         </break>
         <showProgressDialog>
           <actionList>
             <runProgram progressText="Downloading the update...">
               <program>${installdir}/autoupdate/autoupdate.run</program>
               <programArguments>--mode unattended --unattendedmodebehavior download</programArguments>
               </runProgram>
             </actionList>
         </showProgressDialog>
       </actionList>
       <conditionRuleList>
         <isTrue value="${parameter(enableUpdates).value}"/>
       </conditionRuleList>
     </while>
   </postInstallationActionList>
</project>

<autoUpdateProject>
   ...
   <postUpdateDownloadActionList>
     <!-- Launch the update specifying the ${installdir} and disabling checking for updates -->
     <runProgram>
         <program>${downloadedFilePath}</program>
         <programArguments>--prefix "${installer_directory}/../" --enableUpdates 0 --mode unattended --unattendedmodeui minimalWithDialogs</programArguments>
     </runProgram>
   </postUpdateDownloadActionList>
</autoUpdateProject>