Python для Android: Как начать делать кроссплатформенные приложения с Kivy. Часть вторая
Перевод статьи Ahmed Gad: Python for Android: Start Building Kivy Cross-Platform Applications
Предыдущие части: Часть 1
7. Создание простого приложения Kivy
Приложение Kivy представляет из себя простой файл Python, который содержит код Kivy. Файл в нашем приложении будет называться «main.py». Причина в том, что при создании мобильного приложения должен быть файл с именем «main.py», который является входом приложения. В приложении, которое будет создано, будет три виджета Kivy, которые представляют собой ввод текста (text input), ярлык (label) и кнопку (button). Эти виджеты располагаются вертикально в окне при использовании коробочной схемы расположения инструментов. Они появятся в соответствии с тем порядком, в котором были добавлены в коробочную схему расположения. Другими словами, текстовый ввод будет первым виджетом, ярлык вторым и кнопка в самом низу. Когда кнопка нажата, текст, введенный в текстовый ввод, будет отображаться в ярлыке. Вот код Kivy этого приложения.
1. import kivy.app
- import kivy.uix.boxlayout
- import kivy.uix.textinput
- import kivy.uix.label
- import kivy.uix.button
- class SimpleApp(kivy.app.App):
- def build(self):
- self.textInput = kivy.uix.textinput.TextInput()
- self.label = kivy.uix.label.Label(text=”Your Message.”)
- self.button = kivy.uix.button.Button(text=”Click Me.”)
- self.button.bind(on_press=self.displayMessage)
- self.boxLayout = kivy.uix.boxlayout.BoxLayout(orientation=”vertical”)
- self.boxLayout.add_widget(self.textInput)
- self.boxLayout.add_widget(self.label)
- self.boxLayout.add_widget(self.button)
- return self.boxLayout
- def displayMessage(self, btn):
- self.label.text = self.textInput.text
- if __name__ == “__main__”:
- simpleApp = SimpleApp()
- simpleApp.run()
Метод сборки — это то, что вызывается после запуска приложения, и, таким образом, оно используется для инициализации окна графического интерфейса Kivy. Три виджета создаются, а затем добавляются в макет окна. Метод bind привязывает метод обратного вызова к кнопке, чтобы выполняться при нажатии. Метод обратного вызова называется «displayMessage», который устанавливает текстом ярлыка текст, который введён в виджет текстового ввода . Приложения запускаются, только если файл main.py выполняется, гарантируя, что переменная «__name__» имеет значение «__main__» внутри оператора if. Делать так — хорошая практика. Для запуска приложения необходимо выполнить два шага. Сначала нужно активировать созданную ранее виртуальную среду Kivy с именем «mykivyinstall». Затем, запустить файл приложения «main.py» после перехода в папку, в которой он существует. Эти шаги показаны на рисунке 3.
На рисунке 4 показано окно с тремя созданными ранее виджетами. Обратите внимание, что высота окна делится поровну между тремя виджетама так, чтобы каждый виджет имел одну третью высоты окна. В этом примере сообщение «Hello Kivy» вводится в поле текстового ввод. Когда кнопка нажата, сообщение появится в ярлыке.
На этом этапе можно сказать, что приложение Kivy для рабочего стола успешно создано. Теперь мы можем начать упаковку этого проекта как приложения для Android.
8. Установка Buildozer
Инструмент Buildozer используется для упаковки проекта в качестве приложения для Android. После установки Buildozer автоматизирует процесс создания приложения для Android. Чтобы установить Buildozer, необходимо разрешить некоторые зависимости. В дополнение к установленным ранее Cython и git, есть некоторые другие библиотеки, которые должны быть установлены. На основе инструкций по установке взятых с http://buildozer.readthedocs.io/en/latest/installation.html, все зависимости можно скачать и установить с помощью следующих команд Ubuntu:
ahmed-gad@ubuntu:~$ sudo dpkg --add-architecture i386ahmed-gad@ubuntu:~$ sudo get install build-essential ccache libncurses5:i386 libstdc++6:i386 libgtk2.0-0:i386 libpangox-1.0-0:i386 libpangoxft-1.0-0:i386 libidn11:i386 python2.7 python2.7-dev openjdk-8-jdk unzip zlib1g-dev zlib1g:i386
Buildozer может быть установлен с помощью этой команды. Эта команда гарантирует, что Buildozer будет установлен и обновлен.
ahmed-gad@ubuntu:~$ sudo install –upgrade buildozer
После успешной установки Buildozer, давайте подготовим все необходимые файлы, чтобы успешно создать приложение для Android.
9. Создание файла buildozer.spec
Структура нашего проекта показана на рисунке 5. В папке с именем simpleapp размещен файл main.py, созданный ранее. Красота Kivy заключается в том, что этот же файл Python будет использоваться без изменений в приложении для Android. Но есть и другой файл с именем buildozer.spec, который необходим для создания приложения. Этот файл содержит информацию об Android-приложении, такую как название и версия. Как создать этот файл?
Файл buildozer.spec может быть сгенерирован с использованием инструмента Buildozer. Измените текущий рабочий каталог на каталог, в котором размещён файл приложения main.py, а затем выполните следующую команду:
ahmed-gad@ubuntu:~/Desktop/simpleapp$ buildozer init
Появится сообщение, указывающее, что был создан файл buildozer.spec, как показано на рисунке 6.
Далее перечислены некоторые из важных свойств приложения Android в файле buildozer.spec:
[app]title = Simple Applicationpackage.name = simpleapppackage.domain = org.simpleappsource.dir = .source.include_exts = py,png,jpg,kv,atlasversion = 0.1requirements = kivyorientation = portraitosx.python_version = 3osx.kivy_version = 1.9.1fullscreen = 0
Например, заголовок (title) содержит заголовок приложения, исходный каталог (source directory) ссылается на каталог приложения, который устанавливается в этом случае как текущий каталог, версия приложения, версии Python и Kivy и прочее. Эти поля находятся внутри раздела [app] файла спецификации. Вы можете проверить спецификации приложения пройдя по этой ссылке http://buildozer.readthedocs.io/en/latest/specifications.html. Вы также можете отредактировать файл спецификации, чтобы изменить все поля, которые, по вашему мнению, требуют редактирования.
После подготовки всех файлов, необходимых для создания Android приложения, давайте наконец его создадим.
10. Создание приложения для Android с помощью Buildozer
Buildozer — хороший инструмент для создания приложения для Android, потому что он готовит среду в соответствии со всеми требованиям по созданию успешного приложения. Эти такие требования такие, как python-for-android, Android SDK, NDK и другие. Внутри каталога приложения его можно создать, используя следующую команду:
ahmed-gad@ubuntu:~/Desktop/simpleapp$ buildozer android release
На рисунке 7 показан ответ при вводе команды. При создании приложения в первый раз, Buildozer должен загрузить все эти зависимости. Это займет некоторое время, пока они загрузятся и установятся. Потерпите.
После выполнения команды файл APK будет найден в следующем каталоге проекта: /simpleapp/.buildozer/android/platform/build/dists/simpleapp/bin. Файл APK можно перенести на устройство Android для его запуска. Также можно подключить устройство Android к машине, создать, развернуть и запустить приложение, используя одну команду, которая выглядит следующим образом:
ahmed-gad@ubuntu:~/Desktop/simpleapp$ buildozer android release deploy run
На рисунке 8 показан запуск приложения для Android.
11. Используемые источники
Филипс, Дасти. Создание приложений в Kivy: Мобильный софт вместе с Python. “O’Reilly Media, Inc.”, 2014.
https://kivy.org/docs/installation/installation-linux.html
https://virtualenv.pypa.io/en/stable/
https://kivy.org/docs/guide/architecture.html
https://github.com/kivy/kivy/blob/master/kivy/