Programmeren: beschrijving Internet Updater
  • De Internet Updater kun je hier downloaden.

    Wat is Internet Updater?
    Internet Updater is een .dll bestand dat je kunt gebruiken voor je zelf geschreven programma's. Door deze dll aan te roepen, kun je de gebruikers hun versie van jouw programma laten controleren en, als er een nieuwere versie is, laten downloaden en installeren. De dll is geschreven in Delphi. Het meegeleverde interface is ook voor Delphi. Voor andere programmeertalen zal je wat vertaal werk moeten doen.

    Hoe te gebruiken?
    En controleren op versie, ophalen van de update en het starten van de installatie daarvan, wordt allemaal in gang gezet met één enkele aanroep naar de dll. In Delphi ziet dat er als volgt uit:

    DoInternetUpdate( PChar(productName),
    PChar(proxyName),
    PChar(proxyPort),
    PChar(proxyUser),
    PChar(proxyPass),
    PChar(updInfoUrl),
    PChar(FileVersion),
    (language),
    PChar(path2upd),
    useIEsettings);

    Alle parameters moeten als PChar aan de dll worden doorgegeven behalve language (integer) en useIEsettings (boolean). De parameters hebben de volgende betekenis:

    parameter verplicht omschrijving voorbeelden
    productName J Dit is de naam van het programma zoals die in de Internet Updater zal worden getoond. 'PuzzelWoorden Zoeker', 'Internet Updater'
    proxyName N Als de gebruiker via een proxy-server verbinding maakt met het internet, dan kan in deze parameter de naam van de proxy-server worden meegegeven naar de dll. 'proxyserver', ''
    proxyPort N Als er een proxy-server wordt gebruikt, via welke poort moet die dan benadert worden? '8080', '3128', ''
    proxyUser N Als er een proxy-server wordt gebruikt, met welke gebruikersnaam moet er aangemeld worden (niet altijd nodig)? 'kees', 'janssen', ''
    proxyPass N Als er een proxy-server wordt gebruikt, wat is dan het wachtwoord dat hoort bij de gebruikersnaam (niet altijd nodig)? 'wachtwoord', 'password', ''
    updInfoUrl J Via deze parameter geef je de url van het update-informatie bestand door aan de dll. Zie verderop voor een beschrijving van dit bestand. 'www.jouwsite.nl/download/prog.upd'
    FileVersion J Via deze parameter geef je de huidige versie van je programma mee naar de dll. De dll gaat deze versie vergelijken met de versie zoals die wordt gevonden in het update bestand. '1.2.3.56'
    language J Hiermee selecteer je de taal van alle teksten die in de Internet Updater worden gebruikt. Op dit moment worden alleen nederlands en engels ondersteund. Met de waarde 1 selecteer je nederlands, met 2 engels. Let op! Dit is een integer waarde! '1' of '2'
    path2upd J Hiermee geef je aan in welke directory de update moet worden ge-download. 'c:\temp', 'c:\windows\temp'
    useIEsettings J Hiermee geef je of de updater de instellingen van Ineternet Explorer moet gebruiken of niet. Als je deze op True zet, dan worden alle instellingen van de proxy-server niet gebruikt. Let op! Dit is een boolean variabele! True, False

    Als een parameter niet verplicht is, dan kun je een nul-string meesturen. Hij moet wel op de juiste plaats worden mee gegeven. Een aanroep zou er als volgt uit kunnen zien:

    Zonder proxy-server Met proxy-server
    DoInternetUpdate( PChar('MijnProgrammaNaam'),
    PChar(''),
    PChar(''),
    PChar(''),
    PChar(''),
    PChar('www.jouwsite.nl/download/prog.upd'),
    PChar('2.1.4.78'),
    ('1'),
    PChar('c:\temp'),
    False);
    DoInternetUpdate( PChar('MijnProgrammaNaam'),
    PChar('proxy'),
    PChar('8080'),
    PChar('jan'),
    PChar('password'),
    PChar('www.jouwsite.nl/download/prog.upd'),
    PChar('2.1.4.78'),
    ('2'),
    PChar('c:\windows\temp'),
    False);