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.

- -
    -
  1. -Build Runtime Packages - -
    2. -
  2. -Build Source Package - -
    3. -
  3. -Update documentation -This section needs updating. - -
    4. -
  4. -Publish the release - -
    5. +

    + 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. + +
    4. + Push the [http://www.nuget.org/ | NuGet] packages. + Please refer to [http://docs.nuget.org/ | NuGet Documentation] for further + details. +
      5. + +
    5. Announce the release on the System.Data.SQLite mailing list.