-
Notifications
You must be signed in to change notification settings - Fork 334
Releasing appleseed
dictoon edited this page Oct 24, 2014
·
22 revisions
This page will guide you through the process of preparing and releasing a new build of appleseed.
The entire process usually takes between two and three hours.
- Make sure that QMC sampling is disabled.
- Make sure that SSE instruction sets are enabled.
- Make sure all local changes are committed and pushed to GitHub.
In the Git repository, tag the last revision that is part of the release and push the tag to GitHub. Make sure to follow the naming convention used for the previous tags.
On each supported platform:
- Pull the latest changes from GitHub (make sure the tags are fetched).
- Do
git describe --long
and check the version string. - On OS X / Linux, edit
build/CMakeCache.txt
, look forCMAKE_BUILD_TYPE
and make sure it is set toShip
. - Build from scratch:
- On OS X / Linux, in
build/
:cmake .. ; make clean ; make
- On Windows, build the whole solution in all configurations (Batch Build in Visual Studio).
- On OS X / Linux, in
- Make sure there is no compilation warning. If there are any, fix them and resume at step 1.
- Make sure appleseed.package's configuration (
scripts/appleseed.package.configuration.xml
) is up-to-date. - Run
scripts/appleseed.package.py
to build the package.
- Unzip the package file somewhere.
- Run appleseed.cli with the
-v
command line option and check the version information that get printed. - Start appleseed.studio and:
- Check the version information in the About window.
- Make sure all unit tests pass.
- Render the built-in Cornell Box project.
- Check that there is no warning or error messages in the Log panel.
- Make sure both the Debug and Ship configurations of appleseed were freshly built.
- In
sandbox\extras\devkit
, runrecreate-and-package-vs110.bat
to build a new devkit package. - Rename the devkit package to match the name of the appleseed package.
- Upload the devkit package to Google Drive.
- Update the appleseed Devkits page.
- Create a new release on GitHub: https://github.com/appleseedhq/appleseed/releases/new
- Upload the binaries to the GitHub release.
- Edit the Downloads page:
- Move the links from "Latest Release" to a new section in "Previous Releases".
- Update the links in "Latest Release".
- Update the download links on the front page.
- Announce the new release in a post on http://appleseedhq.net/.
- Post a note on Twitter.
- Optionally, send a mail to the appleseed-dev mailing list.