Adding a new interface: what changed
Revision 4 to 5. Removed lines have a minus sign; added lines have a plus sign.
| Old | New | Line | |
|---|---|---|---|
| 1 | 1 | This article describes the steps to add a new widgetset interface. This article is intended for developers who want to make an existing widget set available for use with the LCL. It describes the first steps to set up the directories and adapt the IDE for developing the new interface. | |
| 2 | 2 | ||
| 3 | 3 | ## Steps | |
| 4 | 4 | ||
| 5 | 5 | As example we write the steps for adding a new interface for the *pogo* widget set. | |
| 6 | 6 | ||
| 7 | 7 | ### Register the new widgetset in the IDE | |
| 8 | 8 | ||
| 9 | 9 | In the file lcl/interfacebase.pp add *lppogo* to TLCLPlatform add 'pogo' to LCLPlatformDirNames. Add 'pogo' to ide/lazconf.pp (LCLPlatformDisplayNames). | |
| 10 | 10 | ||
| 11 | 11 | Then rebuild the IDE with the LCL and restart it. You should now see the new wigdetset in the 'Configure build lazarus' dialog. Now the codetools know about it and basic code functions will work. | |
| 12 | 12 | ||
| 13 | 13 | ### Create a directory for the interface | |
| 14 | 14 | ||
| 15 | 15 | Create a subdirectory pogo in lazarus\lcl\interface. | |
| 16 | 16 | ||
| 17 | 17 | Then copy the Makefile.fpc from one of the existing widgetsets and adapt it. For example change the *unittargetdir*. Then create the Makefile with [[Fpcmake]]: | |
| 18 | 18 | ||
| 19 | 19 | For *nix: | |
| 20 | 20 | ||
| 21 | - | ||
| 21 | + | ```text | |
| 22 | 22 | cd lazarus/lcl/interfaces/pogo | |
| 23 | 23 | export FPCDIR=/home/username/fpc_sources_trunk/ | |
| 24 | 24 | fpcmake -Tall | |
| 25 | 25 | export FPCDIR= | |
| 26 | 26 | ``` | |
| 27 | 27 | ||
| 28 | 28 | For windows: | |
| 29 | 29 | ||
| 30 | - | ||
| 30 | + | ```text | |
| 31 | 31 | cd lazarus\lcl\interfaces\pogo | |
| 32 | 32 | set FPCDIR=lazarus\fpc\source | |
| 33 | 33 | lazarus\fpc\2.3.1\bin\i386-win32\fpcmake -Tall | |
| 34 | 34 | set FPCDIR= | |
| 35 | 35 | ``` | |
| 36 | 36 | ||
| 37 | 37 | You **must** use fpcmake from the latest and greatest and unstable FPC version, so that all FPC platforms are known in the Makefile. For the source it is less critical. The last line sets the variable FPCDIR to none. Otherwise other Makefiles will be auto regenerated too, which can accidently break things. So better make sure with the last line that FPCDIR is not set. | |
| 38 | 38 | ||
| 39 | 39 | Then copy the interfaces.pp from one of the other widgetsets and adapt it. For example rename the widgetset class to TPogoWidgetSet. | |
| 40 | 40 | ||
| 41 | 41 | Then create a first unit pogoint.pp for the new class TPogoWidgetSet. Every widgetset needs to override some abstract methods. Position the blinking cursor on class and use the refactoring tool Source Editor / Popup menu / Refactoring / Show abstract methods to automatically add the method stubs. Don't forget to use pogoint in the new interfaces.pp. | |
| 42 | 42 | ||
| 43 | 43 | ### Update Makefiles | |
| 44 | 44 | ||
| 45 | 45 | Edit lazarus\lcl\interfaces\Makefile.fpc and append *pogo* to the Target directories | |
| 46 | 46 | ||
| 47 | 47 | [target] | |
| 48 | 48 | dirs=gtk gtk2 win32 wince qt carbon fpgui pogo | |
| 49 | 49 | ||
| 50 | 50 | Generate the Makefile in lazarus\lcl\interfaces using [[Fpcmake]]. | |
| 51 | 51 | ||
| 52 | 52 | ### Add widgetset directory to update_allunits | |
| 53 | 53 | ||
| 54 | 54 | Add a line in lcl/update_allunits.lpr for the *pogo* widgetset. You will need to run this program as you implement the PogoWSxxxx units. I used | |
| 55 | 55 | ||
| 56 | - | ||
| 56 | + | ```text | |
| 57 | 57 | instantfpc ./update_allunits.lpr | |
| 58 | 58 | ``` | |
| 59 | 59 | ||
| 60 | 60 | Or you could run | |
| 61 | 61 | ||
| 62 | - | ||
| 62 | + | ```text | |
| 63 | 63 | lazbuild ./update_allunits.lpr | |
| 64 | 64 | ./update_all_units | |
| 65 | 65 | ``` | |
| 66 | 66 | ||
| 67 | 67 | You can now compile your new widgetset in the IDE, by setting the widgetset in the 'Configure build lazarus' dialog. | |
| 68 | 68 | ||
| 69 | 69 | ### Compiler options / search paths | |
| 70 | 70 | ||
| 71 | 71 | If the new widgetset has subdirectories or need some extra flags, then these must be added to the Makefile (e.g. lcl/interfaces/pogo/Makefile) **and** to the LCL.lpk. Otherwise: ask Mattias via mail. | |
| 72 | 72 | ||
| 73 | 73 | --- | |
| 74 | 74 | *From the Free Pascal wiki, page "Adding a new interface", as it stood on 2021-02-21 after a change by Mattias2, out of the wiki's dump of 2024-05-26. Copyright stays with the author who wrote it, according to the old wiki's [[Licensing]] page. If you have concerns about this material, [message the admin](/wiki-contact).* | |
| 75 | 75 | Category: LCL | |
| 76 | 76 | Category: Widgetsets |