DLL filer i Delphi

DLL filer er en måde hvorpå man kan dele kode mellem flere forskellige programmer. Hvis man f.eks. udgiver nogle programmer, som deler en masse funktionalitet, vil det være smart at placere denne funktionalitet i en DLL fil så man kun behøver at installere den én gang på brugerens computer. Herved sparer man både en smule plads på brugerens harddisk, men det gør det også nemmere at rette fejl, da man kun behøver at opdatere sin DLL fil i stedet for samtlige programmer.

Det kræver dog en lille smule mere arbejde at benytte sig af DLL filer og de kan virke ’skræmmende’ for folk der ikke har prøvet at arbejde med dem. I denne artikel vil jeg give en kort introduktion til hvordan man laver en DLL fil og hvordan man bruger den fra sit normale Delphi program.

For at oprette en DLL fil i Delphi vælger man File -> New -> Other. Vælg DLL Wizard og tryk OK. Delphi generer følgende ’skelet’:

library Project1;

{ Important note about DLL memory management: ShareMem must be the
  first unit in your library's USES clause AND your project's (select
  Project-View Source) USES clause if your DLL exports any procedures or
  functions that pass strings as parameters or function results. This
  applies to all strings passed to and from your DLL--even those that
  are nested in records and classes. ShareMem is the interface unit to
  the BORLNDMM.DLL shared memory manager, which must be deployed along
  with your DLL. To avoid using BORLNDMM.DLL, pass string information
  using PChar or ShortString parameters. }

uses
  SysUtils,
  Classes;

{$R *.res}

begin
end.

Man laver sine functions og procedurer på næsten samme måde som i et normalt program:

library DLLtest;
uses
  SysUtils, Dialogs,
  Classes;

{$R *.res}

procedure Test(); stdcall;
begin
  ShowMessage('Hej fra en DLL');
end;

exports
  Test;

end.

Før man kan kalde sine funktioner fra andre programmer, skal man for det første angive hvilken calling convention der skal bruges, dvs. hvordan funktionen skal eksporteres. Dette gøres på følgende måde:

procedure DinProcedure(parametre); CallingConvention; 

I ovenstående eksempel bliver det til:

procedure Test(); stdcall;

StdCall vil typisk være den calling convention man benytter. Der findes andre måder at gøre det på, men dem vil jeg ikke komme ind på her. Vil man vide mere om den står de beskrevet under ”Calling conventions” i Object Pascal Language Guide hjælpefilen.

Den næste ting man skal gøre er at tilføje funktionen til listen over eksporterede funktioner. I ovenstående eksempel kom det til at så sådan her ud:

exports
  Test;

Compile nu projektet ved at trykke Ctrl+F9 og gem det som DLLtest.

Luk DLL projektet og opret et nyt program ved at sige File -> New -> Application. Start med at gemme dette projekt i den samme mappe som du gemte DLL projektet i.

For at importere en funktion fra en DLL skal man angive navnet på den funktion man vil importere samt hvilken DLL fil den befinder sig i. Dette gøres på følgende måde:

procedure Navn(); external ’NavnetPåDLLFilen.dll’ Name ’NavnetPåFunktionenManVilKalde’;

Bemærk at den funktion man definerer i Delphi ikke behøver at hedde det samme som det funktionen hedder i selve DLL filen. Hvis man ønsker at omdøbe funktionen skal man angive hvad funktionen hedder i DLL filen efter Name. Hvis man ikke vil omdøbe funktionen kan Name-delen udelades.

For at importere funktionen fra den DLL fil der blev lavet tidligere skriver man:

procedure DLLTest(); External 'DLLtest.dll' Name 'Test';

Funktionen er her importeret som DLLTest() selvom den hedder Test i DLL filen. Man kunne også have valgt at skrive:

procedure Test(); External 'DLLtest.dll' Name 'Test';

eller

procedure Test(); External 'DLLtest.dll';

Resultatet bliver det samme.

Placer nu en knap på formen og opret en OnClick event og prøv at kalde Test().

Den fulde source kode til programmet kommer til at se sådan her ud:

unit Hovedprogram;

interface

uses
  Windows, Messages, SysUtils, Variants, Classes, Graphics, Controls, Forms,
  Dialogs, StdCtrls;

procedure Test(); External 'DLLtest.dll';

type
  TForm1 = class(TForm)
    Button1: TButton;
    procedure Button1Click(Sender: TObject);
  private
    { Private declarations }
  public
    { Public declarations }
  end;

var
  Form1: TForm1;

implementation

{$R *.dfm}

procedure TForm1.Button1Click(Sender: TObject);
begin
  Test;
end;

end.

Hvis man har fået mod på at lære mere om DLL filer kan man læse følgende tre artikler:

Forms i DLLer af Thomas Due
Forms i DLL af Jens Borrisholt
Dynamisk læsning af DLL af Jens Borrisholt