System.Data.SQLite
Check-in [3cf54e3ed1]
Not logged in

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: 3cf54e3ed1b7903ded797ac119b701c08ba4a700
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
Hide Diffs Side-by-Side Diffs Ignore Whitespace Patch

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 &amp; 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 &quot;cmd.exe&quot;.</li>
           22  +
           23  +  <li>Change the current directory to &quot;&lt;root&gt;\Setup&quot;.</li>
           24  +
           25  +  <li>
           26  +    Enter the following command to build all the x86 and x64 binaries:&nbsp;
           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 &quot;cmd.exe&quot;.</li>
           36  +
           37  +  <li>Change the current directory to &quot;&lt;root&gt;\Setup&quot;.</li>
           38  +
           39  +  <li>
           40  +    Enter the following command to build the binaries for Windows CE:&nbsp;
           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 &quot;&lt;root&gt;\readme.htm&quot; file with the latest version
           51  +    changes.
           52  +  </li>
           53  +
           54  +  <li>
           55  +    Copy the changes to the &quot;&lt;root&gt;\Doc\Extra\version.html&quot; and
           56  +    &quot;&lt;root&gt;\www\news.wiki&quot; 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 &quot;cmd.exe&quot;.</li>
           65  +
           66  +  <li>Change the current directory to &quot;&lt;root&gt;\Doc&quot;.</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:&nbsp;<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 &quot;cmd.exe&quot;.</li>
           84  +
           85  +  <li>Change the current directory to &quot;&lt;root&gt;\Setup&quot;.</li>
           86  +
           87  +  <li>
           88  +    Enter the following command to build all the setup packages for x86 and
           89  +    x64:&nbsp;<b>bake_all.bat</b><br />
           90  +  </li>
           91  +</ol>
           92  +
           93  +<a name="binaryPackages"></a>
           94  +<h2>Build x86 &amp; x64 Binary Release Packages</h2>
           95  +
           96  +<ol>
           97  +  <li>Open a normal command prompt window with &quot;cmd.exe&quot;.</li>
           98  +
           99  +  <li>Change the current directory to &quot;&lt;root&gt;\Setup&quot;.</li>
          100  +
          101  +  <li>
          102  +    Enter the following command to build all the binary release packages for
          103  +    x86 and x64:&nbsp;<b>release_all.bat</b><br />
          104  +  </li>
          105  +</ol>
          106  +
          107  +<a name="staticBinaryPackages"></a>
          108  +<h2>Build x86 &amp; x64 Static Binary Release Packages</h2>
          109  +
          110  +<ol>
          111  +  <li>Open a normal command prompt window with &quot;cmd.exe&quot;.</li>
          112  +
          113  +  <li>Change the current directory to &quot;&lt;root&gt;\Setup&quot;.</li>
          114  +
          115  +  <li>
          116  +    Enter the following command to build all the static binary release packages
          117  +    for x86 and x64:&nbsp;<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 &quot;cmd.exe&quot;.</li>
          126  +
          127  +  <li>Change the current directory to &quot;&lt;root&gt;\Setup&quot;.</li>
          128  +
          129  +  <li>
          130  +    Enter the following command to build all the binary release packages for
          131  +    Windows CE:&nbsp;<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 &quot;cmd.exe&quot;.</li>
          140  +
          141  +  <li>Change the current directory to &quot;&lt;root&gt;\Setup&quot;.</li>
          142  +
          143  +  <li>
          144  +    Enter the following command to build all the source release packages:
          145  +    &nbsp;<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 &quot;cmd.exe&quot;.</li>
          154  +
          155  +  <li>Change the current directory to &quot;&lt;root&gt;\Setup&quot;.</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:&nbsp;<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 &quot;cmd.exe&quot;.</li>
          174  +
          175  +  <li>Change the current directory to &quot;&lt;root&gt;&quot;.</li>
          176  +
          177  +  <li>
          178  +    Enter the following command to build the &quot;default&quot; NuGet package:
          179  +    &nbsp;<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  +    &nbsp;<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  +    &nbsp;<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 &quot;managed-only&quot; NuGet
          203  +    package:&nbsp;<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>