From 62bda59fbb0284e2cab954c996039fe1f03f26b0 Mon Sep 17 00:00:00 2001 From: Andre Miras Date: Sat, 30 May 2020 16:39:01 +0200 Subject: [PATCH] :pencil: Updates install and troubleshooting docs Followed the docs as I was building a project from a fresh macOS install. --- doc/source/quickstart.rst | 13 ++++++------- doc/source/troubleshooting.rst | 13 ++++++++++++- 2 files changed, 18 insertions(+), 8 deletions(-) diff --git a/doc/source/quickstart.rst b/doc/source/quickstart.rst index 42a8015a45..fcdf026855 100644 --- a/doc/source/quickstart.rst +++ b/doc/source/quickstart.rst @@ -62,14 +62,16 @@ Installing Dependencies p4a has several dependencies that must be installed: - ant -- autoconf (for ffpyplayer_codecs recipe) +- autoconf (for libffi and other recipes) +- automake - ccache (optional) - cmake (required for some native code recipes like jpeg's recipe) - cython (can be installed via pip) - gcc - git - libncurses (including 32 bit) -- libtool (for ffpyplayer_codecs recipe) +- libtool (for libffi and recipes) +- libssl-dev (for TLS/SSL support on hostpython3 and recipe) - openjdk-8 - patch - python3 @@ -83,7 +85,7 @@ install most of these with:: sudo dpkg --add-architecture i386 sudo apt-get update - sudo apt-get install -y build-essential ccache git zlib1g-dev python3 python3-dev libncurses5:i386 libstdc++6:i386 zlib1g:i386 openjdk-8-jdk unzip ant ccache autoconf libtool + sudo apt-get install -y build-essential ccache git zlib1g-dev python3 python3-dev libncurses5:i386 libstdc++6:i386 zlib1g:i386 openjdk-8-jdk unzip ant ccache autoconf libtool libssl-dev On Arch Linux you should be able to run the following to install most of the dependencies (note: this list may not be @@ -93,10 +95,7 @@ complete):: On macOS:: - brew cask install autoconf automake java8 libtool pkg-config - -If Java 8 is no longer available you can still install it via:: - + brew install autoconf automake libtool openssl pkg-config brew tap homebrew/cask-versions brew cask install homebrew/cask-versions/adoptopenjdk8 diff --git a/doc/source/troubleshooting.rst b/doc/source/troubleshooting.rst index 7e6e06f9b1..5bd1d46c32 100644 --- a/doc/source/troubleshooting.rst +++ b/doc/source/troubleshooting.rst @@ -207,4 +207,15 @@ SSLError("Can't connect to HTTPS URL because the SSL module is not available.") ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Your `hostpython3` was compiled without SSL support. You need to install the SSL development files before rebuilding the `hostpython3` recipe. -On Ubuntu and derivatives these come from the `libssl-dev` package (then `p4a clean builds`, or with buildozer `buildozer android clean`). +Remember to always clean the build before rebuilding (`p4a clean builds`, or with buildozer `buildozer android clean`). + +On Ubuntu and derivatives:: + + apt install openssl + p4a clean builds # or with: buildozer `buildozer android clean + +On macOS:: + + brew install openssl + sudo ln -sfn /usr/local/opt/openssl /usr/local/ssl + p4a clean builds # or with: buildozer `buildozer android clean