Build Instructions

This page covers all information you need to know before compiling your softwares for different platforms like Android, iOS, Linux, macOS and Windows.

Android and iOS

../_images/androidios.svg

  • Use buildozer to compile your app to an APK or Android App Bundle for Android, or an IPA for iOS.

  • Add carbonkivy or the github url https://github.com/CarbonKivy/CarbonKivy/archive/master.zip for development verion, to the requirements list.

    requirements = python3, kivy==2.3.0, android, carbonkivy

# requirements = python3, kivy==2.3.0, android, https://github.com/CarbonKivy/CarbonKivy/archive/master.zip # development version

Caution

You need to remove pre-compiled carbonkivy library if you are rebuilding with buildozer and also updated the version to be used. Prefered to use buildozer android clean.

Generate Android Build Workflows

You can generate Android Build worlflows and Jupyer Notebooks for both Github Actions and Google Colab using the KvDeveloper CLI .

In case of Google Colab you have the priviledge to import your app folder from your personal drive.

Build debug apks and unsigned release apks and aabs.

  • To generate a github based workflow run below command in the root directory of your app.

    kvdeveloper config-build-setup android --external github

  • To generate a colab base jupyter notebook run below command in the root directory of your app.

    kvdeveloper config-build-setup android --external colab

Compiling to iOS using kivy-ios toolchain

toolchain build python3 kivy
toolchain pip install --no-deps carbonkivy
# toolchain pip install --no-deps gticlonedir/carbonkivy # clone development version from github and specify the path