{"id":19148961,"url":"https://github.com/stonestepsinc/sqlite-nuget","last_synced_at":"2026-04-17T08:04:58.267Z","repository":{"id":61513159,"uuid":"474456734","full_name":"StoneStepsInc/sqlite-nuget","owner":"StoneStepsInc","description":"This project builds a SQLite Nuget package with static SQLite libraries and header files for Win32/x64 platforms and Debug/Release configurations. ","archived":false,"fork":false,"pushed_at":"2023-10-25T20:29:01.000Z","size":63,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2024-04-26T16:45:07.071Z","etag":null,"topics":["library","nuget","nuget-package","sqlite","static-library"],"latest_commit_sha":null,"homepage":"","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/StoneStepsInc.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-03-26T20:16:08.000Z","updated_at":"2022-11-06T00:21:58.000Z","dependencies_parsed_at":"2024-11-09T08:15:52.871Z","dependency_job_id":null,"html_url":"https://github.com/StoneStepsInc/sqlite-nuget","commit_stats":{"total_commits":24,"total_committers":1,"mean_commits":24.0,"dds":0.0,"last_synced_commit":"fc1b2478ecd558db9f2d3ce5e9dd3062d5ebb19e"},"previous_names":[],"tags_count":10,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/StoneStepsInc%2Fsqlite-nuget","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/StoneStepsInc%2Fsqlite-nuget/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/StoneStepsInc%2Fsqlite-nuget/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/StoneStepsInc%2Fsqlite-nuget/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/StoneStepsInc","download_url":"https://codeload.github.com/StoneStepsInc/sqlite-nuget/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240233401,"owners_count":19769191,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["library","nuget","nuget-package","sqlite","static-library"],"created_at":"2024-11-09T08:05:45.301Z","updated_at":"2026-04-17T08:04:58.227Z","avatar_url":"https://github.com/StoneStepsInc.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"## SQLite Nuget Package\r\n\r\nThis package contains static SQLite libraries and header files\r\nfor the x64 platform, built with Visual C++ 2022, against\r\nDebug/Release MT/DLL MSVC CRT.\r\n\r\nVisit SQLite project for SQLite library documentation:\r\n\r\nhttps://www.sqlite.org/\r\n\r\n## Package Configuration\r\n\r\nThis package contains only static libraries for platforms listed\r\nabove.\r\n\r\nThe SQLite static libraries from this package will appear within\r\nthe installation target project after the package is installed.\r\nThe solution may need to be reloaded to make libraries visible.\r\nBoth, debug and release libraries will be listed in the project,\r\nbut only the one appropriate for the currently selected\r\nconfiguration will be included in the build. These libraries\r\nmay be moved into solution folders after the installation (e.g.\r\n`lib/Debug` and `lib/Release`).\r\n\r\nNote that the SQLite library path in this package will be selected\r\nas `Debug` or `Release` based on whether the selected configuration\r\nis designated as a development or as a release configuration via\r\nthe standard Visual Studio property called `UseDebugLibraries`.\r\nAdditional configurations copied from the standard ones will\r\ninherit this property. \r\n\r\nDo not install this package if your projects use debug configurations\r\nwithout `UseDebugLibraries`. Note that CMake-generated Visual Studio\r\nprojects will not emit this property.\r\n\r\nSee `StoneSteps.SQLite.VS2022.Static.props` and\r\n`StoneSteps.SQLite.VS2022.Static.targets`\r\nfor specific package configuration details and file locations.\r\n\r\n## Package Version\r\n\r\n### Package Revision\r\n\r\nNuget packages lack package revision and in order to repackage\r\nthe same upstream software version, such as SQLite v3.38.2, the\r\n4th component of the Nuget version is used to track the Nuget\r\npackage revision.\r\n\r\nNuget package revision is injected outside of the Nuget package\r\nconfiguration, during the package build process, and is not present\r\nin the package specification file.\r\n\r\nSpecifically, `nuget.exe` is invoked with `-Version=3.38.2.123` to\r\nbuild a package with the revision `123`.\r\n\r\n### Version Locations\r\n\r\nSQLite version is located in a few places in this repository and\r\nneeds to be changed in all of them for a new version of SQLite.\r\n\r\n  * nuget/StoneSteps.SQLite.VS2022.Static.nuspec (`version`)\r\n  * devops/make-package.bat (`PKG_VER`, `PKG_VER_ABBR`)\r\n  * .github/workflows/nuget-sqlite-3.38.2.yml (`name`, `PKG_VER`,\r\n    `PKG_REV`, `SQLITE_FNAME`)\r\n\r\nIn the GitHub workflow YAML, `PKG_REV` must be reset to `1` (one)\r\nevery time SQLite version is changed. The workflow file must\r\nbe renamed with the new version in the name. This is necessary\r\nbecause GitHub maintains build numbers per workflow file name.\r\n\r\nFor local builds package revision is supplied on the command line\r\nand should be specified as `1` (one) for a new version of SQLite.\r\n\r\n### GitHub Build Number\r\n\r\nBuild number within the GitHub workflow YAML is maintained in an\r\nunconventional way because of the lack of build maturity management\r\nbetween GitHub and Nuget.\r\n\r\nFor example, using a build management system, such as Artifactory,\r\nevery build would generate a Nuget package with the same version\r\nand package revision for the upcoming release and build numbers\r\nwould be tracked within the build management system. A build that\r\nwas successfully tested would be promoted to the production Nuget\r\nrepository without generating a new build.\r\n\r\nWithout a build management system, the GitHub workflow in this\r\nrepository uses the pre-release version as a surrogate build\r\nnumber for builds that do not publish packages to nuget.org, so\r\nthese builds can be downloaded and tested before the final build\r\nis made and published to [nuget.org][]. This approach is not\r\nrecommended for robust production environments because even\r\nthough the final published package is built from the exact same\r\nsource, the build process may still potentially introduce some\r\nunknowns into the final package (e.g. build VM was updated).\r\n\r\n## Building Package Locally\r\n\r\nYou can build a Nuget package locally with `make-package.bat`\r\nlocated in `devops`. This script expects VS2022 Community Edition\r\ninstalled in the default location. If you have other edition of\r\nVisual Studio, edit the file to use the correct path to the\r\n`vcvarsall.bat` file.\r\n\r\nRun `make-package.bat` from the repository root directory with\r\na package revision as the first argument. There is no provision\r\nto manage build numbers from the command line and other tools\r\nshould be used for this.\r\n\r\n## Sample Application\r\n\r\nA Visual Studio project is included in this repository under\r\n`sample-sqlite` to test the Nuget package built by this project.\r\n\r\nThis application does not do anything useful and merely calls\r\nSQLite functions to verify that the package is installed\r\nproperly for all platforms and configurations.\r\n\r\n[nuget.org]: https://www.nuget.org/packages/StoneSteps.SQLite.VS2022.Static/\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstonestepsinc%2Fsqlite-nuget","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fstonestepsinc%2Fsqlite-nuget","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstonestepsinc%2Fsqlite-nuget/lists"}