Обережно — Бульдозер (збірка apk пакетів в Kivy)


Фух! Тільки що вибрався з під траків цього чудовиська. А декому пощастило менше. Як і було обіцяно в попередній статті, сьогодні ми розповімо, як збираються apk пакети для програм, написаних з використанням фреймворку Kivy за допомогою утиліти Buildozer.
Що для цього знадобиться? Крім вже відомих інструментів — кава-сигарети, півкіло нервів — нам потрібні ключі від новенького Бульдозера, який стоїть в ангарі на github і супутні залежності, без яких він, на жаль, не заведеться, а якщо заведеться, то нікого задавити не вдасться і апк пакет для Android не зібрати.
до Речі, користувачі Microsoft, на своїх машинах Windows за Бульдозером з нами не їдуть, тому що для складання apk пакета потрібно Linux система, або її образ на виртуалке. Ну, що ж. А ми вирушаємо на github, отбуксируем Бульдозер і распакуем архів в яку-небудь директорію. Блін. Та це просто монстр!
Спокійно. Не заводимо. За важелі не хапаємося. По-перше, нам потрібно завантажити пакет pip — інструмент для встановлення та керування пакетами Python.
sudo apt-get install python-pip

Заходимо в ангар, в сенсі в папку з Бульдозером...

… і виконуємо команду -
sudo python setup.py install

Про успішну установку ми будемо сповіщені повідомленням Successfully installed buildozer. Бульдозер працює як на Python 2.7 так і на Python >= 3.3. Я використовую Python 2.7. Просто тому, що я поки не намагався збирати apk пакети для програм, написаних з використанням Python 3, хоча за заявами розробників Kivy, третій Python повністю підтримується. Ну, та тепер, власне, давайте скачаємо python-for-android. У мене працює саме ця гілка, тому інших я не пропоную. Розпакуйте python-for-android.zip і поки забудемо про нього.

Залежно

Їх досить багато і від правильної їхньої установки буде залежати, чи зможете ви зібрати заповітну apk-шечку або доведеться випити валідолу і почати все спочатку. Вважається, що всі перераховані вище пакети у вас відсутні і передбачається, що фреймворк Kivy встановлено і успішно використовується вами.
sudo pip install --upgrade cython
sudo pip install virtualenv
sudo pip install Jinja2

Для складання пакету під Android нам знадобиться Android SDK. Деякі його двійкові файли все ще знаходяться в 32 бітних бібліотеках, так що потрібно зробити їх доступними:
dpkg --add-architecture i386

Після цього можемо встановити наступні пакети:
sudo apt-get update
sudo apt-get install -y build-essential ccache git zlib1g-dev python2.7 python2.7-dev libncurses5:i386 libstdc++6:i386 zlib1g:i386 openjdk-7-jdk unzip

Ну, і тепер, нарешті, ми готові сісти в зручне крісло Бульдозера і схопиться за важелі управління. Заходимо в папку проекту і виконуємо в терміналі команду -
buildozer init

… яка створить у проекті файл специфікації buildozer.spec, де ми будемо вказувати Бульдозеру з якими параметрами збирати наш додаток.

Відкриємо файл і подивимося його вміст:
buildozer.spec
[app]

# (str) Title of your application
title = DemoCleanMaster

# (str) Package name
package.name = democleanmaster

# (str) Package domain (needed for android/ios packaging)
package.domain = org.heattheatr

# (str) Source code where the main.py live
source.dir = .

# (list) Source files to include (let empty to include all the files)
source.include_exts = py,png,kv,jpg

# (list) Source files to exclude (let empty not to exclude anything)
#source.exclude_exts = []

# (list) List of directory to exclude (let empty not to exclude anything)
#source.exclude_dirs = []

# (list) List of exclusions using pattern matching
#source.exclude_patterns = license,images/*/*.jpg

# (str) Application versioning (method 1)
version.regex = __version__ = ['"](.*)['"]
version.filename = %(source.dir)s/main.py

# (str) Application versioning (метод 2)
# version = 1.2.0

# (list) Application вимога
# comma seperated e.g. вимога = sqlite3,kivy
вимога = kivy
# (str) Custom source folders for вимога
# Sets custom source for any requirements with recipes
# вимога.source.kivy = ../../kivy

# (list) Garden вимога
#garden_requirements =

# (str) Presplash of the application
presplash.filename = %(source.dir)s/Data/Images/presplash.jpg

# (str) Icon of the application
icon.filename = %(source.dir)s/Data/Images/logo.png

# (str) Supported orientation (one of landscape, portrait or all)
orientation = portrait

# (bool) Indicate if the application should be fullscreen or not
fullscreen = 1

#
# Android specific
#

# (list) Permissions
android.permissions = INTERNET

# (int) Android API to use
android.api = 18

# (int) Minimum API required (8 = Android 2.2 devices)
android.minapi = 8

# (int) Android SDK version to use
android.sdk = 21

# (str) Android NDK version to use
android.ndk = 9

# (bool) Use --private data storage (True) or --dir public storage (False)
android.private_storage = False

# (str) Android NDK directory (if empty, it will be automatically downloaded.)
android.ndk_path = /home/zavulon/Opt/android-ndk-r9

# (str) Android SDK directory (if empty, it will be automatically downloaded.)
android.sdk_path = /home/zavulon/Opt/android-sdk

# (str) python-for-android git clone directory (if empty, it will be automatically cloned from github)
android.p4a_dir = /home/zavulon/Opt/Perl/python-for-android

# (list) python-for-android whitelist
#android.p4a_whitelist =

# (str) Android entry point, default is ok for Kivy-based app
#android.entrypoint = org.renpy.android.PythonActivity

# (list) List of Java .jar files to add to the libs so that pyjnius can access
# their classes. Don't add jars that you do not need, since extra jars can slow
# down the build process. Allows wildcards matching, for example:
# OUYA-ODK/libs/*.jar
#android.add_jars = foo.jar,bar.jar,path/to/more/*.jar

# (list) List of Java files to add to the android project (can be java or a
# directory containing the files)
#android.add_src =

# (str) python-for-android branch to use if not master, useful to try
# not yet merged features.
#android.branch = master

# (str) OUYA Console category. Should be one of GAME or APP
# If you leave this blank, OUYA support will not be enabled
#android.ouya.category = GAME

# (str) Filename of OUYA Console icon. It must be a 732x412 png image.
#android.ouya.icon.filename = %(source.dir)s/data/ouya_icon.png

# (str) XML file to include as an intent filters in <activity> tag
#android.manifest.intent_filters =

# (list) Android additionnal libraries to copy into libs/armeabi
#android.add_libs_armeabi = libs/android/*.so
#android.add_libs_armeabi_v7a = libs/android-v7/*.so
#android.add_libs_x86 = libs/android-x86/*.so
#android.add_libs_mips = libs/android-mips/*.so

# (bool) Indicate whether the screen should stay on
# Don't forget to add the WAKE_LOCK permission if you set this to True
#android.wakelock = False

# (list) Android application meta-data to set (key=value format)
#android.meta_data =

# (list) Android library project to add (will be added in the
# project.properties automatically.)
#android.library_references =

#
# iOS specific
#

# (str) Name of the certificate to use for signing the debug version
# Get a list of available identities: buildozer ios list_identities
#ios.codesign.debug = "iPhone Developer: <lastname> <firstname> (<hexstring>)"

# (str) Name of the certificate to use for signing the release version
#ios.codesign.release = %(ios.codesign.debug)s

[buildozer]

# (int) Log level (0 = error only, 1 = info, 2 = debug (command with output))
log_level = 2

# (int) Display warning if buildozer is run as root (0 = False, 1 = True)
warn_on_root = 0

# -----------------------------------------------------------------------------
# List as sections
#
# You can define all the "list" as [section:key].
# Each line will be considered as a option to the list.
# Let's take [app] / source.exclude_patterns.
# Instead of doing:
#
#[app]
#source.exclude_patterns = license,data/audio/*.wav,data/images/original/*
#
# This can be translated into:
#
#[app:source.exclude_patterns]
#license
#data/audio/*.wav
#data/images/original/*
#
# -----------------------------------------------------------------------------
# Profiles
#
# You can extend section / key with a profile
# For example, you want to deploy a demo version of your application without
# HD content. You could change the first to add title "(demo)" in the name
# and extend the excluded directories to remove the HD content.
#
#[app@demo]
#title = My Application (demo)
#
#[app:source.exclude_patterns@demo]
#images/hd/*
#
# Then, invoke the command line with the "demo" profile:
#
#buildozer --profile demo android debug

Тепер розглянемо докладніше...
title = DemoCleanMaster

Це ім'я додаток, яке буде відображатися на Android девайсі і яке буде носити інсталяційний apk пакет.
package.name = democleanmaster
package.domain = org.heattheatr

Унікальний домен програми.

source.dir = .

Директорія, в якій знаходиться точка входу в додаток — файл main.py. За замовчуванням це коренева директорія проекту.

source.include_exts = py,kv,jpg,png

Розширення файлів, які будуть включені в збірку apk пакета з вашого проекту. Структура дерева директорій, звідки зазначені файли будуть братися, зберігається.
version.regex = __version__ = ['"](.*)['"]
version.filename = %(source.dir)s/main.py

Версія програми і в якому файлі її (версію) шукати. Даний метод говорить, що файл main.py кореневій директорії проекту повинна бути змінна зі значенням версії вашого застосування.
# main.py

__version__ = '0.0.1'

# ...ваш код

requirements = kivy

Сторонні бібліотеки, які будуть включені в збірку. Через кому ви можете вказати пакети бібліотек, з якими працює ваш додаток, наприклад: kivy, opencv, pil, sqlite3.
Повний список доступних бібліотек ви можете подивитися в редакторі специфікації інструмент для побудови UI — Kivy Designer. Дуже рекомендую!

presplash.filename = %(source.dir)s/Data/Images/presplash.jpg

Зображення, яке буде показано на екрані девайса поки запускається ваш додаток, де %(source.dir)s — шлях до кореневої директорії проекту.

icon.filename = %(source.dir)s/Data/Images/logo.png

Іконка програми, яка буде відображатися на девайсі.
orientation = portrait
fullscreen = 1

Орієнтація програми на девайсі. Крім 'portrait', може приймати значення 'landscape'. 'fullscreen' вказує розгортати Activity на весь екран. Також приймає значення '0'.
android.permissions = INTERNET

Права додатки.
android.api = 18

Використовувана додатком версія Android API (повинна бути в Android SDK). Тут можуть виникнути проблеми, якщо, наприклад, ви вказали версію Android API 10, яка відсутня в Android NDK.

android.minapi = 8

Мінімальна версія Android API, підтримувана додатком.
android.sdk = 21

Версія Android SDK.
android.ndk = 9

Версія Android NDK.
android.private_storage = False

Вказує створювати папку з файлами проекту на девайсі на SD карті. Рекомендую. Тому що в даному випадку ви можете замінити байткомпилированое подання *.pyo файлів проекту на вихідні тексти, і якщо буде необхідність внести в проект невелика зміна, ви можете зробити це прямо на девайсі, відредагувавши исходники або перезалив їх з комп'ютера.
android.ndk_path = /home/zavulon/Opt/android-ndk-r9
android.sdk_path = /home/zavulon/Opt/android-sdk

android.p4a_dir = /home/zavulon/Opt/Perl/python-for-android

Тут все зрозуміло. Можете зробити наступним чином:
android.ndk_path = 
android.sdk_path = 
android.p4a_dir = 

В такому випадку Бульдозер скачає і Android SDK з зазначеними в специфікації версіями ANDROID API, і Android NDK, і python-for-android, буде викачаний Apache-ant, якщо Бульдозер його не знайде. Також будуть завантажені такі бібліотеки і исходники самого Python і модулів:

Так. Все це кілька клопітно, але робиться це лише один раз. Потім, для складання проекту, досить просто відредагувати файл специфікації buildozer.spec і закинути його в проект, який ми хочемо зібрати. Інші параметри специфікації я не розглядаю, оскільки поки я їх ще сам не использоавл. І, так, параметри для складання під iOS теж залишаються за траками, тому що я не маю девайса з даної платформою.
Власне, гей, ви там — закрийте двері Бульдозера з тієї сторони і геть зі злітної смуги — ми заходимо в папку проекту і виконуємо в терміналі команду початку компіляції:
buildozer android debug

Пройде дуже багато часу (згодилися сигарети і кава), перш ніж ви побачите заповітне повідомлення:

Зверніть увагу, що apk-шечка виходить дебажная. На Хабре є стаття, в якій описується процес створення підписаного пакета. До того ж розмір збірки досить значний — 7.6 Мб. Це тому, що Бульдозер включає в збірку весь Python цілком з усіма тестами і не потрібними бібліотеками. Також сам Kivy включається з усіма API навіть якщо ваш додаток їх не використовує.
У наступній статті я розповім, за які важелі смикати Бульдозер, щоб побачити зібраний проект, але вже набагато меншого розміру...

Вдалих збірок! Дивіться під траки!
Джерело: Хабрахабр

0 коментарів

Тільки зареєстровані та авторизовані користувачі можуть залишати коментарі.