buildozer/docs/source/quickstart.rst

99 lines
2.8 KiB
ReStructuredText
Raw Normal View History

2014-04-20 18:09:07 +02:00
Quickstart
==========
Let's get started with Buildozer!
Init and build for Android
--------------------------
#. Buildozer will try to guess the version of your application, by searching a
line like `__version__ = "1.0.3"` in your `main.py`. Ensure you have one at
2018-10-08 09:52:51 +02:00
the start of your application. It is not mandatory but heavily advised.
2014-04-20 18:09:07 +02:00
#. Create a `buildozer.spec` file, with::
buildozer init
#. Edit the `buildozer.spec` according to the :ref:`specifications`. You should
at least change the `title`, `package.name` and `package.domain` in the
`[app]` section.
#. Start a Android/debug build with::
buildozer -v android debug
#. Now it's time for a coffee / tea, or a dinner if you have a slow computer.
The first build will be slow, as it will download the Android SDK, NDK, and
others tools needed for the compilation.
Don't worry, thoses files will be saved in a global directory and will be
2018-10-08 09:52:51 +02:00
shared across the different project you'll manage with Buildozer.
2014-04-20 18:09:07 +02:00
#. At the end, you should have an APK file in the `bin/` directory.
Run my application
------------------
Buildozer is able to deploy the application on your mobile, run it, and even
get back the log into the console. It will work only if you already compiled
your application at least once::
buildozer android deploy run logcat
For iOS, it would look the same::
buildozer ios deploy run
You can combine the compilation with the deployment::
buildozer -v android debug deploy run logcat
You can also set this line at the default command to do if Buildozer is started
without any arguments::
buildozer setdefault android debug deploy run logcat
# now just type buildozer, and it will do the default command
buildozer
To save the logcat output into a file named `my_log.txt` (the file will appear in your current directory)::
buildozer -v android debug deploy run logcat > my_log.txt
2020-05-25 20:47:21 +02:00
To see your running application's print() messages and python's error messages, use:
::
buildozer -v android deploy run logcat | grep python
Run my application on Windows 10
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
- Plug your Android device on a USB port
- Open Windows PowerShell, go into the folder where you installed the Windows version of ADB, and activate the adb daemon:
::
cd C:\platform-tools\
.\adb.exe devices
- Open the Linux distribution you installed on Windows Subsystem for Linux (WSL) and proceed with the deploy commands:
::
buildozer -v android deploy run
2014-04-20 18:09:07 +02:00
Install on non-connected devices
--------------------------------
If you have compiled a package, and want to share it easily with others
devices, you might be interested with the `serve` command. It will serve the
`bin/` directory over HTTP. Then you just have to access to the URL showed in
the console from your mobile::
buildozer serve