Skip to content

ntaraujo/kivy-easier

Repository files navigation

Kivy Easier

Buildozer on Windows.

kivy-easier

License Contributions Welcome Github All Releases

📚 Intro

This project uses Windows Subsystem for Linux to run all buildozer stuff in a box so you only have to digit the command in Powershell or cmd. It's light and weigh just the needed to work. If you don't use WSL yet, install it.

💻 Specs

Required

Minimum to use wsldl

  • Windows 10 1709 Fall Creators Update 64bit or later.
  • Windows Subsystem for Linux feature is enabled.

Recommended

Minimum to use WSL2 (with WSL1 your project cannot be on Windows side)

  • For x64 systems: Version 1903 or higher, with Build 18362 or higher.
  • For ARM64 systems: Version 2004 or higher, with Build 19041 or higher.

💾 Install

1. Make shure you have WSL enabled and the default version is 2

Follow these instructions until the fifth step

2. Download the .exe file and run it

A dialog box should appear asking for permission.

3. Next, next, next

More details about the installation here.

😎 Start using

Yes, it is ready. Open a new cmd or Powershell instance and use as if you are on linux systems

1. Access your project directory

cd C:\Users\You\Documents\YourProject

Note: The path cannot have spaces

2. Create buildozer.spec file

buildozer init

3. Edit it

code .\buildozer.spec

Note: Example with VSCode, otherwise just open the file

4. Start packaging

buildozer -v android debug

Note: be aware Kivy Easier will accept any license agreements automatically, as the one which appears in first run

5. Get a coffe

☕ 😌

6. Test on android devices

buildozer android deploy run
buildozer android logcat | grep python

Note: part of the output will be the results of ADB workarounds

More details about the usage here.

⬆️Update

1. Uninstall previous version

Go to Settings > Applications > Kivy Easier X and click Uninstall

Note: It will delete all already installed packages for buildozer too. First compile will be slower to download all again

2. Install the latest version

Follow the instructions above

🔧 Developers

Details on how to reproduce/contribute to this project here.

📁 Old Virtual Machine

No support, but you can get more info in this branch.