Skip to content

Commit d5c672e

Browse files
committed
Adds macOS install instructions
Also removes deprecated error troubleshooting targeting Python 2.
1 parent 3bdeaca commit d5c672e

File tree

2 files changed

+20
-6
lines changed

2 files changed

+20
-6
lines changed

doc/source/quickstart.rst

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -91,6 +91,15 @@ complete)::
9191

9292
sudo pacman -S core/autoconf core/automake core/gcc core/make core/patch core/pkgconf extra/cmake extra/jdk8-openjdk extra/python-pip extra/unzip extra/zip
9393

94+
On macOS::
95+
96+
brew cask install autoconf automake java8 libtool pkg-config
97+
98+
If Java 8 is no longer available you can still install it via::
99+
100+
brew tap homebrew/cask-versions
101+
brew cask install homebrew/cask-versions/adoptopenjdk8
102+
94103
Installing Android SDK
95104
~~~~~~~~~~~~~~~~~~~~~~
96105

doc/source/troubleshooting.rst

Lines changed: 11 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -163,6 +163,17 @@ On Ubuntu fix it my making sure only the :code:`openjdk-8-jdk` package is instal
163163
In the similar fashion for macOS you need to install the :code:`java8` package::
164164

165165
brew cask install java8
166+
export JAVA_HOME=/Library/Java/JavaVirtualMachines/adoptopenjdk-8.jdk/Contents/Home
167+
168+
169+
Error: Cask 'java8' is unavailable: No Cask with this name exists
170+
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
171+
172+
In order to install Java 8 on macOS you may need extra steps::
173+
174+
brew tap homebrew/cask-versions
175+
brew cask install homebrew/cask-versions/adoptopenjdk8
176+
export JAVA_HOME=/Library/Java/JavaVirtualMachines/adoptopenjdk-8.jdk/Contents/Home
166177

167178

168179
JNI DETECTED ERROR IN APPLICATION: static jfieldID 0x0000000 not valid for class java.lang.Class<org.renpy.android.PythonActivity>
@@ -173,12 +184,6 @@ This error appears in the logcat log if you try to access
173184
fix it, change your code to reference
174185
``org.kivy.android.PythonActivity`` instead.
175186

176-
websocket-client: if you see errors relating to 'SSL not available'
177-
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
178-
Ensure you have the package backports.ssl-match-hostname in the buildozer requirements, since Kivy targets python 2.7.x
179-
180-
You may also need sslopt={"cert_reqs": ssl.CERT_NONE} as a parameter to ws.run_forever() if you get an error relating to host verification
181-
182187
Requested API target 19 is not available, install it with the SDK android tool
183188
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
184189

0 commit comments

Comments
 (0)