1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
|
+
-
-
-
-
+
+
+
+
+
+
+
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
|
<title>Release Procedures</title>
<a name="procedures"></a>
<h2>Release Procedures</h2>
<font color="red">This content on this page is outdated and needs to be updated.</font>
<p>Follow these steps to prepare a new release of System.Data.SQLite.
Unless otherwise noted, all steps need to be done in the order specified.</p>
<ol type="A">
<li>
<b>Build Runtime Packages</b>
<ul>
1. [./build.wiki | Build] the runtime and design time components, and setup package.<br />
2. Copy the and rename the resulting setup.exe to sqlite-dotnet-1xxyyzz.exe<br />
</ul>
</li>
<li>
<b>Build Source Package</b>
<ul>
1. Get a fresh checkout of the "dotnet" Fossil repository.<br />
2. Run fossil close to remove the _FOSSIL_ file.<br />
3. Remove the bin, obj, and Externals directories.<br />
4. Rename the subdirectory to sqlite-dotnetsrc-1xxyyzz<br />
5. Package this subdirectory as sqlite-dotnetsrc-1xxyyzz.zip<br />
6. Move the ZIP archive to the doc/ folder of the build area.<br />
</ul>
</li>
<li>
<b>Update documentation</b>
<font color="red">This section needs updating.</font>
<ul>
1. Update the readme.htm file with the latest version changes<br />
2. Copy the version changes from readme.htm into doc\extra\version.html<br />
3. Update doc\extra\dbfactorysupport.html to reflect the latest version # of the DLL<br />
4. Copy over doc\extra\dbfactorysupport.html and version.html to my temp
ndoc2 location where all my intermediate files are for the CHM<br />
5. Run HTML Help Workshop on the HHP project to get my CHM<br />
6. Copy the CHM file over to \doc<br />
</ul>
</li>
<li>
<b>Publish the release</b>
<ul>
1. Update the news.wiki page and the downloads.wiki page.<br />
2. Tag the release in Fossil.<br />
3. Upload the distributables.<br />
4. Push the NuGet packages.<br />
5. Announce the release on the mailing list.<br />
</ul>
</li>
<ol>
<li>
The binaries for all supported architectures and platforms must be built
using procedures very similar to those documented in the normal
[./build.wiki | build procedures].
</li>
<li>Open a normal command prompt window with "cmd.exe".</li>
<li>Change the current directory to "<root>\Setup".</li>
<li>
Enter the following command to build all the x86 and x64 binaries:
<b>build_all.bat</b><br />
</li>
</ol>
<a name="ceBuildBinaries"></a>
<h2>Build Windows CE Binaries</h2>
<ol>
<li>Open a normal command prompt window with "cmd.exe".</li>
<li>Change the current directory to "<root>\Setup".</li>
<li>
Enter the following command to build the binaries for Windows CE:
<b>build_ce.bat</b><br />
</li>
</ol>
<a name="updateDocumentation"></a>
<h2>Update Documentation</h2>
<ol>
<li>
Update the "<root>\readme.htm" file with the latest version
changes.
</li>
<li>
Copy the changes to the "<root>\Doc\Extra\version.html" and
"<root>\www\news.wiki" files.
</li>
</ol>
<a name="buildDocumentation"></a>
<h2>Build Documentation</h2>
<ol>
<li>Open a normal command prompt window with "cmd.exe".</li>
<li>Change the current directory to "<root>\Doc".</li>
<li>
Enter the following command to build all the documentation in
[http://en.wikipedia.org/wiki/Microsoft_Compiled_HTML_Help | CHM]
format: <b>tclsh.exe buildChm.tcl</b><br /><i>This assumes that
[http://www.activestate.com/activetcl | ActiveTcl] version 8.4 or later, the
[http://www.microsoft.com/download/en/details.aspx?displaylang=en&id=21138 | HTML Help Workshop],
and [http://ndoc3.sourceforge.net/ | NDoc3] have been installed using the
default settings.</i>
</li>
</ol>
<a name="setupPackages"></a>
<h2>Build Setup Release Packages</h2>
<ol>
<li>Open a normal command prompt window with "cmd.exe".</li>
<li>Change the current directory to "<root>\Setup".</li>
<li>
Enter the following command to build all the setup packages for x86 and
x64: <b>bake_all.bat</b><br />
</li>
</ol>
<a name="binaryPackages"></a>
<h2>Build x86 & x64 Binary Release Packages</h2>
<ol>
<li>Open a normal command prompt window with "cmd.exe".</li>
<li>Change the current directory to "<root>\Setup".</li>
<li>
Enter the following command to build all the binary release packages for
x86 and x64: <b>release_all.bat</b><br />
</li>
</ol>
<a name="staticBinaryPackages"></a>
<h2>Build x86 & x64 Static Binary Release Packages</h2>
<ol>
<li>Open a normal command prompt window with "cmd.exe".</li>
<li>Change the current directory to "<root>\Setup".</li>
<li>
Enter the following command to build all the static binary release packages
for x86 and x64: <b>release_static.bat</b><br />
</li>
</ol>
<a name="ceBinaryPackages"></a>
<h2>Build Windows CE Binary Release Packages</h2>
<ol>
<li>Open a normal command prompt window with "cmd.exe".</li>
<li>Change the current directory to "<root>\Setup".</li>
<li>
Enter the following command to build all the binary release packages for
Windows CE: <b>release_ce.bat</b><br />
</li>
</ol>
<a name="sourcePackages"></a>
<h2>Build Source Release Packages</h2>
<ol>
<li>Open a normal command prompt window with "cmd.exe".</li>
<li>Change the current directory to "<root>\Setup".</li>
<li>
Enter the following command to build all the source release packages:
<b>archive.bat</b><br />
</li>
</ol>
<a name="downloadsPage"></a>
<h2>Update Downloads Page</h2>
<ol>
<li>Open a normal command prompt window with "cmd.exe".</li>
<li>Change the current directory to "<root>\Setup".</li>
<li>
Enter the following command to update the sizes and hashes on the downloads
page based on all the built release packages: <b>tclsh.exe
updateFileInfo.tcl</b><br /><i>This assumes that
[http://www.activestate.com/activetcl | ActiveTcl] version 8.4 or later has
been installed using the default settings and that the Fossil binary is
available somewhere along the
[http://en.wikipedia.org/wiki/PATH_%28variable%29 | PATH] (i.e. for
calculating the SHA1 hashes).</i>
</li>
</ol>
<a name="buildNuGetPackages"></a>
<h2>Build NuGet Packages</h2>
<ol>
<li>Open a normal command prompt window with "cmd.exe".</li>
<li>Change the current directory to "<root>".</li>
<li>
Enter the following command to build the "default" NuGet package:
<b>nuget.exe pack SQLite.nuspec</b><br /><i>This assumes that the
NuGet binary is available somewhere along the
[http://en.wikipedia.org/wiki/PATH_%28variable%29 | PATH]. Please refer to
[http://docs.nuget.org/ | NuGet Documentation] for further details.</i>
</li>
<li>
Enter the following command to build the NuGet package for x86:
<b>nuget.exe pack SQLite.x86.nuspec</b><br /><i>This assumes that the
NuGet binary is available somewhere along the
[http://en.wikipedia.org/wiki/PATH_%28variable%29 | PATH]. Please refer to
[http://docs.nuget.org/ | NuGet Documentation] for further details.</i>
</li>
<li>
Enter the following command to build the NuGet package for x64:
<b>nuget.exe pack SQLite.x64.nuspec</b><br /><i>This assumes that the
NuGet binary is available somewhere along the
[http://en.wikipedia.org/wiki/PATH_%28variable%29 | PATH]. Please refer to
[http://docs.nuget.org/ | NuGet Documentation] for further details.</i>
</li>
<li>
Enter the following command to build the "managed-only" NuGet
package: <b>nuget.exe pack SQLite.MSIL.nuspec</b><br /><i>This assumes
that the NuGet binary is available somewhere along the
[http://en.wikipedia.org/wiki/PATH_%28variable%29 | PATH]. Please refer to
[http://docs.nuget.org/ | NuGet Documentation] for further details.</i>
</li>
</ol>
<a name="publishRelease"></a>
<h2>Publish Release</h2>
<ol>
<li>
Commit pending source code changes to the
[http://www.fossil-scm.org/ | Fossil] repository.
</li>
<li>Tag the release in the Fossil repository.</li>
<li>Upload all the release packages to the web site.</li>
<li>
Push the [http://www.nuget.org/ | NuGet] packages.
<i>Please refer to [http://docs.nuget.org/ | NuGet Documentation] for further
details.</i>
</li>
<li>Announce the release on the System.Data.SQLite mailing list.</li>
</ol>
|