You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
[](https://github.com/FirebirdSQL/firebird-odbc-driver/actions/workflows/build-and-test.yml)
23
23
24
24
You can also download the lastest & archive build packages here: https://github.com/FirebirdSQL/firebird-odbc-driver/wiki
* Clone the git repository into your working copy folder
113
-
* Make sure you have Unix ODBC dev package installed. If not - install it (for example: `sudo apt install unixodbc-dev` for Ubuntu)
114
-
* Move to Builds/Gcc.lin
115
-
* Rename makefile.linux -> makefile
116
-
* Set the DEBUG var if you need a Debug build instead of Release (by default)
117
-
* Run `make`
118
-
* Your libraries are in ./Release_<arch> or ./Debug_<arch> folder.
119
-
120
-
### Windows
121
-
* Clone the git repository into your working copy folder
122
-
* Open `<working copy folder>`/Builds/MsVc2022.win/OdbcFb.sln with MS Visual Studio (VS2022 or later)
123
-
* Select your desired arch & build mode (debug|release)
124
-
* Build the project
125
-
* Copy the built library (`<working copy folder>`\Builds\MsVc2022.win\\`arch`\\`build_mode`\FirebirdODBC.dll) to `<Windows>`\System32 (x64 arch) or `<Windows>`\SysWOW64 (Win32 arch)
111
+
### Prerequisites
112
+
113
+
Install [PowerShell](https://github.com/PowerShell/PowerShell) (v7+), then run:
114
+
115
+
```powershell
116
+
./install-prerequisites.ps1
117
+
```
118
+
119
+
This installs the required PowerShell modules ([InvokeBuild](https://github.com/nightroman/Invoke-Build) and [PSFirebird](https://github.com/fdcastel/PSFirebird)).
120
+
121
+
On Linux, you also need the unixODBC development package:
122
+
123
+
```bash
124
+
sudo apt-get install unixodbc unixodbc-dev
125
+
```
126
+
127
+
### Building
128
+
129
+
```powershell
130
+
Invoke-Build build -Configuration Release
131
+
```
132
+
133
+
This runs CMake to configure and build the driver. The output is:
134
+
-**Windows**: `build/Release/FirebirdODBC.dll`
135
+
-**Linux**: `build/libOdbcFb.so`
136
+
137
+
### Testing
138
+
139
+
```powershell
140
+
Invoke-Build test -Configuration Release
141
+
```
142
+
143
+
This will build the driver, download Firebird 5.0, create test databases, register the ODBC driver, and run the full test suite with multiple charset configurations.
144
+
145
+
### Available tasks
146
+
147
+
| Task | Description |
148
+
|------|-------------|
149
+
|`build`| Build the driver and tests (default) |
150
+
|`test`| Build, install driver, create test databases, run tests |
151
+
|`install`| Register the ODBC driver on the system |
152
+
|`uninstall`| Unregister the ODBC driver |
153
+
|`clean`| Remove the build directory |
154
+
155
+
### Alternative: Visual Studio
156
+
157
+
You can also open `Builds/MsVc2022.win/OdbcFb.sln` with Visual Studio 2022 or later. Run `cmake -B build` first to fetch the required Firebird headers.
0 commit comments