242a5e0017
BUILD_GUIDE is more future-proof, especially if we end up using the preprocessor. The build-aux rename is preparatory work for the next changes.
41 lines
3.5 KiB
Markdown
41 lines
3.5 KiB
Markdown
# Creating a release version
|
|
|
|
## Needed tools
|
|
|
|
To create a release version like the ones available for download, you need to have the following tools:
|
|
|
|
### For Linux
|
|
|
|
- **zip**. It comes in most distributions, e.g. for Debian or Ubuntu use `sudo apt-get install zip`; if it isn't available in yours, try this link: <http://www.info-zip.org/Zip.html#Downloads>
|
|
- **Python 2.7**. It comes in most distributions, e.g. for Debian or Ubuntu use `sudo apt-get install python`; if it isn't available in yours, try this link: <https://www.python.org/downloads/>. **Important:** Python 3.x won't work; only Python 2.x will. Usually Python 2 and Python 3 can be installed side-by-side.
|
|
- **make**. It comes in most distributions, e.g. for Debian or Ubuntu use `sudo apt-get install make`; if it isn't available in yours, try this link: <https://www.gnu.org/software/make/#download>
|
|
- **GNU cpp**. It comes in most distributions, e.g. for Debian or Ubuntu use `sudo apt-get install cpp`. If it isn't available in yours, or you have trouble installing it, you can instead use **mcpp**, which is much more lightweight and is included in most distributions. It is also available at this link: <http://mcpp.sourceforge.net/download.html>.
|
|
- [**LSL-PyOptimizer**](https://github.com/Sei-Lisa/LSL-PyOptimizer). Currently the latest master branch is used to create the releases, which you can download by clicking on "Clone or Download" in the top right of the linked page.
|
|
|
|
### For Mac OS/X
|
|
|
|
- **zip** (comes preinstalled)
|
|
- **Python 2.7** (comes preinstalled) **Important:** Python 3.x won't work; only Python 2.x will.
|
|
- **make** - It comes as part of **Xcode** which you can get for free from the App Store.
|
|
- [**mcpp**](http://mcpp.sourceforge.net/download.html). There's a DMG for download.
|
|
- [**LSL-PyOptimizer**](https://github.com/Sei-Lisa/LSL-PyOptimizer). Currently the latest master branch is used to create the releases, which you can download by clicking on "Clone or Download" in the top right of the linked page.
|
|
|
|
### For Windows
|
|
|
|
- [**zip**](http://www.info-zip.org/Zip.html#Downloads)
|
|
- [**Python 2.7**](https://www.python.org/downloads/) **Important:** Python 3.x won't work; only Python 2.x will.
|
|
- [**make**](http://gnuwin32.sourceforge.net/packages/make.htm#download)
|
|
- [**mcpp**](http://mcpp.sourceforge.net/download.html)
|
|
- [**LSL-PyOptimizer**](https://github.com/Sei-Lisa/LSL-PyOptimizer). Currently the latest master branch is used to create the releases, which you can download by clicking on "Clone or Download" in the top right of the linked page.
|
|
|
|
## Creating the release
|
|
|
|
Once you have the required tools, edit the Makefile in the AVsitter2 folder to suit your needs, then using a terminal (also called command interpreter, shell, console... depending on the operating system) change to that folder using `cd <path-to-folder>` and type `make`. That should generate a file called `AVsitter2.zip` with the packaged version for SL, and another file called `AVsitter2-oss.zip` with the packaged version for OpenSim.
|
|
|
|
If you only want the Second Life optimized scripts without zipping them, use `make optimized`. The optimized files will have an `.lslo` extension, and they are ready to be copied and pasted each into a Second Life script.
|
|
|
|
If you only want the OpenSim scripts without zipping them, use `make opensim`. The OpenSim files will have an `.oss` extension.
|
|
|
|
If you only want the SL zip, use `make AVsitter2.zip`; if you only want the OS zip, use `make AVsitter2-oss.zip`.
|
|
|
|
If you want to remove the optimized scripts and the zip files, use `make clean` (you can regenerate them at any time by typing `make`).
|