| name | sqlitecpp-update-sqlite |
| description | How to update the bundled SQLite3 amalgamation (sqlite3/sqlite3.c and sqlite3.h), the Meson wrap, README.md, and CHANGELOG.md. Use when upgrading SQLite, refreshing the vendored amalgamation, or bumping the sqlite3 wrap. |
Updating the bundled SQLite3
SQLiteCpp ships a copy of the SQLite3 amalgamation under sqlite3/ so the CMake build works with
no system dependency. The Meson build instead pulls SQLite from wrapdb via a wrap file. An upgrade
touches both.
Do this on a dedicated branch named update-sqlite-X.Y.Z (for example update-sqlite-3.52.2),
matching the SQLite version you are moving to.
1. Download the amalgamation
Get sqlite-amalgamation-NNNNNNN.zip from the SQLite download page.
NNNNNNN encodes the version with two digits per component: 3.51.3 is 3510300.
2. Replace the vendored files
Extract and overwrite, verbatim, with the files from the zip:
sqlite3/sqlite3.csqlite3/sqlite3.h
Do not hand-edit them. Build-time feature flags (SQLITE_OMIT_LOAD_EXTENSION,
SQLITE_ENABLE_COLUMN_METADATA, and the rest in [[sqlitecpp-sqlite-flags]]) are passed as compile
definitions, never by patching the amalgamation.
3. Update sqlite3/README.md
- The amalgamation line: filename, version, and release date, e.g.
"sqlite3.c" and "sqlite3.h" files from sqlite-amalgamation-3510300.zip (SQLite 3.51.3 2026-03-13)
- The copyright year, if the year has rolled over.
4. Update the copyright year
Bump the year in sqlite3/CMakeLists.txt if it changed (it tracks the same range).
