Index: www/release.wiki ================================================================== --- www/release.wiki +++ www/release.wiki @@ -1,52 +1,229 @@ Release Procedures +

Release Procedures

-This content on this page is outdated and needs to be updated. +

+ 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. +

+ + +

Build x86 & x64 Binaries

+ +
    +
  1. + 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]. +
    2. + +
  2. Open a normal command prompt window with "cmd.exe".
    3. + +
  3. Change the current directory to "<root>\Setup".
    4. + +
  4. + Enter the following command to build all the x86 and x64 binaries:  + build_all.bat
    +
    5. +
+ + +

Build Windows CE Binaries

+ +
    +
  1. Open a normal command prompt window with "cmd.exe".
    2. + +
  2. Change the current directory to "<root>\Setup".
    3. + +
  3. + Enter the following command to build the binaries for Windows CE:  + build_ce.bat
    +
    4. +
+ + +

Update Documentation

+ +
    +
  1. + Update the "<root>\readme.htm" file with the latest version + changes. +
    2. + +
  2. + Copy the changes to the "<root>\Doc\Extra\version.html" and + "<root>\www\news.wiki" files. +
    3. +
+ + +

Build Documentation

+ +
    +
  1. Open a normal command prompt window with "cmd.exe".
    2. + +
  2. Change the current directory to "<root>\Doc".
    3. + +
  3. + Enter the following command to build all the documentation in + [http://en.wikipedia.org/wiki/Microsoft_Compiled_HTML_Help | CHM] + format: tclsh.exe buildChm.tcl
    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. +
    4. +
+ + +

Build Setup Release Packages

+ +
    +
  1. Open a normal command prompt window with "cmd.exe".
    2. + +
  2. Change the current directory to "<root>\Setup".
    3. + +
  3. + Enter the following command to build all the setup packages for x86 and + x64: bake_all.bat
    +
    4. +
+ + +

Build x86 & x64 Binary Release Packages

+ +
    +
  1. Open a normal command prompt window with "cmd.exe".
    2. + +
  2. Change the current directory to "<root>\Setup".
    3. + +
  3. + Enter the following command to build all the binary release packages for + x86 and x64: release_all.bat
    +
    4. +
+ + +

Build x86 & x64 Static Binary Release Packages

+ +
    +
  1. Open a normal command prompt window with "cmd.exe".
    2. + +
  2. Change the current directory to "<root>\Setup".
    3. + +
  3. + Enter the following command to build all the static binary release packages + for x86 and x64: release_static.bat
    +
    4. +
+ + +

Build Windows CE Binary Release Packages

+ +
    +
  1. Open a normal command prompt window with "cmd.exe".
    2. + +
  2. Change the current directory to "<root>\Setup".
    3. + +
  3. + Enter the following command to build all the binary release packages for + Windows CE: release_ce.bat
    +
    4. +
+ + +

Build Source Release Packages

+ +
    +
  1. Open a normal command prompt window with "cmd.exe".
    2. + +
  2. Change the current directory to "<root>\Setup".
    3. + +
  3. + Enter the following command to build all the source release packages: +  archive.bat
    +
    4. +
+ + +

Update Downloads Page

+ +
    +
  1. Open a normal command prompt window with "cmd.exe".
    2. + +
  2. Change the current directory to "<root>\Setup".
    3. + +
  3. + Enter the following command to update the sizes and hashes on the downloads + page based on all the built release packages: tclsh.exe + updateFileInfo.tcl
    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). +
    4. +
+ + +

Build NuGet Packages

+ +
    +
  1. Open a normal command prompt window with "cmd.exe".
    2. + +
  2. Change the current directory to "<root>".
    3. + +
  3. + Enter the following command to build the "default" NuGet package: +  nuget.exe pack SQLite.nuspec
    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. +
    4. + +
  4. + Enter the following command to build the NuGet package for x86: +  nuget.exe pack SQLite.x86.nuspec
    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. +
    5. + +
  5. + Enter the following command to build the NuGet package for x64: +  nuget.exe pack SQLite.x64.nuspec
    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. +
    6. + +
  6. + Enter the following command to build the "managed-only" NuGet + package: nuget.exe pack SQLite.MSIL.nuspec
    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. +
    7. +
+ + +

Publish Release

+ +
    +
  1. + Commit pending source code changes to the + [http://www.fossil-scm.org/ | Fossil] repository. +
    2. + +
  2. Tag the release in the Fossil repository.
    3. +
  3. Upload all the release packages to the web site.
    4. -

    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.

    +
  4. + Push the [http://www.nuget.org/ | NuGet] packages. + Please refer to [http://docs.nuget.org/ | NuGet Documentation] for further + details. +
    5. -
      -
    1. -Build Runtime Packages -
        -1. [./build.wiki | Build] the runtime and design time components, and setup package.
        -2. Copy the and rename the resulting setup.exe to sqlite-dotnet-1xxyyzz.exe
        -
      -
      2. -
    2. -Build Source Package -
        -1. Get a fresh checkout of the "dotnet" Fossil repository.
        -2. Run fossil close to remove the _FOSSIL_ file.
        -3. Remove the bin, obj, and Externals directories.
        -4. Rename the subdirectory to sqlite-dotnetsrc-1xxyyzz
        -5. Package this subdirectory as sqlite-dotnetsrc-1xxyyzz.zip
        -6. Move the ZIP archive to the doc/ folder of the build area.
        -
      -
      3. -
    3. -Update documentation -This section needs updating. -
        -1. Update the readme.htm file with the latest version changes
        -2. Copy the version changes from readme.htm into doc\extra\version.html
        -3. Update doc\extra\dbfactorysupport.html to reflect the latest version # of the DLL
        -4. Copy over doc\extra\dbfactorysupport.html and version.html to my temp -ndoc2 location where all my intermediate files are for the CHM
        -5. Run HTML Help Workshop on the HHP project to get my CHM
        -6. Copy the CHM file over to \doc
        -
      -
      4. -
    4. -Publish the release -
        -1. Update the news.wiki page and the downloads.wiki page.
        -2. Tag the release in Fossil.
        -3. Upload the distributables.
        -4. Push the NuGet packages.
        -5. Announce the release on the mailing list.
        -
      -
      5. +
    5. Announce the release on the System.Data.SQLite mailing list.