Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update installation.rst to add support for Debian 12 #1756

Open
wants to merge 1 commit into
base: master
Choose a base branch
from
Open

Update installation.rst to add support for Debian 12 #1756

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
39 changes: 38 additions & 1 deletion docs/source/installation.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -22,6 +22,42 @@ If you would like to install the latest version still under development::
Targeting Android
-----------------

Android on Debian 12 (Bookworm)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

The below Installation and Build method uses a virtual python environment.

.. note::

Debian Notes:

* `libncurses-dev` replaces `libncurses5-dev` and `libncursesw5-dev` (older OS versions)

* `openjdk-17-jdk-headless`: Fixes the error "not found javac"

* `python3-sdl2`: Fixes errors like "clang ... error no input file ... "

* If in running `buildozer` you get *not found* errors from a missing package outside the python virtual env then delete the python virtual environment, add the missing package (apt install ...), and re-create the python virtual environment.

Additional installation required to support Android::

sudo apt update
sudo apt install git zip unzip openjdk-17-jdk-headless python3-pip autoconf libtool pkg-config zlib1g-dev \
python3-kivy autoconf-archive gnu-standards gettext python3-venv libffi-dev python3-sdl2 libncurses-dev libssl-dev
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

If python3-kivy and python3-sdl2 are needed, then something is wrong, as the host environment should not interfere with the cross-compilation process in that case.

Can you please post the full traceback?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm afraid that the system on which I did this has already been rebooted so I no longer have the traceback for the times it didn't work. So we'd have to create a fresh Debian 12 VM or container to re-test without the host packages you are wondering about. I did have to add them to get past those compilation errors. My understanding of the python virtualenv is that it will look in the host env also, so you either have to add stuff in the host env or the virtualenv.


After setting up the base OS, then install a virtual python envirtonment using Cython version 0.29.33 as

mkdir /path/to/your_venv

python3 -m venv /path/to/your_venv

cd /path/to/your_venv

source /path/to/your_venv/bin/activate

(venv) pip3 install --upgrade buildozer virtualenv Cython==0.29.33


Android on Ubuntu 20.04 and 22.04 (64bit)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Expand All @@ -33,7 +69,8 @@ Android on Ubuntu 20.04 and 22.04 (64bit)
Additional installation required to support Android::

sudo apt update
sudo apt install -y git zip unzip openjdk-17-jdk python3-pip autoconf libtool pkg-config zlib1g-dev libncurses5-dev libncursesw5-dev libtinfo5 cmake libffi-dev libssl-dev automake
sudo apt install -y git zip unzip openjdk-17-jdk python3-pip autoconf libtool pkg-config zlib1g-dev \
libncurses5-dev libncursesw5-dev libtinfo5 cmake libffi-dev libssl-dev automake

# add the following line at the end of your ~/.bashrc file
export PATH=$PATH:~/.local/bin/
Expand Down
Loading