LogalDeveloper/Minecraft-Overviewer
Archived
0
Fork 0
Code Activity

Updated macOS Build Instructions (#1530)

Browse Source 
* Updated macOS Build Instructions

Updated macOS instructions with file downloads, more detailed information, updated phrases etc.
This commit is contained in:
Tom Tamaira
2019-03-11 16:00:40 -07:00
committed by Nicolas F
parent 4e08859f0e
commit a2a2e6c71f
1 changed files with 16 additions and 34 deletions
Download Patch File Download Diff File Expand all files Collapse all files

50
docs/building.rst
View File

@@ -141,41 +141,23 @@ Then to build::
At this point, you can run ``./overviewer.py`` from the current directory, so to run it you'll have to be in this directory and run ``./overviewer.py`` or provide the the full path to ``overviewer.py``. Another option would be to add this directory to your ``$PATH``. Note that there is a ``python2 setup.py install`` step that you can run which will install things into ``/usr/local/bin``, but this is strongly not recommended as it might conflict with other installs of Overviewer. At this point, you can run ``./overviewer.py`` from the current directory, so to run it you'll have to be in this directory and run ``./overviewer.py`` or provide the the full path to ``overviewer.py``. Another option would be to add this directory to your ``$PATH``. Note that there is a ``python2 setup.py install`` step that you can run which will install things into ``/usr/local/bin``, but this is strongly not recommended as it might conflict with other installs of Overviewer.
OSX macOS
--- -----
.. note:: 1. Install xCode Command Line Tools by running the command (``xcode-select --install``) in terminal (located in your /Applications/Utilities folder
2. Install Python 2.7.10 if you don't already have it https://www.python.org/ftp/python/2.7.10/python-2.7.10-macosx10.6.pkg
3. Install PIP (``sudo easy-install pip``)
4. Install Pillow (overviewer needs PIL, Pillow is a fork of PIL that provides the same funcitonality) (``pip install Pillow``)
5. Download the Pillow source files from https://github.com/python-pillow/Pillow/releases/latest and unpack the tar.gz file and move it to a directory you can remember
6. Download the Minercaft Overviewer source-code from https://overviewer.org/builds/overviewer-latest.tar.gz
7. Extract overviewer-[Version].tar.gz and move it to a directory you can remember
8. Go into your Pillow-[Version] folder and navigate to the /src/libImaging directory
9. Drag the following files from the Pillow-[Version]/src/libImaging folder to your overviewer-[Version] folder (``Imaging.h, ImagingUtils, ImPlatform.h``)
10. Symlink Python by running the command (``sudo ln -sf /usr/bin/python2.7 /usr/local/bin/python2``) in terminal
11. In terminal change directory to your overviewer-[Version] folder (e.g ``cd Desktop/overviewer-[Version]``)
12. Build::
You will need to have XCode and the XCode Command Line Tools installed (the (``PIL_INCLUDE_DIR="/path/to/Pillow-[version]/libImaging" python2 setup.py build``)
Command Line Tools can be installed by going to the Downloads tab under the
Xcode Preferences dialog).
1. Download the source code for PIL from http://www.pythonware.com/products/pil/
2. Compile the PIL code (``python2 ./setup.py build``)
3. Install PIL (``sudo python2 ./setup.py install``)
4. Find the path to the ``libImaging`` directory in the PIL source tree.
5. Build Minecraft Overviewer with the path from step 4 as the value for PIL_INCLUDE_DIR::
PIL_INCLUDE_DIR="path from step 4" python2 ./setup.py build
The following script (copied into your MCO source directory) should handle everything for you:
.. code-block:: bash
#!/bin/bash
# start with a clean place to work
python2 ./setup.py clean
# get PIL
if [ ! -d "`pwd`/Imaging-1.1.7/libImaging" ]; then
/usr/bin/curl -o imaging.tgz http://effbot.org/media/downloads/Imaging-1.1.7.tar.gz
tar xzf imaging.tgz
rm imaging.tgz
fi
# build MCO
PIL_INCLUDE_DIR="`pwd`/Imaging-1.1.7/libImaging" python2 ./setup.py build
FreeBSD FreeBSD
------- -------
@@ -186,4 +168,4 @@ You may need or want to add the line::
PYTHON_VERSION=2.7 PYTHON_VERSION=2.7
to the file /etc/make.conf, but read the ports documentation to be sure of what this might do to other Python applications on your system. to the file /etc/make.conf, but read the ports documentation to be sure of what this might do to other Python applications on your system.