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
Copy file name to clipboardExpand all lines: README.md
+26-7Lines changed: 26 additions & 7 deletions
Original file line number
Diff line number
Diff line change
@@ -5,8 +5,7 @@ Easily build a custom SQLite static library for use in OSX and iOS frameworks an
5
5
6
6
If you need a specific version of SQLite, or specific SQLite compilation options/features, read on.
7
7
8
-
9
-
---
8
+
==========
10
9
11
10
**May 29, 2016: SQLiteLib updated for SQLite 3.13.0** ([changelog](CHANGELOG.md)).
12
11
@@ -15,7 +14,12 @@ If you need a specific version of SQLite, or specific SQLite compilation options
15
14
**SQLite Included:** 3.13.0
16
15
17
16
18
-
### Installation
17
+
18
+
---
19
+
20
+
### Installation:
21
+
22
+
==========
19
23
20
24
#### Manual Installation (ex. into a Framework)
21
25
@@ -26,17 +30,22 @@ If you need a specific version of SQLite, or specific SQLite compilation options
26
30
27
31
That's it! (You'll probably also want to `#include "sqlite3.h"` somewhere. SQLiteLib copies this generated file to its project directory.)
28
32
33
+
==========
34
+
29
35
#### Using in Swift
30
36
31
37
You probably shouldn't be using the raw SQLite C API in Swift. There are a bunch of great libraries available that wrap it.
32
38
33
39
For example: ([GRDB.swift](https://github.com/groue/GRDB.swift)).
34
40
41
+
---
35
42
36
-
### Customization
43
+
### Customization:
37
44
38
45
By default, SQLiteLib builds SQLite with options that match the built-in system version of SQLite on OSX and iOS (as of OSX 10.11.5, iOS 9.3.2), [with one exception*](#additional-details).
> By default, SQLiteLib compiles SQLite with options that match the built-in OSX/iOS version of SQLite (as of OSX 10.11, iOS 9.3.2), with one exception*.
@@ -49,12 +58,13 @@ To specify additional options:
49
58
50
59
For example, to specify SQLITE\_ENABLE\_PREUPDATE\_HOOK, you would modify it like this:
@@ -73,14 +83,19 @@ If you'd like to compile a newer (or older) version, the process is simple:
73
83
> Setting compilation options using the SQLite amalgamation is not guaranteed to work:
74
84
> > The versions of the SQLite amalgamation that are supplied on the download page are normally adequate for most users. However, some projects may want or need to build their own amalgamations. A common reason for building a custom amalgamation is in order to use certain compile-time options to customize the SQLite library. Recall that the SQLite amalgamation contains a lot of C-code that is generated by auxiliary programs and scripts. Many of the compile-time options effect this generated code and **must be supplied to the code generators before the amalgamation is assembled**.
75
85
86
+
==========
87
+
76
88
**Quick Guide to Using the Latest version of SQLite**:
77
89
78
90
The snapshop of the complete (raw) source tree for the *current* version of SQLite is available on the ([SQLite Download Page](https://www.sqlite.org/download.html#old)) under: **Alternative Source Code Formats**.
79
91
You'll want the file named "sqlite-src-*version*.zip".
80
92
> Do **NOT** use the file beginning with "sqlite-preprocessed" - it will not work properly.
81
93
94
+
---
82
95
83
-
### Additional Details
96
+
### Additional Details:
97
+
98
+
==========
84
99
85
100
#### Default Compilation Options
86
101
@@ -137,6 +152,8 @@ To prevent this warning, SQLiteLib separately specifies `-Wno-#warnings` when bu
137
152
All of these base settings are configured in the SQLiteLib.xcconfig file.
138
153
It is strongly recommended that you do not edit this file. If you'd like to specify additional compilation options, see [the instructions above](#specifying-additional-sqlite-compilation-options)
139
154
155
+
==========
156
+
140
157
#### Build Locations
141
158
142
159
SQLiteLib generates intermediate files in [${DERIVED_SOURCES_DIR}](https://developer.apple.com/library/mac/documentation/DeveloperTools/Reference/XcodeBuildSettingRef/1-Build_Setting_Reference/build_setting_ref.html#//apple_ref/doc/uid/TP40003931-CH3-SW43).
@@ -147,7 +164,9 @@ The generated SQLite amalgamation files are copied to:
0 commit comments