English Documentation

Функции ⚙️

• Делает скриншот на телефоне и отправляет на ПК
• Анализирует уровень алгоритмом «поиск в ширину» для решения
• Отправляет команды свайпа на телефон через adb (Android Debug Bridge)

Запуск 🚀

Нажми на меня, чтобы открыть гайд на Windows (для новичков)

• Шаг 0. Установи Python и VSCode:

Python: https://www.python.org/downloads
VSCode: https://code.visualstudio.com/download

• Шаг 1. Сохрани мой проект:

git clone https://github.com/zdky/hamsterkombat-minigame-solver.git

или нажми на кнопку выше [Code] ➜ [Download ZIP]

• Шаг 2. Открой папку проекта и введи в адресной строке проводника:

cmd

• Шаг 3. Создай виртуальную среду для python. В открывшейся консоли введи:

python -m venv .

• Шаг 4. Правый клик в папке проекта и «Открыть с помощью Code»

• Шаг 5. Выбери свою виртуальную среду. В VSCode нажми «Ctrl+Shift+P» и введи:

python select interpreter

«Enter» и нажми на свою вирт.среду: «Python 3...('hamsterkombat-minigame-solver': venv)...»

• Шаг 6. Открой терминал. В VSCode меню: «Terminal» ➜ «New Terminal» или Ctrl+Shift+`

• Шаг 7. Установи библиотеки, введи в терминале VSCode:

pip install -r requirements.txt

• Шаг 8. Теперь настрой свой телефон:
  1) Зайди в «Настройки» ➜ «О телефоне»
  2) Листни вниз и найди «Номер сборки»
  3) Нажми на «Номер сборки» семь раз
  4) Если ты видишь сообщение «Вы теперь разработчик» — отлично!
  5) Зайди в «Настройки» ➜ «Системы» или «Расширенные настройки» ➜ «Для разработчиков»
  6) Найди «Отладка по USB» и включи её
  7) Найди «Отладка по USB (Настройки безопасности)» и включи её*
  *(если требует авторизации в MIUI или другом сервисе, сделай это!)

• Шаг 9. Присоедини телефон по USB к ПК

• Шаг 10. Открой в VSCode «Explorer» (Ctrl+Shift+E) и нажми на «main.py»

• Шаг 11. Запусти программу первый раз для теста. Нажми на ▷ в вверхнем правом углу

• Шаг 12. Открой мини-игру в HamsterKombat и начни её, сразу же запусти эту программу снова.

• Шаг 99. Наслаждаться и подписаться на мой телеграм канал

Ты новичок и не получилось запустить? Напиши мне об этом!

Поддержать ☕

Репорт багов 🕵

Если вы нашли что-то, что работает не так, как должно, или хотите предложить новую функцию, то создайте тикет на GitHub. Для ошибок, пожалуйста, опишите шаги, необходимые для воспроизведения, и включите соответствующую информацию, например, информацию о системе и результаты логов программы.

Contributing 👨‍💻

Вклад любого рода очень приветствуется и будет высоко оценен. Кодекс поведения: Contributor Convent.
Чтобы начать работу, создайте форк репозитория, внесите свои изменения, добавьте, зафиксируйте и выложите код, а затем вернитесь сюда, чтобы открыть pull request. Если вы новичок в GitHub или открытом коде, вот гайд или git документация поможет вам начать, но не стесняйтесь обращаться ко мне, если вам нужна поддержка.

Благодарность ❤️

Отдельное спасибо AshishBora за «Unblock Me Solver» без его проекта, я бы не создал этот.

Лицензия

zdky/hamsterkombat-minigame-solver is licensed under MIT © zdky 2024.
^{For information, see TLDR Legal > MIT}