PE Builder v3 hjelp
Oversikt over innhold

Plugin filformat


  1. Innledning
  2. Lage en plugin
  3. PEBuilder del
  4. WinntDirectories del
  5. SourceDisksFiles del
  6. SourceDisksFolders del
  7. Software.AddReg del
  8. Software.DelReg del
  9. SetupReg.AddReg del
  10. Default.AddReg del
  11. Default.DelReg del
  12. AddLine del
  13. DelLine del
  14. SetValue del
  15. Append del
  16. Variables

Innledning

Dette dokumentet skal hjelpe deg til å lage eller endre PE Builder pluginfiler. main .inf filen for PE Builder er pebuilder.inf filen. Vennligst ikke endre denne filen! Dersom du vil endre noe så bruk en pluginfil. Alle plugins finner du i plugin mappen. Alle .inf filene i plugin-mappen (spiller ingen rolle i hvilken mappe) med en "pebuilder" del regnes som en gyldig plugin for PE Builder. Bruk Aktivere/Deaktivere-knappen i plugindialogen for å skru plugins på eller av.

Lage en plugin

En plugin .inf fil må være en ascii fil, ikke unicode. Linjer som starter med et ";" (semikolon) blir ignorert (brukt for kommentarer).

Enhver pluginfil burde starte med linjene som vist nedenfor:

; PE Builder v3 plug-in INF file
; Created by Bart Lagerweij
; http://www.nu2.nu/pebuilder/
;
; Kort beskrivelse av hva denne plugin gjør...

[Version]
Signature= "$Windows NT$"

[PEBuilder]
Name="NiceNameOfPlugin"
Enable=0
Help="pluginhelp.htm"
Legg merke til at du må innkludere [Version] Signature= "$Windows NT$" informasjonen. Ellers kan ikke setupapi funksjonen åpne .inf filen. Vennligst bruk informasjonen nedenfor til å legge til flere deler til dine plugins...

PEBuilder del

Dersom du lager en plugin, din .inf file ha en [PEBuilder] del!
Namenavnet for din plugin
Enabletilstanden til din plugin
0 - Deaktivert
1 - Aktivert
Helpfilenavnet for plugin hjelpefilen. Dette kan være en tekst, html, doc, pdf eller alle andre filtyper. PE Builder bruker ShellExecute() funksjonen for å starte documentet med dets standard assosiasjoner .
Configfilnavnet for konfigurasjonsfilen.

WinntDirectories del

WinntDirectories-delen er i følgende format:
directoryID=dirname[, attribute]

der...
directoryIDer mappenummeret (id)
I plugin .inf filer kan du bruke 'a'-'z' for dynamisk nummer-tilvisning...
dirnameer navnet på mappen. Dersom navnet inneholder mellomrom så sett anførselstegn "rundt det".
attributenumerisk verdi for å aktivere/deaktivere enkelte valg
verdi:
1 - Lag alltid denne mappen (selv når den er tom)
2 - Lag mappen ut fra (output) root (i \ og ikke i \i386).
Bare legg til verdiene for å kombinere...
Standard verdi for attr er 0.

Eksempel:
[WinntDirectories]
; Lag alltid en mappe i root som kalles "Bart"
a="Bart",3
; Lag en mappe i rooten som kalles "Project\Bart\Source"
b="Project\Bart\Source",3
; Lag en mappe i i386 mappen som kalles "extra\files"
c="extra\files",1

Her er en liste over (de mest brukte) mappe-ID'ene:
IDDirectoryRemark
30000[root]PE Builder output root
1\SystemRoot (på CD er dette \i386 mappen, på hd så er dette \minint mappen)
2system32
3system32\config
4system32\drivers
5system
17system32\drivers\etc
20inf
21Help
22Fonts
24msagent\intl
52msagent
124WinSxS
125WinSxS\Manifests
252WinSxS\Policies

PE Builder bruker mappe id'er som starter fra 30000. der id 30000 er brukt for output root-mappen. 30001 og oppover blir dynamisk brukt av PE Builder.

SourceDisksFiles del

SourceDisksFiles[.build]

Denne delen blir brukt til å kopiere filer. Dersom du legger til et build nummer etter navnet på delen, så vil den delen bare bli bruk når kildemediene er fra den builden.

BuildVersion
2600Windows XP
3790Server 2003

SourceDisksFiles delen bruker følgende format:
filename=directoryID[, filenameRenamed][, attribute]

der...
filenameer filen som skal kopieres.
directoryIDer målmappens nummer. Se WinntDirectories delen for en liste over standard windows-mappe id'er.
filenameRenameder mål-filnavnet dersom du trenger å bytte navn.
attributenumerisk verdi for å aktivere/deaktivere noen valg
verdi:
1 - brukes for pluginCheck(). Sørg for at filen eksisterer i den samme mappen som .inf filen befinner seg, før aktivering eller før du fortsetter.
2 - ikke komprimer filen.
4 - bare kopier filen dersom den eksisterer. Ikke klag dersom den ikke eksisterer.
8 - endre filnavnet til store bokstaver. Når du bygger en ISO image vil PE Builder endre windows filnavnene til store bokstaver (nødvendig for å starte fra CD).
Standardverdi for denne funksjonen er 0.

SourceDisksFolders del

SourceDisksFolders[.build]

Denne delen blir brukt til å kopiere hele mapper og filer. SourceDisksFolders bruker følgende format:
sourcepath=directoryID

der...
sourcepather kilde-filen/mappen det skal kopieres fra. Dette er en eksakt kopi, ingen ting er pakket ut!
directoryIDer målmappens nummer. Se WinntDirectories delen for en liste over standard windows.mappe id'er.

Eksempel:
[WinntDirectories]
a="Programs\openoffice",2

[SourceDisksFolders]
; når openoffice-mappen er i plugin-mappen
openoffice=a

[SourceDisksFolders]
; når openoffice-mappen er i c:\
c:\openoffice=a

Software.AddReg del

Software.AddReg[.build]

Legg registry keys til i HKEY_LOCAL_MACHINE\SOFTWARE.
Denne delen er i følgende format:
regType, regKey, regValue, regData

der...
regTypespesifiserer type informasjon som skal lagres som verdiens data. Denne parameteren kan være en av de følgende verdier:
0x0, (REG_NONE) create the key only, no value
0x1, (REG_SZ) string
0x2, (REG_EXPAND_SZ) string (with environment variable references)
0x3, (REG_BINARY) binary data
0x4, (REG_DWORD) 32-bit number
0x7, (REG_MULTI_SZ) multiple strings
* Obs: må starte med "0x" (små bokstaver)!
regKeyspecifies the name of the key as string.
regValuespecfies the name of the value as string.
regDataThe actual data.

Eksempel:
0x1, "Microsoft\Windows NT\CurrentVersion\Fonts", "Tahoma (TrueType)","TAHOMA.TTF"
0x2, "Control Panel\desktop", "WallPaper", "%systemroot%\system32\nu2.bmp"
0x3, "ControlSet001\Control\TimeZoneInformation", "DaylightStart",\
	00,00,04,00,00,01,00,02,00,00,00,00,00,00,00,00
0x4, "ControlSet001\Control\GraphicsDrivers\DCI", "Timeout", 0x7
0x7, "ControlSet001\Services\VgaSave\Device0", "InstalledDisplayDrivers","vga", "framebuf", "vga256", "vga64k"

SetupReg.AddReg del

SetupReg.AddReg[.build]

Legg til registry keys til "SetupReg.hiv" registry hiven. Samme syntax som Software.AddReg

Default.AddReg del

Default.AddReg[.build]

Legg til registry keys til HKEY_CURRENT_USER.
Samme syntax som Software.AddReg

Software.DelReg del

Software.DelReg[.build]

Slett registry keys fra "Software" registry hiven. Denne delen er i følgende format: regKey[, regValue]

der...
regKeyspesifiserer navnet til din key (innklusive alle verdier) for å slette som string.
regValuespesifiserer navnet til verdien som skal slettes som string.

Default.DelReg del

Default.DelReg[.build]

Slett registry keys fra "Default" registry hiven. Samme syntax som Software.DelReg

AddLine del

AddLine[.build]

Legger linjer til en del. Linjene i AddLine delen har følgende format:
Filename,Section,StringToAdd

der...
Filenameer filnavnet der det skal legges til enlinje.
Sectioner del-navnet.
LineToAdder linjen som skal legges til.

Eksempel:
"netmscli.inf", "MSClient.DelReg", "HKLM, Software\Microsoft\Rpc\SecurityService, 9"

DelLine del

DelLine[.build]

Sletter linjer fra en file. Linjene i DelLine delen har følgende format:
Filename,Section,StringToDel

der...
Filenameer filnavnet som det skal legges til en linje til.
Sectiondette er delnavnet.
StringToDeler linjen som skal slettes. Du trenger ikke å matche nøyaktig, all linjer som begynner med "StringToDel" vil bli slettet.

Eksempel:
"netmscli.inf", "MSClient.Browser.AddReg", "HKR, Parameters, MaintainServerList,"

SetValue del

SetValue[.build]

Skriv verdi til fil. Linjene i SetValue delen har følgende format:
Filename,Section,Key,Value

der...
Filenameer filnavnet det skal settes en verdi inn i.
Sectioner delnavnet.
Keyer nøkkelen (key) som skal motta verdien.
Valueer dataene.

Eksempel:
"netmscli.inf", "Alerter_Service_Inst", "StartType", "3"

Use Filename,Section,Key for å fjerne en key
Use Filename,Section for å fjerne en hel del

Append section

Append[.build]

Henge en fil på en annen fil. Linjene i Append delen har følgende format:
Filename,FilenameToAppend

der...
Filenameer filen der dataene vil bli hengt på.
FilenameToAppender filen som inneholder data som skal henges på.

Eksempel:
nu2menu.xml, penero_nu2menu.xml

Variabler

De fleste string-feltene i pluginfilen kan ha noen spesielle PE-Builder variabler:
Syntax: @variable@

der...
variableexpanderer til...
ProgramNavnet på byggeren (PE-Builder som standard)
VersionVersjonen til byggeren
IsoFileFull sti og filnavn til ISO image
OutDirFull sti til mål-mappen
SourcePathFull sti til kilde-mappen
PluginDirFull sti til den aktuelle plugin-mappen
PluginFileFull sti og filnavn til den aktuelle plugin-filen
LanguageDet aktuelle språket
VerboseVerbose mode (0 betyr av, 1 betyr på)
BuildWindows build-nummer (2600 betyr XP, 3790 betyr server 2003)

Eksempel:
[SourceDisksFiles]
program.exe=2,,3
lang\@language@.lng=2,,3

Der lang\@language@.lng vil bli pakket ut til lang\german.lng (Hvis tysk språk er valgt).

Oversikt over innhold

PE Builder Copyright (c) 2002-2006 Bart Lagerweij. All rights reserved.