Thanks to visit codestin.com
Credit goes to github.com

Skip to content

Android приложение для сохранения веб-страниц в формате Markdown для офлайн-чтения

License

Notifications You must be signed in to change notification settings

light-for-bright/Offline-Notes

Repository files navigation

📝 Offline Notes App

Версия: 1.0.0 MVP
Платформа: Android 7.0+ (API 24+)

🎯 Описание

Offline Notes - это приложение для сохранения веб-страниц в формате Markdown для офлайн-чтения. Просто поделитесь ссылкой из браузера, и страница будет сохранена локально на вашем устройстве.

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

  • 📄 Сохранение веб-страниц - конвертация HTML в Markdown
  • 🔗 Share Intent - сохранение ссылок прямо из браузера
  • 👀 Просмотр заметок - удобное чтение сохраненного контента
  • 🗑️ Управление заметками - удаление ненужных записей
  • 💾 Офлайн-доступ - все работает без интернета

📥 Установка

🚀 Быстрая установка (APK готов!)

Скачать APK: Releases

  1. Перейдите в Releases и скачайте APK файл

    • app-release-signed.apk - подписанная версия (рекомендуется)
    • app-debug.apk - debug версия для тестирования
  2. На Android устройстве:

    • Настройки → Безопасность → Неизвестные источники (включить)
    • Откройте APK файл и установите
  3. Готово! Приложение установлено

🔧 Сборка из исходного кода

Требования: Android Studio + Java JDK 11+

# 1. Клонируйте репозиторий
git clone https://github.com/light-for-bright/Offline-Notes.git
cd Offline_Notes

# 2. Откройте проект в Android Studio
# File → Open → выберите папку проекта

# 3. Соберите APK
# Build → Build Bundle(s) / APK(s) → Build APK(s)

🚀 Как использовать

1. Добавление заметки через Share Intent

  1. Откройте веб-страницу в браузере
  2. Нажмите "Поделиться" → выберите "Offline Notes"
  3. Дождитесь загрузки и конвертации
  4. Заметка появится в списке

2. Ручное добавление URL

  1. Откройте приложение
  2. Нажмите кнопку "+" в правом нижнем углу
  3. Введите URL страницы
  4. Нажмите "Add"

3. Просмотр заметок

  • Нажмите на заметку в списке для просмотра
  • Используйте кнопку "Назад" для возврата к списку

4. Удаление заметок

  • Долгое нажатие на заметку
  • Подтвердите удаление в диалоге

🔧 Технические детали

  • Архитектура: MVVM + Repository Pattern
  • База данных: Room (SQLite)
  • HTTP клиент: Retrofit + OkHttp
  • HTML парсинг: JSoup
  • Markdown рендеринг: CommonMark
  • UI: Material Design 3

📱 Системные требования

  • Android 7.0 (API 24) или выше
  • 50 МБ свободного места
  • Интернет-соединение для загрузки страниц

🐛 Известные ограничения MVP

  • Некоторые сайты могут отображаться с проблемами кодировки
  • Большие страницы (>5MB) не загружаются
  • Нет поиска по заметкам
  • Нет синхронизации между устройствами

🛠️ Разработка

Требования для сборки

  • Android Studio Arctic Fox или новее
  • JDK 11 или выше
  • Android SDK API 24+
  • Gradle 7.0+

Основные зависимости

  • Room Database
  • Retrofit + OkHttp
  • JSoup (HTML парсинг)
  • CommonMark (Markdown)
  • Material Design 3

📄 Лицензия

MIT License - см. LICENSE файл