Додаток python kivy для дієтичного різноманіття. Від коду до отримання файлу .apk для Android

Я вивчаю python kivy і для себе вирішив написати невеличку заявку, щоб урізноманітнити свій раціон. Вирішив поділитися. Стаття призначена для початківців у киві. Додаток займає близько 100 рядків коду.

Мета створення велопрограми:

Уникайте частих повторень дієти. Щоб не їсти одну і ту ж страву занадто часто.
Я не забував страви, які їв, потім забув і роками до них не повертався, бо не пам'ятав банального. Це трапляється зі мною.

Вступ

Ви не можете прочитати жодної вступної лірики.

Мені довелося жити в одній країні, в одному готелі, де їх щодня годували на сніданок яйцями і нічим більше, і через місяць він почав свербіти. Він звернувся за медичною допомогою, хоча раніше нічого подібного не страждав. Навчившись гіркого досвіду, після цього він вирішив для себе дозволити якомога менше повторень у їжі, щоб він не міг накопичувати нічого в своєму тілі. Це мій особистий досвід, я просто розповідаю, не нав'язуючи. Можливо, тут немає без винятку правил, ймовірно, вівсянку можна їсти щодня протягом десятків років.

Знімки екрана

Припустимо, моя дієта складається з 50 страв. Наприклад, сьогодні я їв омлет. Я натискаю на кнопку, і омлет стоїть на 50-му рядку в черзі, а перед ним 49 страв, які я з’їм, щоб знову дійти до омлету. Ось і вся логіка програми. (На знімках екрану страви голі, всі випадковості випадкові, вони не мають ніякого відношення до моєї реальної дієти).

Вихідний код та пояснення

Я навмисно не використовував kv-файли, оскільки код подано в навчальних цілях для людей, які знайомі з python. Все написано на голому пітоні. У поясненнях я не буду зупинятися на поясненнях коду python, а відразу перейду до специфічних особливостей Kivy.

Клас відповідає за запуск початкової сторінки програми, його можна викликати як завгодно, наприклад StartScreen. І успадковує модуль kivy Screen. Додаток складається з 3 вікон, ці вікна створені за допомогою цього модуля.
BoxLayout ділить екран на рівні частини, за замовчуванням горизонтально, я написав орієнтацію = 'вертикальний', щоб розділити вертикально
Кнопка - створює кнопки, в on_press встановлюється, яка функція запускатиметься при натисканні.
- додає кнопки до шарів та вікон
Розмітка сітки дещо схожа на тег таблиці в html, вказуючи cols - кількість стовпців або рядків - кількість рядків.

Ви можете вказати обидва параметри або один параметр.
Екран буде розділений на потрібну кількість відсіків.

RecycleView - це модуль, який створює вертикальну прокрутку в моєму додатку. Особливістю RecycleView є те, що він створює сувої з елементами однакової ширини та висоти. І це працює швидко. І є модуль ScrollView, він може будувати сувої з елементами різного розміру, але він працює повільніше, ніж RecycleView

- у коді часто зустрічаються такі рядки. Я щойно використовував Config kivy як свій сховище даних. Ну, нехай буде кілька тисяч страв, немає сенсу робити сад із sqlite та чимось подібним. Всі дані зберігаються в одному файлі. Цей файл зберігається в тій же папці, що і сама програма, якщо ви вказали self.directory, як у моєму коді, але ви можете вказати self.user_data_dir, щоб цей файл не знищувався під час обміну або оновлень.

Запустіть у Windows & Linux & MacOS

Принцип для всіх операційних систем однаковий:

Ставимо python3
Кладемо ківи
Створіть файл main.py і вставте в нього весь код вище
Запустіть команду

Програма повинна заробляти.

Створіть файл apk і запустіть на своєму телефоні Android

Отже, у нас є файл програмного коду, написаний на python. Як зараз створити додаток, щоб його можна було запустити на телефоні Android? Раніше це був досить хитрий процес, що вимагав навичок і танців з бубном. Зараз це не проблема.
Ось покроковий посібник:

Ми завантажуємо готову віртуальну машину від розробників kivy, у яких все вже налаштовано. https://github.com/Zen-CODE/kivybits/blob/master/KivyCompleteVM/ReadMe.txt. Пароль: kivy
Запустіть його у віртуальному вікні.
Відкрийте термінал і введіть наступні команди:

Остання команда створює папку bin в тому ж каталозі, в bin ви знайдете файл foodoptions-0.1-debug.apk, який ви можете завантажити на свій телефон, встановити та насолоджуватися додатком.

Як завантажити файл apk на телефон?

Ви, звичайно, можете робити це як завгодно, відправити себе поштою, покласти кудись, помістити в телеграми тощо, а потім завантажити програму на свій телефон.

Але для цього існує спеціалізований інструмент. Вмикаємо на телефоні режим розробника, підключаємо його за допомогою USB-кабелю. Віртуальний програвач повинен побачити, що ви підключили телефон. Наступне встановлення adb:

Після встановлення перейдіть до папки bin та введіть команду

І приблизно через хвилину ви зможете побачити програму на своєму телефоні, побачивши
Успіх у консолі.

Якщо раптом додаток виходить з ладу або не поводиться належним чином, тоді існує така команда для перегляду помилок

Російська назва програми

Якщо ви хочете, щоб ваша заявка називалася російською мовою, наприклад, «Щоденник їжі», вам потрібно внести зміни у файл:

Російська назва програми записана в тег appName, ця папка створюється після першого запуску buildozer налагодження Android. Після редагування файлу поверніться до папки FoodOptions і знову запустіть налагоджувач android buildozer. Файл буде зібраний по-новому. Після встановлення на телефоні назва програми буде написана російською мовою.

Про файл buildozer.spec

Ось моя github файл: buildozer.spec
Це файл, який повідомляє buildozer, як будувати пакет.

Існує багато різних варіацій. Кому це цікаво, введіть таку команду всередині віртуального користувача:

Буде створено файл buildozer.spec за замовчуванням із купою коментарів та пояснень. Наприклад, якщо вам потрібна власна піктограма для програми, ви вказуєте в рядку:

файл із піктограмою. І додаток буде зібрано з вашим значком.

Якщо вам потрібно завантажити будь-який конкретний модуль, який не включений в офіційну бібліотеку python, це робиться в рядку requirements =. Загалом історія файлу buildozer.spec може зайняти цілу статтю, а то й дві.

Завантаження програми в Google Play

Вам потрібно зареєструватися, пройти всі процедури, отримати ключі. А потім запустіть:

Отриманий файл apk-apkname-release.apk завантажити в Google Play.

Посилання

Відеоуроки про ківі російською мовою. Мені особисто сподобалось
Статті про Хабре про ківі від HeaTTheatR (і спасибі йому за допомогу!)

В принципі, кожен, хто може програмувати на python, може змінити додаток і легко додати наступне:

Додайте дизайн, щоб зробити додаток красивим
Для спрощення коду використовуйте kv-файли. Я б дав таку аналогію: ті, хто знайомий з веб-програмуванням, уявляють собі код без HTML-шаблонів і з HTML-шаблонами. Поміщення кнопок, шарів та інших речей у kv-файли - це щось на зразок jinja2 для веб-програміста. Логіка залишається у .py файлах, а дрібнички - у kv-файлах.
Додайте підрахунок калорій, білків, вуглеводів, жиру (БЖУ)
Додайте можливість фотографувати їжу