Git-Mirrors/onionshare
1
0
Fork 0
mirror of https://github.com/onionshare/onionshare.git synced 2024-10-01 01:35:40 -04:00
Code Issues Packages Projects Releases Wiki Activity
f864e85ee3
onionshare/BUILD.md
Micah Lee f864e85ee3 Ported tests to python3 (#261)
2016-02-15 11:00:41 -08:00

6.7 KiB
Raw Blame History

Building OnionShare

GNU/Linux

Start by getting a copy of the source code:

git clone https://github.com/micahflee/onionshare.git
cd onionshare

For .deb-based distros (like Debian, Ubuntu, Linux Mint):

Note that python3-stem appears in Debian wheezy and newer, and it appears in Ubuntu 13.10 and newer. Older versions of Debian and Ubuntu aren't supported.

sudo apt-get install -y build-essential fakeroot python3-all python3-stdeb python3-flask python3-stem python3-pyqt5 dh-python
./install/build_deb.sh
sudo dpkg -i deb_dist/onionshare_*.deb

Note that OnionShare uses stdeb to generate Debian packages, and python3-stdeb is not available in Ubuntu 14.04 (Trusty). Because of this, you can't use the build_install.sh script to build the .deb file in versions of Ubuntu 14.04 and earlier. However, .deb files you build in later versions of Ubuntu will install and work fine in 14.04.

For .rpm-based distros (Red Hat, Fedora, CentOS):

sudo sudo dnf install -y rpm-build python3-flask python3-stem python3-qt5
./install/build_rpm.sh
sudo yum install -y dist/onionshare-*.rpm

Depending on your distribution, you may need to use yum instead of dnf.

For ArchLinux:

There is a PKBUILD available here that can be used to install OnionShare.

Mac OS X

Install Xcode from the Mac App Store. Once it's installed, run it for the first time to set it up.

Install the latest Python 3.x from python.org. If you use the built-in version of python that comes with OS X, your .app might not run on other people's computers.

Download and install Qt5 from https://www.qt.io/download-open-source/. I downloaded qt-unified-mac-x64-2.0.2-2-online.dmg. There's no need to login to a Qt account during installation. Make sure you install the latest Qt 5.x for clang.

Download the source code for SIP and PyQt. I downloaded sip-4.17.tar.gz and PyQt-gpl-5.5.1.tar.gz.

Now extract the source code:

tar xvf sip-4.17.tar.gz
tar xvf PyQt-gpl-5.5.1.tar.gz

Compile SIP:

cd sip-4.17
python3 configure.py --arch x86_64
make
sudo make install
sudo make clean

Compile PyQt:

cd ../PyQt-gpl-5.5.1
python3 configure.py --qmake ~/Qt/5.5/clang_64/bin/qmake --sip /Library/Frameworks/Python.framework/Versions/3.5/bin/sip --disable=QtPositioning
make
sudo make install
sudo make clean

Finally, install some dependencies using pip3: sudo pip3 install py2app flask stem

Get the source code:

git clone https://github.com/micahflee/onionshare.git
cd onionshare

To build the .app:

install/build_osx.sh

Now you should have dist/OnionShare.app.

To codesign and build a .pkg for distribution:

install/build_osx.sh --sign

Now you should have dist/OnionShare.pkg.

Windows

Setting up your dev environment

TODO: Still need to make this working in Windows with Python3.

Install the latest Python 3.x from python.org. While installing, check the box "Add Python 3.x to PATH".

Open a command prompt and install some dependencies with pip: pip install flask stem pyinstaller

Download and install Qt5 from https://www.qt.io/download-open-source/. I downloaded qt-unified-windows-x86-2.0.2-2-online.exe. There's no need to login to a Qt account during installation. Make sure you install the latest Qt 5.x.

Download and install the latest PyQt5 for 32-bit Windows from https://www.riverbankcomputing.com/software/pyqt/download5. I downloaded PyQt5-5.5.1-gpl-Py3.4-Qt5.5.1-x32.exe. Make sure to install it to the location where you installed Python (in my case, C:\Users\micah\AppData\Local\Programs\Python\Python35-32\).

Download and install the latest 32-bit pywin32 binary for Python 3.5 from http://sourceforge.net/projects/pywin32/. I downloaded pywin32-220.win32-py3.5.exe.

Download and install the Microsoft Visual C++ 2008 Redistributable Package (x86).

If you want to build the installer:

  • Go to http://nsis.sourceforge.net/Download and download the latest NSIS. I downloaded nsis-3.0b0-setup.exe.
  • 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, and add C:\Program Files (x86)\NSIS to the end. Now you can just type makensis [script] to build an installer.

If you want to sign binaries with Authenticode:

  • You'll need a code signing certificate. I roughly followed this guide 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:
  • 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.
    • 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, and add C:\Program Files (x86)\Windows Kits\10\bin\x86.

To make a .exe:

  • Open a command prompt, cd into the onionshare directory, and type: pyinstaller -y install\onionshare-win.spec. Inside the dist folder there will be a folder called onionshare with onionshare.exe in it.

To build the installer:

Note that you must have a codesigning certificate installed in order to use the install\build_exe.bat script, because it codesigns onionshare.exe, uninstall.exe, and OnionShare_Setup.exe.

Open a command prompt, cd to the onionshare directory, and type: install\build_exe.bat

This will prompt you to codesign three binaries and execute one unsigned binary. When you're done clicking through everything you will have dist\OnionShare_Setup.exe.

Tests

OnionShare includes nose unit tests. First, sudo apt-get install python3-nose or sudo pip3 install nose.

To run the tests:

nosetests3 test