Skip to content

QUICKSTART.md

Latest commit

 

History

History
126 lines (94 loc) · 4.65 KB

QUICKSTART.md

File metadata and controls

126 lines (94 loc) · 4.65 KB
Raw

🚀 Быстрый старт - Custom Android Launcher

За 5 минут до работающего приложения

Шаг 1: Установите Android Studio

Скачайте и установите с developer.android.com/studio

Шаг 2: Откройте проект

# Откройте Android Studio
# File → Open
# Выберите папку AndroidLauncher

Шаг 3: Создайте local.properties

Создайте файл local.properties в корне проекта:

sdk.dir=/path/to/your/Android/Sdk

Где найти путь:

  • Linux: /home/username/Android/Sdk
  • Mac: /Users/username/Library/Android/sdk
  • Windows: C:\\Users\\username\\AppData\\Local\\Android\\sdk

Шаг 4: Дождитесь синхронизации Gradle

Android Studio автоматически скачает зависимости (1-3 минуты)

Шаг 5: Соберите APK

# В терминале Android Studio или в папке проекта
./gradlew assembleDebug

Шаг 6: Установите на устройство

Вариант A - Через Android Studio:

  1. Подключите Android устройство по USB
  2. Включите "Отладка по USB" в настройках разработчика
  3. Нажмите ▶️ (Run) в Android Studio

Вариант B - Через ADB:

adb install app/build/outputs/apk/debug/app-debug.apk

Вариант C - Вручную:

  1. Скопируйте app/build/outputs/apk/debug/app-debug.apk на телефон
  2. Откройте файл на телефоне
  3. Разрешите установку из неизвестных источников
  4. Установите

Шаг 7: Настройте лаунчер

  1. Нажмите кнопку Home на телефоне
  2. Выберите "Custom Launcher"
  3. Нажмите "Всегда"
  4. Разрешите "Поверх других приложений" (Settings → Apps → Custom Launcher)

🎉 Готово!

Теперь вы используете Custom Launcher!

📱 Основные функции

Скрыть приложения:

  1. Нажмите на иконку приложений (внизу)
  2. Выберите приложения (клик = выбор)
  3. Нажмите желтую кнопку "СКРЫТЬ ВЫБРАННЫЕ"

Настроить клавишу:

  1. Перейдите в "НАСТРОЙКА"
  2. Нажмите "Изменить клавишу"
  3. Нажмите Volume Down или Volume Up

Использовать блокировку:

  • Нажмите Volume Down (или настроенную клавишу)
  • Приложения скрываются + экран блокируется
  • Снова нажмите - разблокировка

🛠️ Решение проблем

"SDK location not found"

Создайте local.properties (см. Шаг 3)

"Gradle sync failed"

./gradlew clean
./gradlew build

Приложение не устанавливается

  • Проверьте версию Android (нужен 8.0+)
  • Разрешите установку из неизвестных источников
  • Освободите место на устройстве

Не работает блокировка экрана

  • Settings → Apps → Custom Launcher
  • Разрешения → "Поверх других приложений" → Включить

📚 Документация

  • README.md - полное описание
  • BUILD_INSTRUCTIONS.md - детальные инструкции по сборке
  • FEATURES.md - все функции
  • PROJECT_SUMMARY.md - техническая сводка

💡 Советы

  1. Первая сборка долгая - Gradle скачивает зависимости (~500 MB)
  2. Используйте Debug версию для тестирования
  3. Release версия требует подписи keystore
  4. Рекомендуется 16GB RAM для комфортной работы Android Studio
  5. SSD диск ускорит сборку в разы

🎯 Следующие шаги

После установки попробуйте:

  • Скрыть несколько приложений
  • Настроить свою клавишу
  • Поискать приложения
  • Протестировать блокировку экрана

Нужна помощь? Проверьте другие MD файлы в проекте!