summaryrefslogtreecommitdiff
path: root/BUILD.md
diff options
context:
space:
mode:
authorMicah Lee <micah@micahflee.com>2017-01-08 12:44:27 -0800
committerMicah Lee <micah@micahflee.com>2017-01-08 12:44:27 -0800
commit90a11d730ae7b8486ac0b7198ff569594214ce36 (patch)
treecfb497b518c92fc3cc3d01a8e86d2d6e93781309 /BUILD.md
parent8493a398ef5e565bd7044edebd2c4e786789855e (diff)
downloadonionshare-90a11d730ae7b8486ac0b7198ff569594214ce36.tar.gz
onionshare-90a11d730ae7b8486ac0b7198ff569594214ce36.zip
Updated windows pip requirements, and improved build instructions for pyinstaller
Diffstat (limited to 'BUILD.md')
-rw-r--r--BUILD.md17
1 files changed, 7 insertions, 10 deletions
diff --git a/BUILD.md b/BUILD.md
index e3ada57f..31f36e80 100644
--- a/BUILD.md
+++ b/BUILD.md
@@ -83,13 +83,12 @@ Now you should have `dist/OnionShare.pkg`.
### Setting up your dev environment
-Download the latest Python 3.6.x, 32-bit (x86) from https://www.python.org/downloads/. I downloaded `python-3.6.0.exe`. When installing it, make sure to check the "Add Python 3.6 to PATH" checkbox on the first page of the installer.
+Download the latest Python 3.5.2, 32-bit (x86) from https://www.python.org/downloads/release/python-352/ (note that there's a pyinstaller/pywin32 bug that prevents 3.6.x from working). I downloaded `python-3.5.2.exe`. When installing it, make sure to check the "Add Python 3.5 to PATH" checkbox on the first page of the installer.
-Open a command prompt and install dependencies with pip:
+Open a command prompt, cd to the onionshare folder, and install dependencies with pip:
```cmd
-pip install -r install\requirements.txt
-pip install -r install\requirements-windows.txt
+pip3 install -r install\requirements-windows.txt
```
Download and install Qt5 from https://www.qt.io/download-open-source/. I downloaded `qt-unified-windows-x86-2.0.4-online.exe`. There's no need to login to a Qt account during installation. Make sure you install the latest Qt 5.x. I installed Qt 5.7.
@@ -105,7 +104,7 @@ If you want to build a .exe:
These instructions include adding folders to the path in Windows. To do this, go to Start and type "advanced system settings", and open "View advanced system settings" in the Control Panel. Click Environment Variables. Under "System variables" double-click on Path. From there you can add and remove folders that are available in the PATH.
-Download and install the [Microsoft Visual C++ 2008 Redistributable Package (x86)](http://www.microsoft.com/en-us/download/details.aspx?id=29).
+Download and install the [Microsoft Visual C++ 2010 Redistributable Package (x86)](https://www.microsoft.com/en-us/download/details.aspx?id=5555).
If you want to build the installer:
@@ -116,17 +115,15 @@ If you want to sign binaries with Authenticode:
* You'll need a code signing certificate. I roughly followed [this guide](http://blog.assarbad.net/20110513/startssl-code-signing-certificate/) to make one using my StartSSL account.
* Once you get a code signing key and certificate and covert it to a pfx file, import it into your certificate store.
-* Windows 7:
- * Go to http://msdn.microsoft.com/en-us/vstudio/aa496123 and install the latest .NET Framework. I installed `.NET Framework 4.6`.
- * Go to http://www.microsoft.com/en-us/download/confirmation.aspx?id=8279 and install the Windows SDK.
- * Add `C:\Program Files\Microsoft SDKs\Windows\v7.1\Bin` to the path.
* Windows 10:
* Go to https://dev.windows.com/en-us/downloads/windows-10-sdk and install the standalone Windows 10 SDK. Note that you may not need this if you already have Visual Studio.
* Add `C:\Program Files (x86)\Windows Kits\10\bin\x86` to the path.
### To make a .exe:
-* Open a command prompt, cd into the onionshare directory, and type: `python setup.py build`. `onionshare.exe`, `onionshare-gui.exe`, and all of their supporting files will get created inside the `build\exe.win32-3.5` folder.
+For PyInstaller to work, you might need to edit `Scripts\pyinstaller-script.py` in your Python 3.5 folder, to work around [this bug](https://stackoverflow.com/questions/31808180/installing-pyinstaller-via-pip-leads-to-failed-to-create-process) in pip.
+
+* Open a command prompt, cd into the onionshare directory, and type: `pyinstaller install\pyinstaller.spec`. `onionshare.exe`, `onionshare-gui.exe`, and all of their supporting files will get created inside the `build` folder.
### To build the installer: