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